Журнал изменений
Изменения публичного API. Все они только добавляют новое, если не указано иное, поэтому существующие интеграции продолжают работать.
vehicle_type=automobile / 1 — по умолчанию; motorcycle / 2 выбирает мотоциклы в /search, /search/count и /cars. В справочниках используйте тот же тип.
Полная вложенность: brands[] → models[] → generations[] → variants[] / trims[]. У каждого объекта бренда, модели и поколения обязателен id. Между соседями и значениями в списках variants/trims — ИЛИ; между условиями одной ветки — И. Отсутствующий или пустой дочерний список означает любых потомков. В каждом массиве до 100 элементов. Неизвестные или несовместимые ID дают пустой результат; неверный формат — 422.
/generations/{model_id} · /trims/{generation_id} · /variants/{generation_id}
Без vehicle_type возвращаются автомобили; motorcycle / 2 выбирает мотоциклы. Сохраняйте тип на каждом шаге. Без пагинации /brands и /models сохраняют прежние массивы и лимиты. Передайте per_page=100 для {data,meta}. Вложенные generations сохраняют {name,from,to}; ID поколений берите из /generations/{model_id}.
Если сервис ключей ненадолго недоступен, запросы возвращают 503 с Retry-After: 5 вместо сбоя. Проход /cars теперь всегда завершается с scroll_id: null.
У каждого объявления теперь есть location_details с локализованными страной, регионом, районом и населённым пунктом. Новые эндпоинты /countries, /countries/{id}, /locations и /locations/{id}. next_url теперь использует HTTPS на том хосте, к которому вы обращались. Фильтр steering_wheel_position проходит валидацию.
is_leasing в /search, /search/count и /cars. /models/{brand_id} теперь возвращает 422 для нецелого ID марки. /search по умолчанию использует perPage=50.
Отчёты об осмотре и истории содержат translations.terms с подписями для каждого стандартизированного ключа на запрошенном языке lang.
Объявления могут содержать source_data — собственные поля источника, переданные без изменений.
/domains возвращает id, name и base_url для каждого источника.
Новый эндпоинт /cars/vin/{vin} для поиска по точному VIN.
vehicle_history_reports на детальных эндпоинтах, а также has_history_reports у автомобилей и объявлений.
inspections и has_inspections, а также новый эндпоинт /search/count.
Получите доступ к API
Подключите ключ, чтобы выполнять любой запрос с этих страниц на своих данных. Ключа ещё нет? Попросите у нас демо-ключ: тот же JSON, что и в платных тарифах.