Справочник

Списък с промени

Промени в публичния 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

/domains връща id, name и base_url за всеки източник.

Търсене по VIN

Нов ендпойнт /cars/vin/{vin} за търсене по точен VIN.

Доклади за историята на автомобила

vehicle_history_reports в детайлните ендпойнти, както и has_history_reports в автомобилите и обявите.

Огледи и точни бройки

inspections и has_inspections, както и новият ендпойнт /search/count.

Вземете достъп до API

Свържете ключа си, за да изпълнявате всяка заявка от тези страници с вашите данни. Още нямате ключ? Поискайте ни демо ключ: същият JSON като в платените планове.

Имам ключ