История автомобиля в Беларуси по VIN — REST API
Описание API
История автомобиля в Беларуси по VIN — REST API
AvtoVinCod предоставляет проверку истории автомобилей по базам Республики Беларусь. Метод полезен при покупке, ввозе и оценке машин, которые ранее эксплуатировались или регистрировались в Беларуси.
Какие сведения могут быть в отчёте
- Дата ввоза и таможенного оформления.
- История регистрации транспортного средства.
- Техосмотры и зафиксированные пробеги.
- ДТП и страховые случаи.
- Сведения об использовании в такси.
- Продажи на аварийных аукционах.
Полнота отчёта зависит от данных по конкретному VIN.
Метод API
GET /by-history — заказ по VIN (17 символов). API асинхронный: сначала возвращается taskId, затем готовность проверяется запросом с параметром task.
Обычно отчёт формируется примерно за минуту, иногда дольше. Готовый результат — PDF по ссылке в report.files[]. JSON-ответ содержит статус задачи, ссылки на файлы и информацию об оплате, а не расшифрованную историю автомобиля по отдельным полям.
Ссылки на отчёт действуют 90 дней.
Для бизнеса
- Автосалоны и импортёры: проверка истории машин, ввезённых из Беларуси.
- Банки и лизинг: дополнительные сведения для оценки автомобиля.
- Страховые компании: анализ прежней эксплуатации ТС.
- Разработчики: автоматический заказ отчётов из CRM и клиентских сервисов.
Подключение и оплата
REST API, HTTPS, Bearer-токен, JSON. API-ключ после регистрации; предусмотрен бесплатный тестовый VIN.
Оплата только за готовый PDF-отчёт. Заказ и проверка статуса бесплатны. Если данных нет или возникла ошибка, списания нет. Без обязательных пакетов и подписки.
Документация: https://avtovincod.ru/docs/by-history/
Характеристики
Документация
История автомобиля в Беларуси:
https://avtovincod.ru/docs/by-history/
Метод: GET https://api.avtovincod.ru/by-history
Параметры:
vin — VIN автомобиля, 17 символов;
task — идентификатор задачи для проверки готовности;
brand — необязательная марка автомобиля.
Авторизация: Authorization: Bearer API_TOKEN.
Формат ответа API: JSON.
При заказе: status: processing, taskId, pollAfterSec.
При готовности: status: done, report.files, report.files_until, billing.
Результат: PDF-отчёт по ссылке.
Срок хранения файла: 90 дней.
Бесплатный тестовый VIN: X7TEST00000000001.
Для заказа рекомендуется таймаут HTTP-клиента не менее 60 секунд. Проверять готовность следует с интервалом pollAfterSec.
Документация содержит примеры интеграции и условия тарификации.
Стоимость
Оплата только за сформированный отчёт по Беларуси. Заказ и проверка готовности бесплатны. Если данных по VIN нет, источник недоступен или отчёт не сформирован, списания нет. Без абонентской платы и обязательных пакетов. Пополнение картой или по счёту.