GET/carsEksport

Eksportuj pojazdy za pomocą kursora

Strumieniuj wszystkie aktywne samochody z Twoich źródeł, z pełnymi raportami, przez kursor po stronie serwera. Stworzone do synchronizowania lokalnej kopii.

Zacznij bez scroll_id, a potem żądaj każdego next_url bez zmian, aż scroll_id będzie null. Zobacz przewodnik po synchronizacji.
limit wynosi 1–2000 (domyślnie 500). scroll_time wynosi 1–15 minut (domyślnie 10).
Nie zmieniaj domains[] i is_leasing przez cały przebieg. Ich zmiana zwraca 422.
total może być null, jeśli jego wpis w cache został utracony.

Parametry zapytania

limitinteger1–2,000 · default 500

Liczba elementów w partii. Domyślnie 500; maksimum 2000. Użyteczny eksport wymaga wartości dodatnich.

scroll_timeinteger1–15 · default 10

Czas życia kursora w minutach. Domyślnie 10, maksimum 15.

scroll_idstring

Nieprzezroczysty kursor z poprzedniej odpowiedzi. Zalecane jest podążanie za next_url.

domains[]integer[]≥ 1

Opcjonalny zakres źródeł. Używaj ID zwracanych przez GET /domains. Pomiń, aby użyć wszystkich włączonych domen. Powtarzaj parametr z nawiasami: domains[]=33&domains[]=34. Każde ID musi być włączone dla tego klucza.

is_leasingboolean

Opcjonalny filtr leasingu. Wyślij true (lub 1) dla ogłoszeń jawnie oznaczonych is_leasing=true. Wyślij false (lub 0), aby wykluczyć true, w tym zapisane false, null i brakujące pola. Pomiń, aby nie filtrować po leasingu; puste lub nieprawidłowe wartości zwracają 422. Samochód musi mieć co najmniej jedno pasujące aktywne ogłoszenie we włączonym/wybranym zakresie domen. Inne ogłoszenia mogą pozostać w odpowiedzi, więc samochody z mieszanymi typami ogłoszeń mogą pasować do obu wartości. W /cars ustaw ten filtr w pierwszym żądaniu i podążaj za next_url bez zmian; false jest zachowywane. Kontynuacja z samym scroll_id zachowuje filtr. Zmiana lub dodanie filtra w trakcie przewijania zwraca 422. Jeśli zapisany w cache stan filtra został utracony lub przewijanie powstało przed wprowadzeniem tego parametru, jawna wartość zwraca 422; rozpocznij nowe przewijanie.

langstring

Język odpowiedzi. Tłumaczenia opcji są dodatkowo ograniczone do języków konta. Strona automatycznie wybiera bieżący język.

Zwraca · Partia pełnych obiektów Car w data, z next_url, scroll_id i total. Ostatnia strona ma scroll_id: null, puste data i message: "No more data".

GET/cars

curl -g "https://api.lotarius.com/cars?limit=5&api_key=$CARS_API_KEY" \
  -H "Accept: application/json"

PrzykładyNagrane

{4 keys

"data": [1 item

0: {20 keys

"id": "290nw54Bkl-iPxZqEe_N"

"has_inspections": false

"has_history_reports": false

"year": 2007

"vin": "kmhdu46d27u158653"

"brand": {2 keys

}

"model": {2 keys

}

"engine_volume": 2000

"cylinders": 4

"body_type": {2 keys

}

"fuel": {2 keys

}

"color": {2 keys

}

"power_hp": 138

"market_origin": {2 keys

}

"drive_wheels": {2 keys

}

"option_ids": []

"listings": [1 item

]

"inspections": []

"vehicle_history_reports": []

"hash": "473326c69c007f50506c0cffdf30b08cf28e978d9ff2d5e7dca0dc75a54a3f6c"

}

]

"next_url": "https://api.lotarius.com/cars?scroll_id=FGluY2x1ZGVfY29udGV4dF91…&lang=en&api_key=YOUR_API_KEY&limit=2"

"scroll_id": "FGluY2x1ZGVfY29udGV4dF91…"

"total": 3217391

}