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

}