Podstawowe pojęcia

Samochody, ogłoszenia i ID

Samochód to jeden fizyczny pojazd. Gdy ten sam pojazd jest ogłaszany w kilku serwisach, scalamy te ogłoszenia w jeden samochód z kilkoma ogłoszeniami. Cena, przebieg, zdjęcia i lokalizacja należą do ogłoszenia; marka, model i dane techniczne należą do samochodu.

W każdej odpowiedzi występują cztery rodzaje ID. Należą do odrębnych przestrzeni nazw, więc nigdy nie przekazuj jednego tam, gdzie oczekiwany jest inny.

ID samochodul_eCJb-8zB_XcJ-z6Y7oZWjwNieprzezroczysty ciąg w data.id. Używaj z /cars/{car_id}. Przechowuj go jako tekst.

ID ogłoszenia42802955Własne ID ogłoszenia w źródle, w listings[].external.id. Unikalne tylko w połączeniu z domeną.

ID domeny55613Serwis źródłowy w external.domain.id. Włączone ID pochodzą z /domains.

ID marki i modelu88 · 573ID katalogowe w brand.id i model.id. Pochodzą z /brands i /models.

Tablica listings samochodu jest ograniczona do Twoich włączonych źródeł, ale może zawierać kilka ogłoszeń z tego samego serwisu. Nigdy nie zakładaj, że pierwsze ogłoszenie to to, o które pytałeś; dopasowuj po domain.id i external.id.
Brak wartości lub null oznacza "nie dostarczono przez źródło", nigdy zero ani false.
Kontrakt jest addytywny. Nowe pola mogą pojawić się w dowolnym momencie; ignoruj to, czego nie używasz, i nie zgłaszaj błędów przy nieznanych kluczach.
hash to SHA-256 samochodu bez znaczników czasu. Jeśli nie zmienił się od ostatniej synchronizacji, możesz pominąć aktualizację.

GET /cars/{car_id} · excerpt Live

{
  "data": {
    "id": "l_eCJb-8zB_XcJ-z6Y7oZWjw",
    "vin": "wddhf0cb3ea952710",
    "brand": { "id": 88, "name": "Mercedes-Benz" },
    "model": { "id": 573, "name": "E-klasse" },
    "listings": [
      {
        "external": {
          "id": "42802955",
          "domain": { "id": 55613, "name": "fem.encar.com" },
          "url": "https://fem.encar.com/cars/detail/42802955"
        },
        "archived": false,
        "price": { "price": 6390000, "currency": { "id": 81, "name": "krw" } },
        …
      },
      { …second listing of the same car… }
    ]
  }
}