Речник на данните

Полета в картата от търсенето

Полетата се връщат, когато избраният източник ги предоставя.

auction_id, site_name, auction_batch_id, batch_start_date, batch_end_date,
auction_sec_left, buy_now_price, car_country_extended, country_code,
country_marker_code, country_marker_name, country_marker_color, car_name_en,
current_price, buynow_final, current_final, buynow_bgn, current_bgn,
date_first_registration, has_technical_damage, is_broken, is_buy_now, kw,
mileage, start_price, final_price, thumbnail_url, hp, pk, size, picture_count,
clean_make, clean_model, model_display, model_class_series, fuel_group,
gearbox_group, clean_type, registration_year, production_year, production_month, is_margin, public_damage_state, public_price_eur,
offer_link, is_active, is_top_offer, top_offer_savings_pct, top_offer_savings

Още четири полета се изчисляват, а не се съхраняват. Първите три са на всеки ред; четвъртото се появява, щом снимката е в нашия CDN.

Редовете съдържат и данни за снимките до миниатюрата: thumbnailUrl и servedThumbnailUrl (camelCase близнаци на полетата по-горе), image_status и image_source както при записите в галерията, original_thumbnail_url (собствената миниатюра на източника, когато архивът я е заменил) и images — най-много първите 8 записа от галерията в реда на показване, основната първа. images в ред от търсенето е преглед за картата, никога пълната галерия: за всичко четете vault_gallery в отговора с детайли или /api/auction-images/{site}/{id}.

fuel_group може да е празно — japan не публикува гориво за по-голямата част от каталога — а лот без известно гориво съвпада с всеки филтър fuel, а не с нито един, така че филтрирането по гориво не прави тези лотове недостъпни.

Допълнителни полета в детайлите за търга

car_id, chassis_number, co2, co2_estimated, co2_estimated_standard,
buynow_tax, current_tax, buynow_tax_delivery, current_tax_delivery,
cylinder_capacity, effluent_standard_group_search, is_margin,
requested_sales_price, requested_sales_price_can_be_shown, special_price, places,
seller_score, country_code_dealer, community_name, community_seller_name,
currency_code_id, vehicle_grade_id, mechanical_indicator_id, is_commercial_car,
car_identification, car_report_types, images, gallery_images, created_at,
updated_at, first_seen_at, last_seen_at, last_available_at, last_changed_at,
vehicle_details, vault_gallery, estimated_value_eur, is_blind, details_pending

Съдържа и auction_id_str, auction_end_at и steering, точно както картите от търсенето, плюс същите четири ключа във формата на каталога, които добавя /api/listVehicles: vehicle_id (дубликат на auction_id със същото предупреждение за 2^53 — предпочитайте auction_id_str), manufacturer_slug, model_group_slug и, където редът има такова, fuel_type. Двата slug са стойностите, с които се адресират маршрутите на каталога, така че отговорът с детайли е достатъчен, за да изградите връзка към страниците на производителя и групата модели без втора заявка.

`is_blind` and `details_pending`

Две булеви стойности отговарят на въпроси, на които останалите данни не могат.

is_blind е true, когато аукционната къща по замисъл не публикува никакво наддаване. Това е единственият случай, в който current_price: null е окончателен отговор, а не липсващи данни — няма стойност за извличане, нито сега, нито по-късно, и никога няма да пристигне актуална цена. Клиент, който показва „цената не е налична, опитваме отново…“ за закрит лот, ще опитва вечно; четете този флаг и вместо това показвайте estimated_value_eur, отбелязано като оценка.

details_pending е true, когато пълните детайли на обявата още не са извлечени от източника. Докато е true, vehicle_details се пропуска и отговорът се обслужва с кратък max-age, така че клиент с периодични проверки да види появата на детайлите. Това не е грешка и не изисква обработка освен показване на раздела със спецификацията, щом стане false.

Блокът vehicle_details

Присъства в /api/auction/{site}/{id} и /api/car-details. Източниците с богати детайли описват едни и същи понятия под различни имена — файл за изтегляне е Documents[] в Auto1, докато Documents в OpenLane е речник с булеви стойности за документите, а не списък с файлове — затова този блок ги нормализира. Четете него, вместо да разклонявате по site_name. Всеки ключ се пропуска, когато източникът няма нищо за него, а целият блок се пропуска, докато details_pending е true.

Покритието не е еднакво за всички източници

Всяка аукционна къща публикува различно подмножество от тези ключове и разликите са големи: само Auto1 има измервания на боята, OpenLane разграничава файловете с протоколи от отметките за документи, KB предоставя по избор записи за диагностика и оглед, а Япония — импортирани снимки и по избор данни от протокола. Това е ограничение при източника, а не пропуск в нашите данни — не изграждайте интерфейс, който приема, че даден ключ винаги е там. Пълната матрица на покритието, кодовете на типовете протоколи на OpenLane и капаните по източник са в Полета по източник.

Година на производство, регистрация и версия

registration_year описва първата регистрация; production_year използва данни за година на производство/модел и при липса пада обратно на registration_year. production_month може да е null и не се извежда от данни само с година. Използвайте production_year_from / production_year_to и production_year_new / production_year_old за измерението „година на производство“. /api/production-years връща production_years и production_year_counts; /api/facets го включва като production_years. /api/types изисква brand и model и връща версии с бройки плюс групирани записи на модели. Използвайте type за версии, отделно от vehicle_type и body_style.

is_margin е флаг за режима на ДДС в картите и детайлите, който може да е null. True означава режим на маржа, false — ДДС за приспадане, null — неизвестно. Не тълкувайте липсващите ценови полета, зависещи от права, като нула. Допълнителните блокове с протоколи от източника включват kb_diagnosis и kb_inspection от KB; данните за импортираните японски оферти са в car_identification.JapanOffers.

Никога не се показва

Полетата за наддаващите и личните полета — самоличности на наддаващите, частни наддавания, лични максимуми и данни за поръчки — никога не се връщат. Нито пък търговските данни, свързани с акаунт: таксите, разходите и доставката на аукционните къщи са изчислени за нашия акаунт на купувач и нашия адрес за доставка, така че описват нашите търговски условия, а не автомобила.

Все още се сервират: собствените публикувани цени на аукционната къща (price_buy_now, price_min_bid, price_estimation), режимът на ДДС (is_margin, vat_scheme), прогнозната цена на ремонта, Specs.TransportCategoryId (клас на автомобила, не пратка), местоположението на продавача/склада и buynow_tax_delivery / current_tax_delivery. За крайна цена използвайте калкулатора за внос, който е създаден за вашия маршрут.

Източници и изброявания

Европейската мрежа от обяви не е в списъка с източници. Тя е пазарна референция на дребно, а не инвентар от търгове, така че не е валидна стойност за site — вижте вместо това групата ендпойнти за обяви.