**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](https://apiauto.space/docs/endpoints/references/). |
| `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](https://apiauto.space/encar-api/), [Che168](https://apiauto.space/che168-api/), [Copart](https://apiauto.space/copart-api/) и [IAAI](https://apiauto.space/iaai-api/).

## Фото

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

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

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

GET /v1/cars/che168:59997083:

```json
{
  "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
}
```

---

Страница: https://apiauto.space/docs/record/