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

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

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

Госномер в API AvtoVinCod превращается в VIN запросом GET /gos2vin?plate=, а дальше по VIN подтягиваются ограничения, залог, ОСАГО, пробег и история объявлений. Часть методов принимает госномер напрямую (brief, osago, probeg, taxi, offers, nomerogram), поэтому цепочку можно собрать за один-два вызова и встроить в CRM автосалона или форму объявления. Бесплатно можно отладить интеграцию на тестовых значениях (Т000ТТ00); реальные проверки платные от 0,5 ₽ за запрос.

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

Что можно получить по одному госномеру и чего нельзя

Менеджер салона знает про машину только номер: клиент продиктовал его по телефону или прислал фото. Хорошая новость: значительная часть методов принимает именно plate, VIN для них не нужен.

Методы, которые работают напрямую по plate

• /brief - марка, модель, год, мощность, тип и объём двигателя, руль, масса (1 ₽);
• /gos2vin - VIN, номер кузова или шасси, СТС, марка, модель, год, признак такси (8 ₽);
• /osago - полисы, страховая, статус и срок действия (1,5 ₽);
• /probeg - диагностические карты ЕАИСТО и зафиксированный пробег (3,4 ₽);
• /taxi - разрешения на работу в такси (1,8 ₽);
• /sharing - использование в каршеринге (5,4 ₽);
• /offers - история объявлений о продаже (1,5 ₽);
• /nomerogram - фотографии из открытых объявлений (1,7 ₽);
• /lawsuits - арбитражные дела, где упоминается машина (3 ₽);
• /invalid-reg - наличие в реестре инвалидов (1 ₽).

Методы, где нужен VIN

Самое важное для сделки требует VIN: /score (запреты и розыск), /pledge (залог), /gibdd (история регистрации), /elpts, /customs, /recalls, /price, /service, /lizing. Поэтому почти любой серьёзный сценарий начинается с превращения номера в VIN.

Почему "бесплатная проверка по номеру" не подходит для потока

Честно: бесплатных реальных проверок у нас нет. Нет пробного периода и нет бесплатных лимитов. Бесплатно работает только тестовые значения: любой метод отвечает образцом по своей схеме с полем "testMode": true. Для отладки этого хватает, для боевого потока - нет. Зато цены копеечные: самый дорогой элемент цепочки, /score, стоит 20 ₽, остальное - рубли и доли рубля. Для салона, где одна сделка - сотни тысяч, это несравнимые суммы.

Базовая цепочка: госномер, VIN, отчёт

Шаг 1. Получаем VIN

Метод VIN по госномеру возвращает VIN, номер кузова или шасси, СТС, марку, модель, год, мощность и признак такси. Стоит 8 ₽. Эти поля сразу можно класть в карточку клиента в CRM.

curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
 "https://api.avtovincod.ru/gos2vin?plate=Т000ТТ00"

То же на Python:

import requests

API = "https://api.avtovincod.ru"
H = {"Authorization": "Bearer ВАШ_ТОКЕН"}

def get(method, **params):
 r = requests.get(f"{API}/{method}", headers=H, params=params, timeout=90)
 return r.json()

car = get("gos2vin", plate="Т000ТТ00")
if car.get("success") == 1:
 vin = car["vin"] # проверьте точное имя поля в схеме ответа

Имена полей сверяйте со схемой в документации метода: на тестовом значении она видна бесплатно.

Шаг 2. Параллельные вызовы по VIN

Методы независимы друг от друга, так что после получения VIN запускайте их одновременно: score, pledge, lizing, lawsuits, price. Общее время ответа определяется самым медленным, а не суммой. Исключения - /osago-history (обычно 15-60 секунд) и асинхронный /accidents-rt, о них ниже.

Ошибки и повторы

