Obiekt ogłoszenia
Jedno ogłoszenie w jednym serwisie źródłowym. Tutaj znajdują się cena, przebieg, zdjęcia, lokalizacja i dane sprzedawcy. Ceny są podawane we własnej walucie ogłoszenia i nigdy nie są przeliczane.
Atrybuty podrzędne: 3
ID ogłoszenia w źródle; różni się od wewnętrznego ID samochodu.
Atrybuty podrzędne: 2
Mapa język–tytuł, zwracana bez wybierania języka na podstawie lang. Klucze to kody locale (na przykład en lub ko); jako wartości zastępczej użyj dostępnego tłumaczenia. Zwraca null, gdy brak, lub [] dla pustej zapisanej mapy PHP.
Starszy obiekt lokalizacji lub [], gdy niedostępny. Używaj location_details dla jednolitego formatu ID/nazwa we wszystkich endpointach pojazdów. /search i /listing zwykle udostępniają zapisane ID; /cars, /cars/{car_id} i /cars/vin/{vin} próbują zastąpić country, location_admin_1, location_admin_2 i location_id lokalizowanymi nazwami, więc wartości mogą być ciągami lub nierozwiązanymi ID. Rozwiązuj liczbowe country przez /countries/{id}; liczbowe location_id, location_admin_1 i location_admin_2 rozwiązuj przez /locations/{id} lub zbiorczo za pomocą ids[]. Nie wysyłaj już zlokalizowanych nazw jako ID. Zobacz endpointy słownika lokalizacji.
Atrybuty podrzędne: 8
Wartość administracyjna źródła; nie jest to gwarantowane ID słownika lokalizacji.
Atrybuty podrzędne: 2
Zawsze obecne w każdym ogłoszeniu w /search, /cars, wyszukiwaniu po ID samochodu/VIN i wyszukiwaniu ogłoszeń. Wszędzie ten sam addytywny kształt; starsze location jest zachowane. country pochodzi z country_id, region z location_admin_1, district z location_admin_2, place z location_id. Każdy brakujący komponent ma wartość null. Znane dodatnie ID pozostaje obecne z name:null, jeśli nie zostało rozwiązane; istniejąca tekstowa etykieta źródła ma id:null. Nie jest wykonywane wyznaczanie miasta/jednostki nadrzędnej ani odwrotne geokodowanie. place to wskazany obiekt geograficzny, niekoniecznie miasto. Do wyświetlania odczytuj nazwy stąd; dodatkowe wyszukiwanie po stronie klienta nie jest potrzebne. Nazwy podlegają regułom lang i wartości zastępczych słownika. Wszystkie unikalne ID krajów/lokalizacji są zbierane z widocznych ogłoszeń w całej odpowiedzi przed zbiorczym wyszukiwaniem, w partiach po najwyżej 1000 dokumentów słownika. Puste zbiory ID nie wymagają wyszukiwania; nie ma żądań lokalizacji na pojedynczy samochód. Regionalne odwołania do samego siebie mogą dawać zduplikowane ID; usuwaj duplikaty etykiet po ID w obrębie przestrzeni nazw lokalizacji.
Atrybuty podrzędne: 4
Atrybuty podrzędne: 3
Wewnętrzne ID kraju, rozwiązywane przez /countries.
Lokalizowana nazwa kraju.
Kod ISO kraju wielkimi literami lub null, gdy niedostępny.
Atrybuty podrzędne: 2
Oryginalne ID lokalizacji lub null dla tekstowej etykiety pochodzącej ze źródła.
Lokalizowana nazwa lub null, gdy nierozwiązana.
Atrybuty podrzędne: 2
Oryginalne ID lokalizacji lub null dla tekstowej etykiety pochodzącej ze źródła.
Lokalizowana nazwa lub null, gdy nierozwiązana.
Atrybuty podrzędne: 2
Oryginalne ID lokalizacji lub null dla tekstowej etykiety pochodzącej ze źródła.
Lokalizowana nazwa lub null, gdy nierozwiązana.
Dostępne URL-e jednego obrazu ogłoszenia. Każde pole jest opcjonalne i pomijane, gdy niedostępne. Wpisy bez żadnego URL są wykluczane; tablica images może być pusta. Nie są gwarantowane stałe wymiary ani dostępność wszystkich trzech wariantów.
Atrybuty podrzędne: 3
URL kopii obrazu pobranej do naszego magazynu obrazów. Zwracany tylko wtedy, gdy dostępne są zarówno zapisana ścieżka pliku, jak i serwer obrazów; URL używa hosta obrazów skonfigurowanego dla domeny API.
URL obrazu podglądu dostarczony przez źródło ogłoszenia. Przekazywany bez zmian; zwykle nadaje się na miniatury. Wymiary nie są gwarantowane.
URL oryginalnego obrazu dostarczony przez źródło ogłoszenia. Przekazywany bez zmian; wskazuje obraz źródłowy, a nie naszą pobraną kopię.
URL-e wideo. Zwraca tablicę (także []) lub null, gdy niedostępne; nigdy pojedynczy ciąg URL.
Atrybuty podrzędne: 4
Atrybuty podrzędne: 2
Atrybuty podrzędne: 3
Atrybuty podrzędne: 2
Atrybuty podrzędne: 2
Atrybuty podrzędne: 2
Atrybuty podrzędne: 2
Atrybuty podrzędne: 2
Atrybuty podrzędne: 2
Atrybuty podrzędne: 2
Zawsze obecne, jako true lub false: czy to ogłoszenie ma co najmniej jeden publiczny raport historii pojazdu.
Flaga leasingu ogłoszenia; pomijana, gdy źródło nie ma wartości logicznej. Filtr zapytania is_leasing=false obejmuje brakujące i null wartości źródła.
Niepusty obiekt lub tablica pochodzące ze źródła, przekazywane bez normalizacji. Pomijane, gdy niedostępne lub puste; zachowuj nieznane pola.
{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
}Przykładowe wartości dobrane tak, aby pokazać każde pole. ID dla enumów, walut i lokalizacji są prawdziwe; nazwy, numery VIN i URL-e są zmyślone. Pole, którego nie widzisz w prawdziwej odpowiedzi, nie zostało dostarczone przez źródło.
