GET/carsЕкспорт

Експорт автомобілів через курсор

Отримуйте потоком усі активні автомобілі ваших джерел із повними звітами через серверний курсор. Призначено для синхронізації локальної копії.

Почніть без scroll_id, потім запитуйте кожен next_url без змін, доки scroll_id не стане null. Див. посібник із синхронізації.
limit — від 1 до 2,000 (за замовчуванням 500). scroll_time — від 1 до 15 хвилин (за замовчуванням 10).
Не змінюйте domains[] і is_leasing протягом усього проходу. Їх зміна повертає 422.
total може бути null, якщо його запис у кеші втрачено.

Параметри запиту

limitinteger1–2,000 · default 500

Кількість елементів у пакеті. За замовчуванням 500; максимум 2000. Для робочого експорту потрібні додатні значення.

scroll_timeinteger1–15 · default 10

Термін дії курсора в хвилинах. За замовчуванням 10, максимум 15.

scroll_idstring

Непрозорий курсор із попередньої відповіді. Краще переходити за next_url.

domains[]integer[]≥ 1

Необов'язковий набір джерел. Використовуйте ID, які повертає GET /domains. Не передавайте, щоб використати всі увімкнені домени. Повторюйте параметр із квадратними дужками: domains[]=33&domains[]=34. Кожен ID має бути ввімкнений для цього ключа.

is_leasingboolean

Необов'язковий фільтр лізингу. Надсилайте true (або 1) для оголошень, явно позначених is_leasing=true. Надсилайте false (або 0), щоб виключити true, включно зі збереженими false, null і відсутніми полями. Не передавайте, щоб не фільтрувати за лізингом; порожні або недійсні значення повертають 422. Автомобіль повинен мати принаймні одне відповідне активне оголошення в межах увімкнених/обраних доменів. Інші оголошення можуть залишатися у відповіді, тож автомобілі зі змішаними типами оголошень можуть відповідати обом значенням. Для /cars задайте його в першому запиті й переходьте за next_url без змін; false зберігається. Продовження лише зі scroll_id зберігає фільтр. Зміна або додавання фільтра посеред прокручування повертає 422. Якщо кешований стан фільтра втрачено або прокручування почалося до появи цього параметра, явне значення повертає 422; почніть нове прокручування.

langstring

Локаль відповіді. Переклади опцій також обмежено мовами акаунта. Сторінка автоматично обирає поточну мову.

Повертає · Пакет повних об'єктів Car у data із next_url, scroll_id і total. Остання сторінка має scroll_id: null, порожній data і message: "No more data".

GET/cars

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

ПрикладиЗаписано

{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

}