Главная → Блог → Расшифровка VIN через API: марка, модель, модификация и комплектация для каталога и карточки авто

Расшифровка VIN через API: марка, модель, модификация и комплектация для каталога и карточки авто

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

Расшифровать VIN онлайн из своей системы можно одним запросом GET /decode?vin= к API AvtoVinCod: в JSON вернутся модель, поколение, кузов, двигатель, коробка, привод, годы выпуска, страна и завод. Поле full=1 означает, что определена единственная модификация, и по ней можно безопасно подбирать детали. Запрос стоит 1,6 ₽, на тестовом VIN X7TEST00000000001 он бесплатен.

Дальше - что именно вы получите, как разобрать ответ и где у этой расшифровки граница, чтобы не обещать клиентам лишнего.

Что реально можно получить по VIN, а что нет

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

Модификация и комплектация: где граница

Метод /decode отдаёт то, что нужно для идентификации машины: модель, поколение, кузов, двигатель, коробку передач, привод, годы выпуска, страну и завод сборки. Этого хватает для карточки в каталоге, для фильтра запчастей и для сверки с объявлением.

Чего мы не обещаем: заводской список опций в стиле дилерского каталога BMW, где по VIN видны цвет салона, пакеты, подушки, тип фар и прочее. Комплектацию в таком смысле decode не возвращает. Если вашему бизнесу нужно именно это, закладывайте в процесс уточнение у клиента или осмотр.

Почему бесплатные декодеры в вебе не годятся для автоматизации

Бесплатные формы расшифровки хороши, чтобы разово посмотреть одну машину. Для системы они плохи по нескольким причинам: у них нет стабильного формата ответа, нет гарантии доступности, а результат по одному и тому же VIN в разных сервисах может отличаться - у кого-то только страна и год, у кого-то модель без поколения. Парсить страницы такого сайта значит завязать каталог на вёрстку чужого ресурса. Для автоматизации нужен API с понятной схемой, токеном и предсказуемой ценой.

Метод /decode: запрос и разбор ответа

Авторизация - Bearer-токен, хост api.avtovincod.ru. Токен выдаётся сразу после регистрации в кабинете. Полное описание полей есть в документации метода /decode.

Пример на cURL с тестовым VIN:

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
 "https://api.avtovincod.ru/decode?vin=X7TEST00000000001"

То же на Python:

import requests

r = requests.get(
 "https://api.avtovincod.ru/decode",
 params={"vin": "X7TEST00000000001"},
 headers={"Authorization": "Bearer ВАШ_ТОКЕН"},
 timeout=30,
)
data = r.json()
if data.get("success") == 1:
 print(data.get("full"), data)

Что смотреть в ответе. Первым делом - success. Значение 1 означает, что проверка выполнена и тарифицируется, 0 - что проверка не выполнена или данных нет, и тогда вы ничего не платите. Дальше идут поля с моделью, поколением, кузовом, двигателем, коробкой, приводом, годами выпуска, страной и заводом сборки. Точные имена ключей сверяйте со схемой в документации и с ответом на тестовом VIN: он возвращает образец по реальной схеме с полем "testMode": true.

Стоимость видна в самом ответе: блок billing содержит charged, currency, billed, balance и requestId, а заголовки X-Charged, X-Balance и X-Request-Id дублируют эти значения. Если блока billing нет, запрос не списан. Удобно логировать X-Request-Id: при разборе спорного случая поддержке достаточно этого номера.

Поле full=1: когда доверять модификации

Логика простая. full=1 - определена единственная модификация. Любое другое значение - вариантов несколько, и выбирать между ними должен человек (или ваш следующий шаг), а не код наугад.

Для каталога запчастей схема такая:

1. Отправляем VIN в /decode.
2. Если success=1 и full=1 - фильтруем каталог по модификации автоматически, без вопросов клиенту.
3. Если success=1, но full не равен 1 - показываем то, что определено (модель, поколение, кузов), и задаём уточняющие вопросы: объём двигателя, коробка, привод, год. Список вариантов ограничен тем, что вернул decode, так что вопросов будет два-три, а не десять.
4. Если success=0 - просим проверить VIN или предлагаем подбор по марке и модели вручную. Платить за этот запрос не пришлось.

Так вы не показываете покупателю тормозные колодки "под его машину", когда машина на самом деле с другим мотором. Возврат запчасти стоит дороже, чем лишний вопрос на форме.

Группы брендов и неполный ответ

