**08** Руководства

# Версии API и changelog

## Совместимость

Внутри /v1 поля не удаляются и не переименовываются; новые необязательные поля могут появляться — не падайте на незнакомых ключах. Несовместимые изменения выйдут под /v2 с переходным периодом, о котором предупредим в боте.

## Changelog

### Октябрь 2026: поколение и семейство модели

- Поле generation (Корея) и [фильтр generation каталога](https://apiauto.space/docs/endpoints/cars/) ; model — семейство модели, одно на всех рынках.

### Сентябрь 2026: выпуск API v1

- [Каталог](https://apiauto.space/docs/endpoints/cars/) , [машина по id](https://apiauto.space/docs/endpoints/car/) , [лента изменений](https://apiauto.space/docs/endpoints/changes/) , [справочники](https://apiauto.space/docs/endpoints/references/) , [расход](https://apiauto.space/docs/endpoints/usage/) , [живой поиск США](https://apiauto.space/docs/endpoints/live/) .
- Подписанные ссылки на фото через /img.
- Марки и модели во всех рынках пишутся одинаково (Ford, Mercedes-Benz, CX-5, XC60); исходные написания — в raw.source_values.
- В /v1/references/markets — data_age_seconds и stale: насколько свежа копия каждого рынка.

---

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