Ръководство

Синхронизиране на целия инвентар

/cars извлича поточно всички активни автомобили от вашите източници, с пълни доклади, чрез курсор от страна на сървъра. Използвайте го за поддържане на локално копие; използвайте /search само за заявки, насочени към потребителите.

GET /carslimit до 500, без scroll_id

запис на data[]upsert по id, пропуснете, ако hash не е променен

GET next_urlбез промени, преди курсорът да изтече

scroll_id nullобхождането е завършено

архивиранеавтомобили, които не са видени при това обхождане

Започнете обхожданеЗаявете /cars без scroll_id. Задавайте филтри като domains[] или is_leasing само тук.
Следвайте точно next_urlЗапазвайте същия ключ и филтри през цялото обхождане. Промяна на domains[] или is_leasing по време на обхождането връща 422.
Извличайте, преди курсорът да изтечеscroll_time е 1–15 минути (по подразбиране 10), отчитано от последната заявка. При 403/404 със "scroll id was expired" започнете ново обхождане.
Завършете, след това архивирайтеОбхождането приключва, когато scroll_id е null и data е празно. Едва тогава маркирайте невидените автомобили като продадени.

Изпълнявайте пълно обхождане 2–3 пъти на ден. Архивираните автомобили изчезват веднага от /search и /cars, но остават достъпни чрез /cars/{car_id} и /listing/{domain_id}/{listing_id} с archived: true около месец.

Филтър по тип превозно средство и конфигурация

vehicle_type=automobile / 1 е по подразбиране; motorcycle / 2 избира мотоциклети в /search, /search/count и /cars. Използвайте същия тип в речниците.

В /cars типът и цялата йерархия са фиксирани за курсора. Следвайте next_url без промени или подавайте само scroll_id. Редът на еквивалентни филтри може да се промени; нови условия или изрични филтри без кеширано състояние дават 422. Започнете нов курсор. Старите курсори без нови параметри запазват заявката си.

Цикъл за пълен експорт

url="https://api.auctionsapi.com/cars?limit=500&api_key=$CARS_API_KEY"

while [ -n "$url" ]; do
  page=$(curl -sfg "$url" -H "Accept: application/json") || { echo "cursor expired, restart"; exit 1; }
  echo "$page" | jq -c '.data[]' >> cars.ndjson
  url=$(echo "$page" | jq -r '.next_url // empty')
done

Последна страницаНа живо

{
  "scroll_id": null,
  "data": [],
  "total": 3217391,
  "message": "No more data"
}

Вземете достъп до API

Свържете ключа си, за да изпълнявате всяка заявка от тези страници с вашите данни. Още нямате ключ? Поискайте ни демо ключ: същият JSON като в платените планове.

Имам ключ