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

Автомобілі, оголошення та 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 · 573ID каталогу в 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… }
    ]
  }
}