Главная → Блог → Как проверить автомобиль по VIN и госномеру через API: сквозной сценарий для бизнеса

Как проверить автомобиль по VIN и госномеру через API: сквозной сценарий для бизнеса

23 октября 2026 · Редакция AvtoVinCod · 8 мин чтения

Чтобы автоматизировать проверку, принимайте от пользователя любой идентификатор (VIN, госномер, номер кузова), приводите его к одному VIN и запускайте цепочку методов: от дешёвой карточки (/brief, 1 ₽) к реестровым проверкам (/score, /pledge, /fines) и только потом к дорогим (история, ДТП). Все вызовы идут через один Bearer-токен, оплата только за выполненные проверки, а отладка на тестовых значениях бесплатна. Дальше - общая архитектура "вход, нормализация, каскад, решение". Детали по отдельным задачам вынесены в профильные материалы.

Что значит "проверить авто по номеру" в системе бизнеса

Менеджер говорит "проверь машину по номеру" и имеет в виду что угодно: госномер с таблички, VIN из ПТС, номер кузова японского авто, у которого VIN в привычном виде нет. Для системы это три разных входа, и каждый надо довести до одного рабочего ключа. Проще всего - до VIN, потому что большинство методов принимают именно его.

Ручная проверка заканчивается словами "вроде нормально". Автоматическая - единым JSON и решением по правилам: залог активен, значит стоп; розыск, значит стоп; штрафов на 40 000 ₽, значит на ручную проверку. Глазами так не получится, когда в день проходит 300 заявок.

Сценарий подходит автосалонам, выкупу и трейд-ину, лизингу, страховым, маркетплейсам и доскам объявлений, автопаркам. Эта статья - каркас. Если нужно углубиться, есть разборы: сборка полного отчёта по VIN, проверка по госномеру для автосалона и площадки, проверка ограничений ГИБДД через API и общий обзор: интеграция API ГИБДД для бизнеса.

Шаг 1. Нормализация входа и получение VIN

Сначала валидация на своей стороне, до любых платных запросов. VIN - 17 символов, без букв I, O, Q. Госномер приводите к одному регистру и одной раскладке: пользователи вводят и "Т000ТТ00" кириллицей, и "T000TT00" латиницей, а иногда смесь. Храните в кириллице, в запросе подставляйте как есть, сервис принимает оба варианта тестового номера. Лишние пробелы и дефисы вычищайте сразу.

Дальше по типу входа:

• Госномер: метод VIN по госномеру, GET /gos2vin?plate=, 8 ₽. В ответе VIN или номер кузова/шасси, СТС, марка, модель, год, мощность, признак такси. Как встроить это в учётную систему, описано в материале VIN по госномеру в CRM.
• VIN, а нужен госномер: GET /vin2gos?vin=, 6 ₽.
• Номер кузова: методы /body, /score-body, /pledge?body=, /probeg?body=. Номер двигателя по VIN, кузову или шасси даёт /autopark за 0,8 ₽, причём платно только если номер найден.

Отдельно про подмену. Если машина "переехала" с одного номера на другой, это повод присмотреться. История госномеров (/plate-history?vin=, 1,5 ₽) возвращает список номеров от последнего к первому, без дат. Платно только при found >= 2: один номер или ни одного - бесплатно.

И последний фильтр этого шага - /decode?vin= (1,6 ₽). Он показывает, что зашифровано в VIN: модель, поколение, кузов, двигатель, страну и завод. Если клиент заявил Camry, а VIN расшифровывается как совсем другая модель, дальше можно не идти. Поле full=1 говорит, что определена единственная модификация.

Шаг 2. Дешёвый первый фильтр: /brief за 1 ₽

Краткие данные ТС - марка, модель, год, мощность, тип и объём двигателя, руль, масса. Это карточка за рубль, и она нужна не для красоты, а как предохранитель. Сверяем с тем, что заявил клиент или указано в объявлении. Расхождение по марке, году или мощности останавливает каскад: тратить 40 ₽ на реестры по машине, которая не та, за кого себя выдаёт, бессмысленно.

curl -H "Authorization: Bearer $TOKEN" \
 "https://api.avtovincod.ru/brief?vin=X7TEST00000000001"

Ответ приходит в JSON с полем success и данными по машине. Для сверки достаточно взять марку, модель, год и мощность и сравнить с входными данными по допуску: год - точно, мощность - с небольшим разбросом, потому что в документах и каталогах она иногда округляется по-разному.

Шаг 3. Каскад проверок по риску

Порядок такой: сначала то, что с наибольшей вероятностью убьёт сделку, и по приемлемой цене. Потом всё остальное.

Стоп-факторы

Ограничения и розыск (Score): запреты на регистрационные действия, розыск, периоды владения, 20 ₽. Смотрите поле found: 1 - данные есть, 0 - VIN не найден в базе ГИБДД. Следом /pledge (2,4 ₽): status и active_count покажут, действует ли залог. Для арбитражных споров, лизинговых и банкротных дел есть /lawsuits (3 ₽). Если в ограничениях пришёл enforcement_number, передайте его в /enforcement?number= (0,65 ₽) и узнайте, что за долг стоит за запретом и сколько осталось платить.

Пробег и состояние

/probeg (3,5 ₽) даёт диагностические карты ЕАИСТО с зафиксированным пробегом. /osago-history (1,5 ₽) - все полисы за годы, цель использования, ограничение по водителям. /offers (1,5 ₽) - прошлые объявления с ценой и пробегом, где у каждого есть поле match (vin, car или unknown). Сверка пробега по трём источникам быстро выявляет скрутку. По ДТП два пути: /accidents (0,8 ₽) - архивные данные, и /accidents-rt (19 ₽) - происшествия по базе ГИБДД с 2015 года. Второй метод асинхронный: создаёте задачу, потом опрашиваете раз в 30 секунд, до 40 минут.

