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

Автомобили, объявления и 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… }
    ]
  }
}