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

}