Объект объявления

Словарь «язык → заголовок», возвращается без выбора языка по lang. Ключи — коды локалей (например, en или ko); в качестве запасного варианта используйте доступный перевод. Возвращает null, если отсутствует, или [] для пустого сохранённого PHP-словаря.

Устаревший объект location или [], если недоступен. Используйте location_details для единообразного формата ID/названия на всех эндпоинтах автомобилей. /search и /listing обычно возвращают сохранённые ID; /cars, /cars/{car_id} и /cars/vin/{vin} пытаются заменить country, location_admin_1, location_admin_2 и location_id локализованными названиями, поэтому значения могут быть строками или несопоставленными ID. Получайте числовой country через /countries/{id}; числовые location_id, location_admin_1 и location_admin_2 — через /locations/{id} или пакетно через ids[]. Не передавайте уже локализованные названия как ID. См. эндпоинты справочника местоположений.

Всегда присутствует в каждом объявлении в /search, /cars, при поиске автомобиля по ID/VIN и поиске объявления. Везде одинаковая расширяемая структура; устаревшее location сохраняется. country берётся из country_id, region — из location_admin_1, district — из location_admin_2, place — из location_id. Каждый отсутствующий компонент равен null. Известный положительный ID сохраняется с name:null, если его не удалось сопоставить; существующая текстовая метка источника имеет id:null. Город/родительский элемент не определяются, обратное геокодирование не выполняется. place — это указанный географический объект, не обязательно город. Для отображения берите названия отсюда; дополнительные запросы с клиента не нужны. Названия следуют правилам lang и запасных значений справочника. Все уникальные ID стран/местоположений собираются из видимых объявлений по всему ответу перед пакетным поиском, пакетами не более 1000 документов справочника. Для пустых наборов ID поиск не нужен; запросов местоположения на каждый автомобиль нет. Ссылки региона на самого себя могут давать повторяющиеся ID; убирайте дубли подписей по ID в пространстве местоположений.

Доступные URL для одного изображения объявления. Каждое поле необязательно и отсутствует, если недоступно. Записи без URL исключаются; массив images может быть пустым. Фиксированные размеры и наличие всех трёх вариантов не гарантируются.

URL видео. Возвращает массив (включая []) или null, если недоступно; никогда не одну строку URL.

Всегда присутствует, как true или false: есть ли у этого объявления хотя бы один публичный отчёт об истории автомобиля.

Флаг лизинга объявления; отсутствует, если у источника нет булева значения. Фильтр запроса is_leasing=false включает отсутствующие и null значения источника.

Непустой объект или массив источника, передаётся без нормализации. Отсутствует, если недоступен или пуст; сохраняйте неизвестные поля.