Предроверка наличия данных по VIN — API иностранные отчеты и аукционы
Описание API
Проверка наличия данных по VIN — API зарубежных отчётов
AvtoVinCod /vin-precheck помогает определить, по каким зарубежным базам есть сведения об автомобиле, ещё до заказа полного отчёта. Результат можно показать клиенту в CRM, на сайте или в приложении и предложить только доступные проверки.
Какие источники проверяются
- История США и Канады: CARFAX и AutoCheck.
- Аукционные продажи и лоты США и Кореи.
- VinHistory: фотоистория с зарубежных аукционов.
- История автомобиля в Беларуси.
- Аукционы Европы: доступность и сведения о лотах.
Для каждого доступного источника возвращаются признак наличия сведений, число записей (если известно) и метод заказа полного отчёта.
Метод API
GET /vin-precheck — поиск по VIN (17 символов). Ответ обычно за 3–15 секунд в JSON.
Параметр method позволяет проверить доступность одного отчёта. Параметр items ограничивает список проверяемых блоков.
Поля ответа: found, vehicle, items[].available, items[].records, items[].apis, checked_at.
available: true — данные есть; false — нет; null — источник не ответил. Доступные блоки зависят от подключённых методов аккаунта.
Для бизнеса
- Импортёры и автосалоны: заранее выяснить, какие зарубежные отчёты имеет смысл заказать.
- Маркетплейсы: показать наличие истории по VIN до оплаты клиентом.
- Банки и лизинг: отобрать подходящие источники автомобильных данных.
- Разработчики: построить выбор отчётов и автоматическую маршрутизацию запросов.
Подключение и оплата
HTTPS, REST API, JSON, Bearer-токен; есть бесплатный тестовый VIN.
Проверка платная даже при отсутствии данных, если ответил хотя бы один источник. Ошибки и полная недоступность источников не тарифицируются. Метод определяет наличие записей, но не заменяет полный отчёт.
Документация: https://avtovincod.ru/docs/vin-precheck/
Характеристики
Документация
Документация API предварительной проверки VIN:
https://avtovincod.ru/docs/vin-precheck/
Метод: GET https://api.avtovincod.ru/vin-precheck
Параметры:
vin — VIN автомобиля, 17 символов;
method — необязательный код отчёта для проверки одного направления;
items — необязательный список проверяемых блоков через запятую.
Примеры:
method=usa_history — история США и Канады;
method=auction_lots — аукционные лоты;
items=usa_history,usa_photos — проверка выбранных источников.
Авторизация: Authorization: Bearer API_TOKEN.
Формат ответа: JSON.
Обычное время ответа: 3–15 секунд.
Основные поля: success, found, vehicle, items, checked_at, billing.
Значения items[].available: true, false или null.
Бесплатный тестовый VIN: X7TEST00000000001.
Документация содержит примеры интеграции на PHP, Python, JavaScript, Go, Java, C#, Ruby и 1С.
Стоимость
Оплата за выполненную предварительную проверку, даже если данных по VIN нет. Одно списание за запрос, если ответил хотя бы один источник. Технические ошибки и полная недоступность источников бесплатны. Без абонентской платы и обязательных пакетов; оплата картой или по счёту.