Основни понятия

Автомобили, обяви и ID

Автомобилът е едно физическо превозно средство. Когато едно и също превозно средство е обявено в няколко сайта, обединяваме тези обяви в един автомобил с няколко обяви. Цената, пробегът, снимките и местоположението принадлежат на обявата; марката, моделът и спецификациите — на автомобила.

Във всеки отговор присъстват четири вида ID. Те са в отделни пространства от имена, затова никога не подавайте едното там, където се очаква другото.

ID на автомобилl_eCJb-8zB_XcJ-z6Y7oZWjwНепрозрачен низ в data.id. Използва се с /cars/{car_id}. Съхранявайте го като текст.

ID на обява42802955Собственото ID на обявата в източника, в listings[].external.id. Уникално е само в комбинация с домейна си.

ID на домейн55613Сайтът източник в external.domain.id. Активираните ID идват от /domains.

ID на марка и модел88 · 573Каталожни ID в brand.id и model.id. Идват от /brands и /models.

listings на автомобила е ограничено до вашите активирани източници, но може да съдържа няколко обяви от един и същ сайт. Никога не приемайте, че първата обява е тази, която сте заявили; съпоставяйте по domain.id и external.id.
Липсващо или null означава „не е предоставено от източника“, никога нула или false.
Договорът е добавящ. Нови полета може да се появят по всяко време; игнорирайте неизползваните и не прекъсвайте работа при непознати ключове.
hash е SHA-256 на автомобила без времевите отпечатъци. Ако не се е променил от последната ви синхронизация, можете да пропуснете обновяването.

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