Комплексная проверка автомобиля по VIN и госномеру — REST API
Описание API
Комплексная проверка автомобиля — REST API
AvtoVinCod /report собирает автомобильные данные из нескольких источников в одном отчёте по VIN, госномеру или номеру кузова. Вместо последовательных обращений к отдельным API система сама организует проверки и возвращает общий JSON-ответ.
Что можно включить в отчёт
- ГИБДД: история регистрации, ограничения и розыск.
- Залоги ФНП, лизинг, судебные дела.
- ДТП, европротоколы, скрытые повреждения.
- Пробеги, техосмотры, ОСАГО, ЭПТС.
- Фото автомобиля, история объявлений, такси и каршеринг.
- Другие подключённые методы AvtoVinCod.
Состав зависит от выбранных блоков и доступных клиенту методов.
Как работает API
POST /report — запуск проверки. Передайте vin, plate или body и список blocks. Если блоку нужен VIN, а передан только госномер, сервис может определить VIN автоматически. Дополнительный блок определения тарифицируется по своему тарифу.
Готовые наборы: full, quick, vehicle, legal, history. Можно сохранять собственные шаблоны.
GET /report?id=... — получение результата, если проверка ещё выполняется. Поддерживаются уведомления вебхуком о готовности.
Контроль расходов
dry_run=1— предварительная смета без списаний.max_cost— максимальный бюджет отчёта.Idempotency-Key— защита от повторного запуска и списания.- Статусы каждого блока: выполнен, ожидает, ошибка или пропущен.
Для бизнеса
- Банки и лизинг: комплексная проверка перед финансированием.
- Автосалоны: автоматизация проверки перед выкупом.
- Страховые и автопарки: единый сценарий получения данных.
- Разработчики: быстрый запуск отчётов в CRM и приложениях.
Сам /report бесплатный. Оплата только за выполненные блоки по тарифам соответствующих методов; правила оплаты пустых результатов различаются.
Документация: https://avtovincod.ru/docs/report/
Характеристики
Документация
Документация комплексной проверки автомобиля:
https://avtovincod.ru/docs/report/
Запуск:
POST https://api.avtovincod.ru/report
Получение результата:
GET https://api.avtovincod.ru/report?id={REPORT_ID}
Основные параметры:
vin, plate, body — идентификаторы автомобиля;
blocks — список проверок;
preset — готовый набор;
template — сохранённый шаблон;
max_cost — лимит расходов;
dry_run=1 — предварительная смета без списаний;
wait — время ожидания ответа.
Авторизация: Authorization: Bearer API_TOKEN.
Защита от повторов: Idempotency-Key.
Формат ответа: JSON.
Готовые наборы: full, quick, vehicle, legal, history.
Поддерживается вебхук report.done.
Бесплатные тестовые значения:
VIN: X7TEST00000000001
Госномер: Т000ТТ00.
Подробная техническая документация, примеры JSON, PHP, Python и JavaScript доступны также в личном кабинете: «Доступные API» → «Сводный отчёт» → «Документация».
Стоимость
Сам метод /report бесплатный: оплачиваются только запущенные и выполненные блоки по их тарифам. Ошибки и пропущенные блоки не тарифицируются. Смета до запуска (dry_run), ограничение расходов (max_cost), защита от повторного списания. Без подписки и обязательных пакетов.