Массовая проверка автомобилей по VIN и госномеру — Batch API
Описание API
Массовая проверка автомобилей — Batch API
AvtoVinCod /batch позволяет проверить список автомобилей одним запросом. Вместо ручного запуска отдельных проверок отправьте VIN, госномера или номера кузова и выберите необходимые источники.
Возможности пакетной проверки
- Проверка залогов, ограничений ГИБДД, розыска, такси и других доступных методов.
- Автоматическое определение VIN по госномеру, если он нужен для выбранного источника.
- Исключение повторяющихся автомобилей и сохранение меток из вашей системы.
- Предварительная смета и ограничение максимальных расходов.
- Асинхронная обработка без ожидания открытого соединения.
- Получение результатов в JSON или уведомление о готовности через вебхук
batch.done.
Методы API
POST /batch — создать пакет. Передайте items[] (список машин) и checks[] (коды проверок).
GET /batch?id=... — получить статус queued, running, paused или done.
GET /batch?id=...&rows=1 — получить результаты по автомобилям. data=full добавляет полные ответы отдельных проверок.
Контроль бюджета
dry_run=1— расчёт сметы без запуска и списаний.max_cost— предельная стоимость пакета.fit=1— проверить столько машин, на сколько хватает баланса.Idempotency-Key— защита от создания дублирующего пакета.
Для бизнеса
- Автопарки и логистика: проверка парка автомобилей по списку.
- Банки, лизинг, автоломбарды: массовая оценка юридических рисков.
- Автосалоны: проверка входящего потока автомобилей.
- Разработчики: подключение пакетных проверок к CRM и ERP.
Сам /batch бесплатный. Оплачиваются выполненные проверки по тарифам выбранных методов, включая платные пустые результаты у некоторых источников. Дополнительное определение VIN тарифицируется отдельно.
Документация: https://avtovincod.ru/docs/batch/
Характеристики
Документация
Документация массовой проверки автомобилей:
https://avtovincod.ru/docs/batch/
Создание пакета:
POST https://api.avtovincod.ru/batch
Получение статуса и результатов:
GET https://api.avtovincod.ru/batch?id={BATCH_ID}
GET https://api.avtovincod.ru/batch?id={BATCH_ID}&rows=1
Основные параметры:
items — массив VIN, госномеров, номеров кузова или объектов с данными ТС;
checks — список проверок;
name — название пакета;
dry_run=1 — предварительная смета;
max_cost — лимит стоимости;
fit=1 — выполнение в пределах доступного баланса.
Авторизация: Authorization: Bearer API_TOKEN.
Формат запроса и ответа: JSON.
Вебхук: batch.done.
Защита от дублей: Idempotency-Key.
Метод возвращает ID пакета, статус, смету и результаты проверок.
Лимиты количества автомобилей зависят от аккаунта и доступны через GET /batch.
Документация содержит примеры запросов, JSON-ответов, обработку ошибок и правила тарификации.
Стоимость
Сам /batch бесплатный. Оплачиваются только выполненные проверки по тарифам выбранных методов; некоторые пустые результаты платные. Смета и лимит расходов до запуска, ошибки не списываются. Без подписки и обязательных пакетов. Пополнение картой или по счёту.