Происхождение и использование

/customs (1 ₽) - ввозилась ли машина из-за рубежа, /elpts (1 ₽) - электронный ПТС и таможенные ограничения, /taxi (1,8 ₽), /sharing (5,4 ₽), /lizing (2,2 ₽). Такси и каршеринг для выкупа - это сильное снижение цены, лизинг - вопрос о том, кто вправе продавать.

Наборы по ролям

Это отправная точка, не догма: у каждого бизнеса свои пороги и свой аппетит к риску.

Параллельность и таймауты

Независимые методы гоняйте параллельно, но только внутри одного уровня каскада. Если /score вернул розыск, запросы к /osago-history уже не нужны. Ставьте разные таймауты: быстрые реестровые - секунд 10-15, /osago-history - минимум 60 секунд, потому что ответ обычно приходит за 15-60 с. Для /accidents-rt нужен отдельный воркер с опросом.

Шаг 4. Разбор ответа: success, found и биллинг

Правила простые. success: 1 - проверка выполнена, и она тарифицируется. success: 0 - не выполнена или данных нет, бесплатно. Нюанс, на котором спотыкаются: реестровые проверки (такси, залоги, штрафы, ЭПТС, техосмотр) и /score списываются при выполненной проверке, даже если записей нет (found: 0). Чистый залог - это тоже результат, за него платите.

В каждом ответе, записанном в историю запросов, есть блок billing: charged, currency, billed, balance, requestId. Дублируют его заголовки X-Charged, X-Balance и X-Request-Id. Логируйте их рядом с вашим идентификатором заявки: при сверке с актом это сэкономит часы. Нет блока billing - запрос не списан.

Как отличить "данных нет" от "сбоя источника": сбой даёт success: 0 и не тарифицируется, поэтому повторять можно, обычно с паузой и ограничением числа попыток (две-три). "Данных нет" при success: 1 и found: 0 - это ответ по существу, его повторять бессмысленно и платно.

Матрица решений

Шаг 5. Тест, подключение и расчёт стоимости

Все методы отлаживаются на тестовых значениях: VIN X7TEST00000000001, госномер Т000ТТ00, номер кузова TEST-0000001. Любой метод отвечает образцом по своей схеме, бесплатно, с полем "testMode": true. Токен нужен и для тестов.

Подключение без договора: регистрация в личном кабинете, токен сразу, пополнение картой от 100 ₽. Депозит действует 90 дней. Юрлицам доступна оплата по счёту, в конце месяца - акт и акт сверки.

Считаем типовой отчёт для салона: brief (1) + score (20) + pledge (2,4) + fines (0,9) + probeg (3,5) + osago (1,5) = 29,3 ₽. Если вход был госномером, добавьте 8 ₽ за /gos2vin, итого 37,3 ₽. А если на brief расхождение, расход составит те самые 1 ₽ (плюс 8 ₽ за VIN). Актуальные цены берите из prices.json, а не из статьи.

Примеры кода на cURL, PHP, Python, JavaScript, Go, Java, C#, Ruby и 1С есть на странице каждого метода в документации API, уже с тестовыми значениями. Если вы строите ИИ-агента, подключите MCP-сервер: https://api.avtovincod.ru/mcp, авторизация тем же Bearer-токеном, 32 инструмента, вызов тарифицируется как запрос к методу.

Шаг 6. Когда не писать код

Если нужно прогнать список, а не встроить проверку в продукт, код не обязателен. Массовая проверка в кабинете: до 100 машин из Excel, CSV или вставкой текста, выбор проверок и расчёт "не больше" до запуска. На выходе таблица, отчёт по каждой машине и Excel. Готовность придёт на почту и в Telegram.

Когда нужна не разовая проверка, а регулярный контроль, подключайте мониторинг автомобилей. Список машин проверяется по данным реестров (это не GPS), а сообщения приходят только об изменениях: новый штраф, залог, запрет, смена собственника или госномера, окончание ОСАГО. Каналы: Telegram, почта и вебхук. Вебхук - POST с JSON и подписью X-AVC-Signature: sha256=HMAC тела вашим секретом. Проверяйте подпись, прежде чем принимать событие monitor.change. Для лизингового портфеля или автопарка это заметно удобнее, чем гонять проверки раз в месяц вручную.

Типичные ошибки интеграции

Дорогие методы раньше дешёвых. Запустили /score за 20 ₽ до /brief за 1 ₽ и платите за машины, которые не прошли бы по базовой сверке.

Нет кэша в рамках сессии. Менеджер обновил страницу, и тот же VIN прогнался заново. Сохраняйте результат по связке "VIN + метод" на разумное время.

Нет обработки асинхронного /accidents-rt. Ждать ответ синхронно нельзя: нужны задача и опрос раз в 30 секунд.

Путаница VIN, номера кузова и СТС. Номер кузова уходит в ?vin=, СТС - в параметр госномера. Для штрафов нужен sts, для залогов - vin, body или chassis. Заведите в коде три разных типа идентификатора и не смешивайте строки.

Токен на клиенте. Если он лежит в мобильном приложении или в JS на странице, его вытащат. Все вызовы - через ваш бэкенд.

Читайте также

Бот для проверки авто в Telegram на API: за вечер

Проверить техосмотр по базе ЕАИСТО через API: гос номер и VIN

Проверить обременение на автомобиль: залог через API ФНП