Vehicle Catalog Brands

Vehicle Catalog Brands

Katalogdaki araçlardan türetilen tekil marka listesini marka adına göre alfabetik sıralı döndürür.

Uç Nokta (Endpoint)

GET {{baseUrl}}/api/VehicleCatalogs/brands

Kullanım

Bu servis, kataloğu marka bazında çekmek ya da marka seçim listesi oluşturmak için kullanılır. Önerilen akış:

1. Authentication Login servisinden token alınır.
2. Bu servis çağrılarak marka listesi alınır.
3. Dönen BrandCode değeri GET /api/VehicleCatalogs?brandCode=<kod> çağrısında filtre olarak kullanılır.

💡 Pasif araçları da çekiyorsanız (includeDeactive=true) marka listesini de aynı parametreyle alın; aksi hâlde yalnızca pasif araçları kalan markalar listede görünmez.

Kimlik Doğrulama

Bu uç nokta geçerli bir JWT erişim token’ı gerektirir. Token, Authentication Login servisinden alınır ve Authorization başlığında gönderilir.

Token’ın Read yetkisini taşıması gerekir.

İstek Parametreleri (Query Parameters)

Örnek İstek:

GET {{baseUrl}}/api/VehicleCatalogs/brands?includeDeactive=false
Authorization: Bearer <token>

Başarılı Yanıt (200 OK)

Marka adına göre alfabetik sıralı düz dizi (array) döner.

Örnek Başarılı Yanıt:

[
  {
    "BrandCode": 576,
    "BrandName": "ADRIA"
  },
  {
    "BrandCode": 3,
    "BrandName": "ALFA ROMEO"
  },
  {
    "BrandCode": 8,
    "BrandName": "ASTON MARTIN"
  },
  {
    "BrandCode": 9,
    "BrandName": "AUDI"
  }
]

Hatalı Yanıt (401 Unauthorized)

Token gönderilmediğinde, geçersiz olduğunda veya süresi dolduğunda HTTP 401 Unauthorized döner. Yanıt gövdesi boştur.

💡 Token’ın süresi dolduysa yanıtta Token-Expired: true başlığı bulunur. Bu durumda POST /api/authentication/refreshtoken ile yeni token alınmalıdır.