Концерны кодируют VIN по-разному: VAG (Volkswagen, Skoda), Toyota, Hyundai и Kia, Volvo, BMW. Полнота определения у разных марок и поколений может отличаться, и это нормально. Мы не будем рисовать таблицу "у этой марки всегда full=1, у той никогда": такие обещания разваливаются на первой же редкой модели. Практическое правило одно для всех брендов: смотрите на поле full в конкретном ответе. Единственная модификация - работаем автоматически. Нет - уточняем. Поведение в коде не зависит от марки, и это хорошо: меньше веток, меньше багов.

Сценарии для бизнеса

Каталог запчастей и интернет-магазин. Поле "Введите VIN" в шапке каталога, после него фильтр по модификации. Подробно, с архитектурой и примерами, мы разбирали это в статье про поиск запчастей по VIN в интернет-магазине.

Автосалон, трейд-ин и выкуп. Менеджер вводит только VIN, а модель, поколение, кузов, мотор, коробка и привод подставляются в карточку сами. Меньше ручного ввода - меньше опечаток вроде "2.0 дизель" вместо бензина. Как это выглядит в интерфейсе, описано в материале про автозаполнение карточки авто по VIN.

Маркетплейс и доска объявлений. Продавец пишет в объявлении "Octavia, 1.8 TSI, автомат", вы сравниваете это с ответом decode. Расходится модель или тип двигателя - объявление уходит на модерацию или получает пометку. Для площадки это недорогой фильтр против подмен и ошибок.

Автопарк и лизинг. В справочниках парков годами копится мусор: "Камри", "Toyota Camry", "камри 3.5". Прогоните VIN парка через /decode и приведите марку, модель и модификацию к единому виду. Для списка в сотни машин удобна массовая проверка списка машин в кабинете (до 100 автомобилей за раз), а для тысяч - обычный цикл по API с одним токеном.

Связка с другими методами

Decode отвечает на вопрос "что это за машина по заводской кодировке". Остальные методы закрывают соседние задачи.

• /brief - краткие данные ТС: марка, модель, год, мощность, тип и объём двигателя, руль, масса. Быстрая карточка до полного отчёта, принимает VIN или госномер.
• /autopark - номер двигателя по VIN; ответ за доли секунды, платно только если номер найден.
• /gos2vin - VIN по госномеру, если клиент знает только номер. Дальше VIN идёт в /decode. Обратное направление - /vin2gos.
• /pros-cons - плюсы и минусы модели: надёжность, кузов и коррозия, ликвидность, списки сильных и слабых сторон. Готовый текст для описания модели на странице.
• /vin (история регистрации ГИБДД) - периоды владения, характеристики ТС, ПТС и СТС.

Как сверять decode с данными ГИБДД

Это самая полезная связка для карточки. Decode показывает, что машина должна быть по заводской кодировке. История регистрации показывает, что записано в учёте. Сравните ключевые параметры: модель, год выпуска, мощность, тип двигателя. Расходится мощность - возможна ошибка при постановке на учёт или изменение конструкции. Расходится модель или год - повод проверить документы и сам VIN на кузове. Расхождение не приговор, но флаг для менеджера, которого стоит поднять до сделки, а не после. Важно: это сверка двух источников, а не вывод "машина перебита". Решает всегда человек.

Стоимость, тест и подключение

Базовые цены за запрос: decode 1,6 ₽, brief 1 ₽, autopark 0,8 ₽, pros-cons 0,8 ₽. Актуальные значения публикуются в prices.json.

Пример расчёта на 10 000 карточек. Только decode: 10 000 × 1,6 = 16 000 ₽. Decode плюс brief: 10 000 × (1,6 + 1) = 26 000 ₽. Если добавить номер двигателя через /autopark и учесть, что платно только найденные номера, верхняя граница - 34 000 ₽. Не списываются запросы с success: 0, поэтому реальная сумма обычно ниже расчётной.

Подключение без договора: регистрация в личном кабинете за минуту, токен сразу, пополнение от 100 ₽ банковской картой (юрлица - по счёту, с актами). Бесплатного пробного периода нет, но есть тестовые значения: VIN X7TEST00000000001 отвечает образцом по схеме метода бесплатно и без пополнения, нужен только токен. Депозит действует 90 дней.

Два совета по экономии. Первый: кэшируйте результат по VIN у себя. Заводская расшифровка не меняется, и повторять запрос по одному и тому же VIN незачем. Второй: для интеграции в ассистентов и агентов есть MCP-сервер (api.avtovincod.ru/mcp), вызов тарифицируется как обычный запрос к методу.

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

Расшифровка VIN через API: автозаполнение карточки авто

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

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