Konceptet bazë

Makina, shpallje dhe ID

Një makinë është një automjet fizik. Kur i njëjti automjet reklamohet në disa faqe, ne i bashkojmë ato shpallje në një makinë me disa shpallje. Çmimi, kilometrazhi, fotot dhe vendndodhja i përkasin shpalljes; marka, modeli dhe specifikimet i përkasin makinës.

Katër lloje ID-sh shfaqen në çdo përgjigje. Ato jetojnë në hapësira emrash të veçanta, prandaj mos kaloni kurrë njërën aty ku pritet tjetra.

ID e makinësl_eCJb-8zB_XcJ-z6Y7oZWjwVarg i errët te data.id. Përdoreni me /cars/{car_id}. Ruajeni si tekst.

ID e shpalljes42802955ID-ja e shpalljes në vetë burimin, te listings[].external.id. Unike vetëm së bashku me domenin e saj.

ID e domenit55613Faqja burim te external.domain.id. ID-të e aktivizuara vijnë nga /domains.

ID e markës dhe modelit88 · 573ID katalogu te brand.id dhe model.id. Vijnë nga /brands dhe /models.

listings e një makine kufizohet te burimet tuaja të aktivizuara, por mund të përfshijë disa shpallje nga e njëjta faqe. Mos supozoni kurrë se shpallja e parë është ajo që kërkuat; përputheni sipas domain.id dhe external.id.
Mungesa ose null do të thotë "nuk është dhënë nga burimi", kurrë zero ose false.
Kontrata është shtuese. Fusha të reja mund të shfaqen në çdo kohë; injoroni atë që nuk përdorni dhe mos dështoni te çelësat e panjohur.
hash është një SHA-256 i makinës pa vulat kohore. Nëse nuk ka ndryshuar që nga sinkronizimi juaj i fundit, mund ta anashkaloni përditësimin.

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… }
    ]
  }
}