Vehicle Catalog

Vehicle Catalog

Araç kataloğunu (TSB araç kasko değer listesi) sayfalı döndürür. Varsayılan olarak yalnızca güncel listede yer alan aktif araçlar döner; version verildiğinde tam liste yerine yalnızca o sürüme ait değişiklikler (delta) döner.

Uç Nokta (Endpoint)

GET {{baseUrl}}/api/VehicleCatalogs

Kullanım

Bu servis, araç kataloğunu kendi tarafında saklayan tüketicilerin ilk tam çekimi ve sonraki delta güncellemeleri için kullanılır.

Tam çekim akışı:

1. Authentication Login servisinden token alınır.
2. GET /api/VehicleCatalogs/meta ile Version okunur; eldeki sürümle aynıysa katalog değişmemiştir, çekime gerek yoktur.
3. Bu servis page=1 ile çağrılır ve page değeri Data boş dönene ya da Page * PageSize >= TotalCount olana kadar artırılır.
4. Yanıttaki Version değeri watermark olarak saklanır.

Delta akışı (version parametresi):

1. GET /api/VehicleCatalogs/versions ile sürüm listesi alınır.
2. Eldeki sürüm listede bulunur; sonrasındaki sürümler sırayla ?version=<hash> ile çekilir.
3. Dönen kayıtlar Id ile upsert edilir.

version verildiğinde sürüm geçmişindeki bir önceki sürümden istenen sürüme kadar olan pencerede son kez değişen kayıtlar döner. Pasifleşen kayıtlar IsActive=false olarak includeDeactive değerinden bağımsız dahil edilir. Bir kayıt sonraki bir sürümde tekrar değiştiyse yalnızca o sonraki sürümün yanıtında görünür; sürümler sırayla çekildiğinde her kayıt en fazla bir kez, güncel hâliyle gelir.

💡 Yeni bir sürüm oluştuğunda aboneliği tanımlı platformlara VehicleCatalogChange push bildirimi gönderilir; bildirimdeki Version değeri doğrudan bu servisin version parametresinde kullanılır.

💡 Sayfalar tekil Id anahtarına göre sıralanır; sayfalar arasında kayıt kayması ya da yinelenmesi olmaz.

⚠️ Eski model yılları için de kasko değeri sunması gereken tüketiciler includeDeactive=true kullanmalıdır; aksi hâlde listeden düşmüş (15 yıldan eski) araçlar dö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?brandCode=9&page=1&pageSize=3
Authorization: Bearer <token>

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

Data nesnesi:

Prices nesnesi:

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

{
  "Version": "52C958DB9124FAD5021C7AFA54F2699E0459A5B0",
  "LatestVersion": "52C958DB9124FAD5021C7AFA54F2699E0459A5B0",
  "Page": 1,
  "PageSize": 3,
  "TotalCount": 774,
  "Data": [
    {
      "Id": "9-1001",
      "BrandCode": 9,
      "BrandName": "AUDI",
      "ModelCode": 1001,
      "ModelName": "S3 S TRONIC",
      "Prices": [
        {
          "Year": 2012,
          "Price": 1530369
        }
      ],
      "IsActive": true,
      "UpdatedAt": "2026-08-10T11:14:17.38+03:00"
    },
    {
      "Id": "9-1002",
      "BrandCode": 9,
      "BrandName": "AUDI",
      "ModelCode": 1002,
      "ModelName": "A6 AVANT 3.0 TFSI QUATTRO S TRONIC",
      "Prices": [
        {
          "Year": 2016,
          "Price": 2526015
        },
        {
          "Year": 2015,
          "Price": 2450234
        }
      ],
      "IsActive": true,
      "UpdatedAt": "2026-08-10T11:14:17.38+03:00"
    },
    {
      "Id": "9-1003",
      "BrandCode": 9,
      "BrandName": "AUDI",
      "ModelCode": 1003,
      "ModelName": "A6 AVANT 2.0 TDI (177) MULTITRONIC",
      "Prices": [
        {
          "Year": 2016,
          "Price": 2038213
        },
        {
          "Year": 2015,
          "Price": 1977068
        }
      ],
      "IsActive": true,
      "UpdatedAt": "2026-08-10T11:14:17.38+03:00"
    }
  ]
}

Hatalı Yanıt (400 Bad Request)

version parametresiyle gönderilen sürüm, sürüm geçmişinde bulunamadığında düz metin gövdeyle döner:

Sürüm bilgisi bulunamadı. Geçerli sürümleri versions ucundan alabilir ya da version parametresiz tam çekim yapabilirsiniz.

⚠️ Sayısal parametrelere metin gönderilmesi gibi model binding hataları da 400 döner; bu durumda gövde düz metin değil, alan bazlı hata nesnesidir.

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.