Обектът listing
Една обява в един сайт източник. Тук се намират цена, пробег, снимки, местоположение и данни за продавача. Цените са във валутата на самата обява и никога не се конвертират.
3 дъщерни атрибута
ID на обявата в източника; различно от вътрешното ID на автомобила.
2 дъщерни атрибута
Речник език–заглавие, връщан без избор на език според 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. Вижте ендпойнтите на речника на местоположенията.
8 дъщерни атрибута
Административна стойност от източника; не е гарантирано ID от речника на местоположенията.
2 дъщерни атрибута
Винаги присъства във всяка обява в /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 в пространството от имена на местоположенията.
4 дъщерни атрибута
3 дъщерни атрибута
Вътрешно ID на държава, разрешавано чрез /countries.
Локализирано име на държавата.
ISO код на държавата с главни букви или null, когато не е наличен.
2 дъщерни атрибута
Оригинално ID на местоположението или null за текстов етикет, собственост на източника.
Локализирано име или null, когато не е разрешено.
2 дъщерни атрибута
Оригинално ID на местоположението или null за текстов етикет, собственост на източника.
Локализирано име или null, когато не е разрешено.
2 дъщерни атрибута
Оригинално ID на местоположението или null за текстов етикет, собственост на източника.
Локализирано име или null, когато не е разрешено.
Налични URL адреси за едно изображение на обявата. Всяко поле е незадължително и се пропуска, когато не е налично. Записи без нито един URL се изключват; масивът images може да е празен. Не се гарантират фиксирани размери или наличие и на трите варианта.
3 дъщерни атрибута
URL адрес на копието на изображението, изтеглено в нашето хранилище за изображения. Връща се само когато са налични и пътят до съхранения файл, и сървърът за изображения; URL адресът използва хоста за изображения, конфигуриран за домейна на API.
URL адрес на изображение за преглед, предоставен от източника на обявата. Предава се без промяна; обикновено е подходящ за миниатюри. Размерите не са гарантирани.
URL адрес на оригиналното изображение, предоставен от източника на обявата. Предава се без промяна; сочи към изображението в източника, а не към нашето изтеглено копие.
URL адреси на видеоклипове. Връща масив (включително []) или null, когато не е наличен; никога единичен URL низ.
4 дъщерни атрибута
2 дъщерни атрибута
3 дъщерни атрибута
2 дъщерни атрибута
2 дъщерни атрибута
2 дъщерни атрибута
2 дъщерни атрибута
2 дъщерни атрибута
2 дъщерни атрибута
2 дъщерни атрибута
Винаги присъства, като true или false: дали тази обява има поне един публичен доклад за историята на автомобила.
Флаг за лизинг на обявата; пропуска се, когато източникът няма булева стойност. Филтърът на заявката is_leasing=false включва липсващи и null стойности от източника.
Непразен обект или масив, собственост на източника, предаден без нормализация. Пропуска се, когато не е наличен или е празен; запазвайте непознатите полета.
{30 keys
"external": {3 keys
"domain": {2 keys
"title": {2 keys
"location": {6 keys
"position": {2 keys
"location_details": {4 keys
"country": {3 keys
"region": {2 keys
"district": {2 keys
"place": {2 keys
"images": [2 items
]"video": [1 item
"price": {4 keys
"currency": {2 keys
"history": [3 items
]"seller_type": {2 keys
"availability": {2 keys
"condition": {2 keys
"damage": {2 keys
"second_damage": {2 keys
"airbag_state": {2 keys
"document_id": {2 keys
"option_ids": [5 items
]"source_data": {2 keys
}Примерни стойности, подбрани така, че да покажат всички полета. ID за изброяванията, валутата и местоположенията са реални; имената, VIN номерата и URL адресите са измислени. Поле, което не виждате в реален отговор, не е предоставено от източника.
