Skip to navigation

Vehicle Catalog Meta

Vehicle Catalog Meta

Araç kataloğunun senkron durumunu (sürüm, araç sayısı, son senkron zamanı) döndürür.

Uç Nokta (Endpoint)

GET {{baseUrl}}/api/VehicleCatalogs/meta


Kullanım

Bu servis, kataloğu periyodik çeken tüketicilerin gereksiz tam çekimden kaçınması için kullanılır. Önerilen akış:

  1. Authentication Login servisinden token alınır.
  2. Bu servis çağrılır ve dönen Version eldeki sürümle karşılaştırılır.
  3. Version değişmediyse katalog değişmemiştir; yeniden çekmeye gerek yoktur.
  4. Version değiştiyse GET /api/VehicleCatalogs/versions üzerinden delta ya da GET /api/VehicleCatalogs ile tam çekim yapılır.

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.

BaşlıkTürZorunluAçıklama
Authorizationstring✅Bearer <token> biçiminde erişim token’ı.

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


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

AlanTürAçıklama
VersionstringKatalog sürümü (son başarılı senkronun hash’i). Katalog ucunun yanıtındaki LatestVersion ile aynıdır.
VehicleCountintegerSon senkrondaki toplam araç sayısı.
UpdatedAtdatetimeSon başarılı senkron zamanı.

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

{
"Version": "52C958DB9124FAD5021C7AFA54F2699E0459A5B0",
"VehicleCount": 27819,
"UpdatedAt": "2026-08-10T11:14:17.38+03:00"
}

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.


Hatalı Yanıt (404 Not Found)

Katalog henüz hiç senkronlanmadığında (senkron kaydı bulunmadığında) HTTP 404 Not Found döner.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Headers

AuthorizationstringOptional

Response headers

Content-TypestringOptional

Response

OK