Ответ с success: 1 - проверка выполнена и тарифицируется. success: 0 - проверка не выполнена или данных нет, это бесплатно. Коды ошибок: 400 - неверный формат (например, латиница и кириллица перепутаны в номере), 401 - токен, 402 - не хватает баланса, 403 - доступ или IP, 429 - лимиты, 503 - источник недоступен. Ошибки и сбои источника не списываются, поэтому на 503 можно спокойно повторять запрос с паузой в несколько секунд. На 400 повторять бессмысленно, на 402 - нужно сигналить в мониторинг: поток встал из-за баланса.

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

Сценарий автосалона: оценка при выкупе и трейд-ине

Клиент звонит: "хочу сдать машину в трейд-ин, номер такой-то". Задача менеджера - за пару минут понять, стоит ли вообще ехать на осмотр.

Первая карточка за секунды

Запрос краткие данные ТС по госномеру стоит 1 ₽ и отдаёт марку, модель, год, мощность, двигатель, руль и массу. Это быстрая проверка того, что клиент не ошибся в описании: заявлен "2019 год, 249 л.с.", а в данных совсем другая комплектация - уже повод для вопросов.

Критичные риски

Дальше идут проверки, которые решают судьбу сделки. По VIN из шага 1:

• ограничения и розыск (20 ₽): запреты на регистрационные действия с типом, основанием, регионом и исполнительным производством, розыск, периоды владения. Поле found показывает, есть ли VIN в базе ГИБДД;
• реестр залогов (2,4 ₽): статус, active_count, залогодержатели, дата и номер уведомления. Для выкупа это обязательный пункт: машина в залоге у банка - чужая проблема, которую вы покупаете;
• /lizing (2,2 ₽): договоры лизинга, лизингополучатель, даты;
• /lawsuits (3 ₽): споры о собственности, лизинг, банкротство.

Такси, каршеринг, пробег

Бывший таксист или каршеринговая машина - это другой износ, а значит другая цена выкупа. /taxi (1,8 ₽) и /sharing (5,4 ₽) принимают госномер напрямую. Пробег сверяем двумя источниками: история техосмотра и пробег даёт значения из диагностических карт ЕАИСТО с датами, а история объявлений - пробег и цену из прошлых продаж. Если по ТО в 2022 году было 140 тысяч, а в объявлении полгода назад значился 90, разговор с клиентом будет другим.

Оценка и юнит-экономика

Для оценки подключаем /price (0,5 ₽): средняя, минимальная и максимальная цена, динамика, число предложений и аналоги. Считаем полный набор на одну машину: gos2vin 8 + brief 1 + score 20 + pledge 2,4 + lizing 2,2 + lawsuits 3 + taxi 1,8 + sharing 5,4 + probeg 3,4 + offers 1,5 + price 0,5 = 49,2 ₽. Меньше пятидесяти рублей за машину, по которой принимается решение на сотни тысяч. Если на первом этапе достаточно brief и pledge, цена отсечки - 3,4 ₽, а score с остальным запускаете только для тех, кто прошёл.

Сценарий площадки объявлений: автозаполнение и доверие

Форма, которая заполняет себя

Пользователь вводит номер - и поля "марка", "модель", "год", "мощность" заполняются сами. Хватает /brief за 1 ₽ или /gos2vin за 8 ₽, если сразу нужен VIN. Меньше ручного ввода - меньше ошибок и мусорных объявлений.

Фото и антифрод

Метод фото авто по госномеру возвращает прямые ссылки на снимки из открытых объявлений о продаже. Их удобно сопоставлять с тем, что загрузил продавец: если в объявлении цвет и кузов не совпадают с прошлыми снимками, модератору есть что проверить. Здесь важно помнить: по VIN фото отдаются только из накопленного кэша, надёжнее искать по номеру.

Антифрод по дублям строится на /offers: если машина уже продавалась три раза за полгода с разным пробегом и ценой, это сигнал. Пробег, который "уменьшился" по сравнению с прошлым объявлением, - классическая скрутка.

Бейджи "проверено"

