PolskiDokumentacja API / Pojazdy
Wyszukiwanie pojazdów z aktywnych aukcji
/carsRozmiar strony 50 / 1000Wyszukuj pojazdy z aktywnymi ogłoszeniami Copart lub IAAI. Przydaje się do pozyskiwania aut, zasobów importera, monitoringu i analizy rynku.
- Filtruj według źródła, producenta, modelu, generacji, roku, przebiegu, ceny, lokalizacji, uszkodzeń i szczegółów aukcji. Wszystkie parametry zapytania są opcjonalne.
- Domyślny rozmiar strony to 50 w każdym planie; maksimum to 1000 w Unlimited. Pojazdy są domyślnie sortowane rosnąco według wewnętrznego ID. Użyj minutes dla aktualizacji z ostatnich 4320 minut (72 godzin) oraz
/archived-lotsdo śledzenia usunięć. - Zwraca pojazdy w data, a paginację w links i meta. Każdy pojazd zawiera specyfikację oraz tablicę lots z identyfikatorami źródła, zdjęciami, przebiegiem, cenami, datami aukcji i stanem, o ile są dostępne. Dodaj
prices_history=1,aby dołączyć tablicę prices każdego lotu. - Aktywne ogłoszenie nie gwarantuje, że licytacja jest otwarta. Zobacz
exclude_expired_auctions, aby poznać obecne ograniczenie implementacji.
- Zmień wartości poniżej
- Zapytanie po prawej się zaktualizujeZapytanie powyżej się zaktualizuje
- Uruchom na żywo ze swoim kluczem
Parametry zapytania 46
ID platformy źródłowej: 1 = IAAI, 3 = Copart. Pomiń, aby przeszukać wszystkie źródła dostępne dla Twojego konta. Filtruje pasujące pojazdy; ich zagnieżdżone lots mogą zawierać inne źródła.
Pojazdy lub ogłoszenia zaktualizowane w ciągu ostatnich N minut. Użyj 1–4320 (do 72 godzin), na przykład 60. Pomiń dla zwykłego feedu.
Liczba rekordów na stronę. Pomiń, aby uzyskać 50. Maksimum 1000 w Unlimited; Demo i Small są ograniczone do 50.
Numer strony, licząc od 1. Pomiń, aby pobrać stronę 1.
Ustaw 1, aby pominąć łączne liczby, lub 0, aby je dołączyć. Pomiń, aby użyć domyślnego ustawienia konta. Prosta paginacja sprawdza się przy dużych synchronizacjach.
Sortuje pojazdy według wewnętrznego ID auta: asc (domyślnie) lub desc. Nie sortuje według czasu aukcji ani ceny.
Ustaw 1, aby dołączyć tablicę historii cen dla każdego lotu. Pomiń lub użyj 0 dla standardowej odpowiedzi.
Jedno ID producenta lub ID rozdzielone przecinkami z /manufacturers/{type}, na przykład 16 (BMW) lub 16,20. Wyślij jeden ciąg, a nie tablicę.
Wewnętrzne ID modelu z /models/{manufacturer_id}/{type}.
Wewnętrzne ID generacji z /generations/{model_id}/{type}.
Dokładny rocznik, na przykład 2020. W /cars jest stosowany razem z dowolnym zakresem lat.
Minimalny rocznik, włącznie. Można łączyć z to_year.
Maksymalny rocznik, włącznie. Można łączyć z from_year.
VIN (dopasowanie zapisanej wartości bez rozróżniania wielkości liter) lub numer lotu ze źródła. Do filtra wyłącznie po VIN użyj vin; do wyszukiwania w ogłoszeniach aktywnych i archiwalnych użyj /search-vin lub /search-lot.
Filtr VIN bez rozróżniania wielkości liter. Użyj _ jako znaku wieloznacznego zastępującego wiele znaków: YV1MC_ pasuje do numerów VIN zaczynających się od YV1MC. Bez znaku wieloznacznego dopasowuje całą zapisaną wartość.
Fragment tytułu pojazdu bez rozróżniania wielkości liter, na przykład Corvette.
ID kategorii pojazdu. Zobacz dozwolone wartości poniżej.
ID typu nadwozia. Zobacz dozwolone wartości poniżej.
ID koloru zewnętrznego. Zobacz dozwolone wartości poniżej.
ID rodzaju paliwa. Zobacz dozwolone wartości poniżej.
ID skrzyni biegów: 1 = automatyczna, 2 = manualna.
ID układu napędowego: 1 = tylny, 2 = przedni, 3 = na wszystkie koła.
ID stanu ogłoszenia. Zobacz dozwolone wartości poniżej.
Dokładna liczba cylindrów silnika, na przykład 4, 6 lub 8.
Fragment nazwy silnika bez rozróżniania wielkości liter, na przykład 2.0.
Dwuliterowy kod kraju lokalizacji pojazdu, na przykład US lub CA. Pomiń, aby uwzględnić wszystkie dostępne kraje.
Kod stanu lub prowincji z /usa/states, na przykład CA lub FL. Bez rozróżniania wielkości liter; połącz z country, aby odróżnić lokalizacje o tym samym kodzie.
Fragment nazwy uszkodzenia głównego lub dodatkowego z /usa/damages, bez rozróżniania wielkości liter, na przykład hail lub front. Wyślij pojedynczy ciąg. Jeśli żadne uszkodzenie ze słownika nie pasuje, filtr nie jest stosowany.
Fragment nazwy tytułu dokumentu z /usa/titles, bez rozróżniania wielkości liter, na przykład salvage. Sprawdza tytuł z ogłoszenia, szczegółowy i skrócony. Jeśli żaden tytuł ze słownika nie pasuje, filtr nie jest stosowany.
ID statusu aukcji. Zobacz dozwolone wartości poniżej. Dla kilku statusów użyj status[] zamiast tego; nie wysyłaj obu naraz.
Kilka ID statusów aukcji (1–10) jako powtarzane klucze w nawiasach, na przykład status[]=4&status[]=5. Używaj zamiast status. Nie wysyłaj status=[] ani ciągu JSON.
Ustaw 1, aby wymagać dodatniej ceny Buy Now. 0 lub pominięcie nie filtruje po Buy Now.
Minimalna cena Buy Now, włącznie (1 lub więcej, dozwolone ułamki). Kwoty są w zapisanych jednostkach ceny źródła, bez przeliczeń i opłat.
Maksymalna cena Buy Now, włącznie (1 lub więcej, dozwolone ułamki). Kwoty są w zapisanych jednostkach ceny źródła, bez przeliczeń i opłat.
Minimalna zapisana oferta, włącznie (1 lub więcej, dozwolone ułamki). To nie jest kwota końcowej sprzedaży.
Maksymalna zapisana oferta, włącznie (1 lub więcej, dozwolone ułamki). To nie jest kwota końcowej sprzedaży.
Minimalny zapisany odczyt licznika w kilometrach, włącznie. Jeśli ustawiono filtry w kilometrach i milach, oba muszą pasować.
Maksymalny zapisany odczyt licznika w kilometrach, włącznie. Jeśli ustawiono filtry w kilometrach i milach, oba muszą pasować.
Minimalny zapisany odczyt licznika w milach, włącznie. Jeśli ustawiono filtry w kilometrach i milach, oba muszą pasować.
Maksymalny zapisany odczyt licznika w milach, włącznie. Jeśli ustawiono filtry w kilometrach i milach, oba muszą pasować.
Data aukcji ściśle po tej dacie kalendarzowej (YYYY-MM-DD). Część czasowa jest ignorowana. Zastępuje sale_date_in_days; ignorowane przy without_sale_date=1.
Data aukcji ściśle przed tą datą kalendarzową (YYYY-MM-DD). Część czasowa jest ignorowana. Ignorowane przy without_sale_date=1.
Loty, których data aukcji jest późniejsza niż N dni temu, łącznie z datami przyszłymi. Zastępowane przez sale_date_from; ignorowane przy without_sale_date=1.
Znaczniki czasu aukcji od teraz do N godzin w przód, włącznie, na przykład 24. Łączone z pozostałymi włączonymi filtrami dat.
Ustaw 1, aby wybrać loty bez daty sprzedaży. Zastępuje sale_date_from, sale_date_to i sale_date_in_days.
Obecne ograniczenie implementacji: wbrew nazwie 1 wybiera loty bez daty sprzedaży lub z datą sprzedaży wcześniejszą niż teraz, więc nie wyklucza zakończonych aukcji. Pomiń lub użyj 0; dla okna nadchodzących aukcji użyj next_hours_auction.