04 Руководства

Запись о машине и фото

У всех рынков одни и те же ключи. Чего источник не даёт — null, а не догадка. Всё, что есть только у источника, — в raw.

Поля записи

Поле	Что значит
`id`	source:source_id, стабилен навсегда.
`market, source`	kr · encar, cn · che168, us · copart \| iaai
`title`	Год, марка, модель, комплектация одной строкой.
`brand, model`	Латиницей; марка и семейство модели написаны одинаково во всех рынках (Hyundai Grandeur, Mercedes-Benz E-Class, BMW 3 Series). Местные названия одной машины остаются как у рынка (Avante в Корее — Elantra в США и Китае); название, которого у рынка нет, находит машину под местным: model=Sedona в Корее — это Carnival.
`generation`	Только Корея: название Encar с поколением и рестайлингом (The New Grandeur IG, E-Class W213, 5 Series (G30)); у других рынков null.
`trim`	Версия: у Кореи бейдж Encar, у Китая полное название Che168, у США вариант (C 300, 328i, RX 350).
`year, mileage_km, engine_cc`	Числа; пробег в километрах.
`fuel, transmission, body_type, color`	Канонические английские значения; список — /v1/references/dictionaries.
`vin`	Если источник его дал.
`price`	{amount, currency} — цена в валюте рынка (у США — «купить сейчас» или итоговая ставка проданного лота; текущая ставка — в raw.bid).
`price_usd`	Та же цена в долларах по дневному курсу ЕЦБ.
`location`	{country, region, city}
`photos, photo_count`	Подписанные ссылки на фото и их число.
`listing_url`	Объявление в источнике (у США — null).
`is_active, first_seen_at, last_seen_at, disappeared_at, updated_at`	Статус и время в UTC.
`raw`	Поля источника как есть, включая исходные написания (raw.source_values).

Поля каждого источника подробно — на страницах Encar, Che168, Copart и IAAI.

Фото

Ссылки в photos подписаны и действуют около суток — храните id машины, а не ссылку, и берите свежую запись, когда нужно. Фото отдаёт наш сервер из кэша; если наш сервер не может достучаться до хоста фото, /img отвечает редиректом на оригинал — следуйте редиректам. Запросы к /img квоту не тратят.

Пример записи

Настоящая машина Che168 из каталога (две ссылки на фото):

GET /v1/cars/che168:59997083

{
  "id": "che168:59997083",
  "market": "cn",
  "source": "che168",
  "source_id": "59997083",
  "title": "2024 Jaguar XEL",
  "brand": "Jaguar",
  "model": "XEL",
  "trim": "Jaguar Xel 2024 2.0t 250ps R-Dynamic S Aggressive Sports Version",
  "year": 2024,
  "mileage_km": 10000,
  "fuel": "gasoline",
  "transmission": "automatic",
  "engine_cc": 1997,
  "body_type": "sedan",
  "color": "Green",
  "vin": null,
  "price": {
    "amount": "126800.00",
    "currency": "CNY"
  },
  "price_usd": "18925.15",
  "location": {
    "country": "CN",
    "region": null,
    "city": "Shenzhen"
  },
  "photo_count": 9,
  "listing_url": "https://www.che168.com/dealer/534107/59997083.html",
  "is_active": true,
  "first_seen_at": "2026-09-22T16:29:11.202005Z",
  "last_seen_at": "2026-09-22T16:29:11.202005Z",
  "disappeared_at": null,
  "updated_at": "2026-09-22T16:29:11.202005Z",
  "source_mode": "replica",
  "photos": [
    "https://api.apiauto.space/img/che168:59997083/1.jpg?exp=…&sig=…",
    "https://api.apiauto.space/img/che168:59997083/2.jpg?exp=…&sig=…"
  ],
  "photos_more": 7,
  "raw": {
    "drive": "fwd",
    "seats": null,
    "imported": false,
    "power_hp": 250,
    "power_kw": 184,
    "image_count": 9,
    "che168_infoid": "59997083",
    "first_registration": "2024-10-01"
  },
  "raw_total": 10
}