Что выносить покупателю: "не в залоге" (pledge), "нет ограничений" (score), "действующий ОСАГО" (osago), "пробег подтверждён техосмотром" (probeg). Это четыре понятных значка, а стоят они вместе около 27 ₽ при полном наборе (2,4 + 20 + 1,5 + 3,4 - если брать score). Если бюджет жёстче, оставьте бейджи залога, ОСАГО и пробега - 7,3 ₽.

Каскад вместо тотальной проверки

Площадка с десятками тысяч объявлений не может прогонять каждое через score. Рабочая схема: при вводе номера - только brief (1 ₽). При публикации - pledge и osago (3,9 ₽). Глубокий отчёт с ограничениями, лизингом и судами запускается по кнопке покупателя или продавца, и платит за него тот, кому он нужен.

Тонкости: смена номеров, кэш и стоимость

Если номер менялся

Машина могла сменить регион или владельца и получить новый номер. Для таких случаев есть история госномеров: список номеров от последнего к первому, без дат. Платно только если найдено больше одного номера (found >= 2), иначе found: 0 и бесплатно (1,5 ₽ при платном результате). Обратное направление даёт /vin2gos - действующий госномер по VIN (6 ₽). Практика: если в объявлении номер один, а по VIN выходит другой, продавец либо ошибся, либо машина недавно перерегистрирована.

Кэш и контроль расходов

VIN не меняется, поэтому результат gos2vin стоит кэшировать у себя навсегда: повторная оплата 8 ₽ за ту же машину бессмысленна. Динамичные данные (залог, ограничения) кэшируйте на короткий срок - сутки, а для финальной проверки перед сделкой делайте свежий запрос. Расходы видны в каждом ответе: блок billing с полями charged, balance, requestId и заголовки X-Charged, X-Balance, X-Request-Id. Нет блока - запрос не списан.

Долгие методы без блокировки интерфейса

/osago-history отвечает 15-60 секунд, а /accidents-rt (19 ₽) вообще асинхронный: создаётся задача, затем опрос раз в 30 секунд, до 40 минут. Не держите пользователя перед спиннером. Запускайте такие методы фоновой задачей, а в интерфейсе показывайте основной отчёт сразу и дозаполняйте блок "ДТП" по готовности, с уведомлением менеджеру.

Стоимость пакетов

Для салона полный выкупной пакет выше - около 49 ₽ на машину; при 300 проверках в месяц это порядка 14 тысяч рублей. Для площадки основная нагрузка - brief на вводе номера, остальное по запросу. Точные актуальные цены лежат в prices.json, их удобно подтягивать в расчёт автоматически.

Запуск за вечер

Регистрация в личном кабинете занимает минуту, токен выдаётся сразу. Договор не нужен, пополнение от 100 ₽ банковской картой (чек на email); юрлицам доступна оплата по счёту с актом и актом сверки в конце месяца. Депозит действует 90 дней.

Отладку делайте на тестовых значениях: госномер Т000ТТ00, VIN X7TEST00000000001. Все методы отвечают образцом со своей схемы и полем "testMode": true, ничего не списывается, токен при этом нужен. Прогоните всю цепочку, обработайте 400, 402 и 503, и только потом переключайтесь на реальные номера. Примеры кода на Python, PHP, JavaScript, Go, Java, C#, Ruby, cURL и 1С есть на странице каждого метода, уже с тестовыми значениями.

Если менеджеру удобнее спрашивать, а не кликать, подключите MCP-сервер: https://api.avtovincod.ru/mcp, авторизация Bearer-токеном. AI-ассистент получает 32 инструмента (registration_history, restrictions_wanted, pledge_check, osago_check и другие), а каждый вызов тарифицируется как обычный запрос к методу. Реплика "проверь залог и ограничения по этому номеру" превращается в два вызова без единой строки интеграции.

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

Проверить машину перед сделкой: чек-лист для автосалона и выкупа

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

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