Materiały referencyjne

Historia zmian

Zmiany w publicznym API. Wszystkie są addytywne, chyba że zaznaczono inaczej, więc istniejące integracje nadal działają.

Filtrowanie według typu i konfiguracji pojazdu

vehicle_type=automobile / 1 jest domyślne; motorcycle / 2 wybiera motocykle w /search, /search/count i /cars. Używaj tego samego typu w słownikach.

Pełne zagnieżdżenie: brands[] → models[] → generations[] → variants[] / trims[]. Każdy obiekt marki, modelu i generacji wymaga id. LUB między rodzeństwem i wartościami variants/trims; I między warunkami w jednej gałęzi. Brak lub pusta lista potomna oznacza wszystkich potomków. Do 100 elementów w tablicy. Nieznane lub niezgodne ID dają pusty wynik; zły format — 422.

Słowniki samochodów i motocykli

/generations/{model_id} · /trims/{generation_id} · /variants/{generation_id}

Bez vehicle_type zwracane są samochody; motorcycle / 2 wybiera motocykle. Zachowaj typ na każdym kroku. Bez paginacji /brands i /models zachowują poprzednie tablice i limity. Podaj per_page=100 dla {data,meta}. Zagnieżdżone generations zachowują {name,from,to}; ID generacji są w /generations/{model_id}.

Bardziej odporne sprawdzanie kluczy i eksport

Jeśli usługa kluczy jest chwilowo nieosiągalna, żądania zwracają 503 z Retry-After: 5 zamiast kończyć się błędem. Przebieg /cars zawsze kończy się teraz scroll_id: null.

Szczegóły lokalizacji i słowniki

Każde ogłoszenie ma teraz location_details z lokalizowanym krajem, regionem, powiatem i miejscowością. Nowe endpointy /countries, /countries/{id}, /locations i /locations/{id}. next_url używa teraz HTTPS na hoście, który wywołałeś. Filtr steering_wheel_position jest walidowany.

Filtr leasingu

is_leasing w /search, /search/count i /cars. /models/{brand_id} zwraca teraz 422 dla niecałkowitego ID marki. /search domyślnie używa perPage=50.

Tłumaczenia raportów

Raporty z inspekcji i historii zawierają translations.terms z etykietami dla każdego ustandaryzowanego klucza w żądanym lang.

Dane źródłowe w ogłoszeniach

Ogłoszenia mogą zawierać source_data, czyli własne pola źródła przekazane bez zmian.

Spójne pola /domains

/domains zwraca id, name i base_url dla każdego źródła.

Wyszukiwanie po VIN

Nowy endpoint /cars/vin/{vin} do wyszukiwania po dokładnym numerze VIN.

Raporty historii pojazdu

vehicle_history_reports w szczegółowych endpointach oraz has_history_reports w samochodach i ogłoszeniach.

Inspekcje i dokładne liczniki

inspections i has_inspections oraz nowy endpoint /search/count.

Uzyskaj dostęp do API

Podłącz klucz, aby uruchamiać każde zapytanie z tych stron na własnych danych. Nie masz jeszcze klucza? Poproś nas o klucz demo: ten sam JSON co w planach płatnych.

Mam już klucz