Главная → Блог → Проверка лицензии такси по госномеру: как автоматизировать для агрегатора и автопарка
Такси и автопаркиПроверка лицензии такси по госномеру: как автоматизировать для агрегатора и автопарка

Действующее разрешение такси проверяется запросом GET /taxi?plate= или /taxi?vin=: в ответе действующие и аннулированные разрешения, регион, номер разрешения и перевозчик. Это позволяет агрегатору или автопарку автоматически допускать на линию только машины с живым разрешением, без ручного поиска на сайтах регионов. Для проверки на тестовых данных достаточно токена, платить за отладку не нужно.
Что именно проверяется: разрешение на машину, а не на водителя
Когда в поиске пишут "лицензия такси", обычно имеют в виду разрешение на деятельность легкового такси. С точки зрения проверки это разные вещи, и путаница стоит денег. Разрешение выдаётся на конкретный автомобиль, привязано к перевозчику (юрлицу или ИП) и к региону, который его выдал. На водителя оно не оформляется. Поэтому "проверка лицензии такси по госномеру" на деле означает проверку разрешения на машину: есть ли оно, чьё и где действует.
Метод возвращает два вида записей: действующие и аннулированные. Нужны оба статуса. Действующее разрешение говорит, что машину можно выпускать на линию. Аннулированное объясняет, почему машина вдруг пропала из реестра: перевозчик отказался от неё, разрешение отозвали, машину передали другому. Если у автомобиля нет действующего, но есть три аннулированных за два года, это уже повод для вопросов, а не просто "нет допуска". Пустой ответ и ответ с одной аннулированной записью - разные ситуации, и логика допуска должна их различать.
Запрос и ответ метода /taxi
Для проверки используется метод проверки такси. Параметр один из двух: plate (госномер) или vin. Авторизация - Bearer-токен, один на все методы платформы. Ответ в JSON.
В ответе вы получаете список разрешений. По каждому: регион выдачи, номер разрешения, перевозчик и статус (действует или аннулировано). Именно эти четыре вещи и нужны для решения: живое ли разрешение, тот ли это перевозчик, из того ли оно региона. Точные имена полей и структуру смотрите в схеме на странице метода, а образец ответа бесплатно отдаёт тестовый режим.
Пример на cURL с тестовым госномером:
curl -H "Authorization: Bearer ВАШ_ТОКЕН" \
"https://api.avtovincod.ru/taxi?plate=Т000ТТ00"
То же на Python:
import requests
TOKEN = "ВАШ_ТОКЕН"
resp = requests.get(
"https://api.avtovincod.ru/taxi",
params={"plate": "Т000ТТ00"},
headers={"Authorization": f"Bearer {TOKEN}"},
timeout=30,
)
data = resp.json()
print(data)
print(resp.headers.get("X-Charged"), resp.headers.get("X-Balance"))
Базовый адрес и точный путь сверьте со страницей метода в документации: примеры кода там уже подставлены с тестовыми значениями, в том числе для PHP, JavaScript, Go, Java, C#, Ruby и 1С.
Как видеть стоимость
Проверка одной машины стоит 1,8 ₽ за запрос. Каждый ответ, записанный в историю запросов, содержит блок billing (charged, currency, billed, balance, requestId) и заголовки X-Charged, X-Balance, X-Request-Id. Если блока нет, запрос не списан. Ошибки и сбои источника бесплатны, так что повторять запрос после сбоя можно без оглядки на бюджет. Удобно логировать requestId рядом с решением по машине: когда водитель или перевозчик оспорит отказ, у вас будет привязка к конкретному ответу.
Сценарий 1: онбординг водителя или машины в агрегаторе
Типичная картина: водитель в приложении вводит госномер своей машины. Бэкенд дёргает /taxi?plate= и смотрит на результат. Логика решения укладывается в три исхода.
- Допуск. Есть действующее разрешение, регион совпадает с регионом работы водителя, перевозчик совпадает с тем, к кому водитель подключается (или входит в список ваших партнёров).
- Отказ. Разрешений нет вовсе, либо все аннулированы. Водителю сразу говорите, что нужно оформить разрешение, и не гоняете его по ручной модерации.
- Ручная проверка. Разрешение действует, но перевозчик чужой, или регион не тот, или за короткий срок сменилось несколько перевозчиков. Такие случаи уходят оператору с готовой карточкой из ответа.
Если у вас под рукой только VIN, например из договора аренды или данных парка, сначала получите номер через госномер по VIN (стоит 6 ₽). Хотя сам /taxi принимает и VIN напрямую, госномер пригодится для остальных проверок и для показа водителю. В обратную сторону работает VIN по госномеру (8 ₽): водитель ввёл номер, а вам нужен VIN для залогов, ограничений или ОСАГО. Заодно в ответе /gos2vin приходит признак такси, его можно сверить с результатом /taxi.
Не вызывайте платные методы на каждый символ ввода. Валидируйте формат номера на клиенте и отправляйте запрос один раз, после подтверждения. На большом потоке регистраций это заметная экономия.
Сценарий 2: сверка всего парка и регулярный контроль
Онбординг проверяет машину в момент входа. Но разрешение может аннулироваться через месяц, а машина продолжит выезжать. Поэтому для парка нужны ещё два режима.
Разовая сверка
Если машин до 100, программировать не нужно. Загрузите список (Excel, CSV или текст со столбцом госномеров) в массовую проверку автомобилей в личном кабинете, выберите проверку такси и запустите. Перед стартом видна оценка "не больше", а по итогу вы получаете таблицу по всем машинам и выгрузку в Excel. Обработка идёт на сервере, о готовности придёт сообщение на почту и в Telegram. Удобно, когда парк проверяется раз в квартал или нужно срочно разобраться после смены перевозчика.
Для парков больше сотни машин проще цикл по списку через API: тот же /taxi, один токен, свои очереди и повторы. Скелет:
for plate in plates:
r = requests.get(URL, params={"plate": plate}, headers=H, timeout=30)
if r.status_code != 200:
retry_later.append(plate)
continue
save(plate, r.json(), r.headers.get("X-Request-Id"))
Постоянный контроль
Статус самого разрешения такси кабинетный мониторинг не отслеживает: в списке его событий такого пункта нет. Поэтому для регулярного контроля разрешений настройте периодический опрос /taxi по расписанию (cron или планировщик задач). Раз в сутки по всему парку при цене 1,8 ₽ за запрос - вполне посильная нагрузка. Сохраняйте предыдущий результат по каждой машине и сравнивайте с новым: если действующее разрешение исчезло или появилась новая аннулированная запись, создавайте задачу диспетчеру и снимайте машину с линии.
Мониторинг автомобилей закрывает смежные риски парка. Он работает по данным реестров, не по GPS, и присылает сообщения только об изменениях: новый штраф ГИБДД, залог, запрет на регистрационные действия, арест, розыск, смена собственника или госномера, окончание ОСАГО, ДТП, лизинг. Частоту задаёте для каждой проверки: ежедневно, раз в неделю, раз в две недели, раз в месяц или по сроку. Каналы: Telegram, почта и вебхук. Вебхук приходит как POST с JSON и подписью X-AVC-Signature: sha256=... (HMAC тела вашим секретом), события вроде monitor.change и monitor.check_failed. Подпись проверяйте до обработки, иначе поддельный запрос запустит у вас ложную реакцию.
Практическое правило: разовая сверка нужна при приёмке парка и аудитах, опрос /taxi по расписанию - чтобы машина с аннулированным разрешением не выезжала на линию неделями, а мониторинг следит за ОСАГО, штрафами, запретами и сменой номера.
Региональные нюансы: Москва, Московская область, Санкт-Петербург
Запрос по госномеру или VIN не зависит от того, в каком регионе вы ищете: вы не выбираете реестр вручную, а передаёте идентификатор машины. Регион выдачи приходит в ответе как данные. Поэтому для Москвы, Московской области и Санкт-Петербурга запрос выглядит одинаково.
Отсюда практический приём: сверяйте регион разрешения с регионом, где водитель собирается работать. Машина с действующим разрешением одного региона и заказами в другом - классический повод для ручной проверки. Правила допуска (какие регионы считать допустимыми, как поступать в пограничных случаях) задаёте вы сами в своей логике, метод лишь отдаёт факты.
Чего метод не делает: он не проверяет водительское удостоверение, стаж, медосмотр и допуск самого водителя. Это отдельные проверки на вашей стороне. Разрешение на машину - необходимое условие, но не достаточное.
Дополнительные проверки для парка
Разрешение такси редко проверяют в одиночку. Вокруг него обычно складывается набор.
Пробег и техосмотр. История техосмотра и пробег по диагностическим картам ЕАИСТО показывает даты, оператора и зафиксированный пробег. Для машины, которая числится в такси, резкий разрыв между пробегом в картах и в заявленных данных - повод присмотреться. Стоит 3,5 ₽ за запрос.
История ДТП. Метод проверки ДТП по архивам проверок (0,8 ₽, данные архивные, не в реальном времени) подходит как быстрый фильтр при приёмке машины, а ДТП по базе ГИБДД с 2015 года даёт полную картину, но работает асинхронно: вы создаёте задачу и опрашиваете её раз в 30 секунд.
ОСАГО и цель использования. История полисов ОСАГО показывает все полисы автомобиля за годы, включая цель использования (такси), ограничение по водителям и тип собственника. Это хорошая перекрёстная проверка: если разрешение есть, а полисы всегда оформлялись на личное использование, стоит выяснить причину. Метод отвечает обычно за 15-60 секунд, закладывайте это в таймауты и делайте асинхронно.
Штрафы, ограничения, залог. Перед приёмом машины в парк проверьте штрафы по СТС через метод штрафов ГИБДД, а также запреты на регистрационные действия (/score) и реестр залогов. Машина с активным залогом или арестом может быть изъята вместе с вашим планом по линии.
Каршеринг и лизинг. Проверка каршеринга и метод /lizing выявляют скрытое использование: автомобиль, который раньше работал в каршеринге, имеет другой износ, а лизинговая машина может сдаваться в аренду без согласия лизингодателя.
Как подключиться
Регистрация в личном кабинете занимает минуту, токен выдаётся сразу. Пополнение от 100 ₽ банковской картой, чек приходит на email. Договора и бесплатных периодов нет: схема простая, платите только за выполненные проверки. Депозит действует 90 дней. Юрлицам доступно пополнение по счёту, в конце месяца выдаются акт и акт сверки.
Отладку можно сделать бесплатно: тестовые значения (госномер Т000ТТ00, VIN X7TEST00000000001) возвращают образец по схеме метода с полем "testMode": true. Токен нужен, пополнение - нет. Сначала настройте разбор ответа и логику допуска на образце, а затем переключайтесь на реальные номера.
Частые вопросы
Можно ли проверить разрешение такси только по госномеру?
Да. Достаточно запроса GET /taxi?plate= с госномером. Если известен только VIN, используйте GET /taxi?vin=. Дополнительных данных о водителе или перевозчике передавать не нужно.
Чем лицензия такси отличается от разрешения и что возвращает API?
Разрешение выдаётся на конкретный автомобиль и привязано к перевозчику и региону. Запросы про "лицензию" на практике означают именно его. API возвращает действующие и аннулированные разрешения: регион, номер разрешения и перевозчика.
Как узнать, что разрешение аннулировано?
В ответе метода /taxi аннулированные разрешения идут отдельно от действующих. Если действующих нет, а аннулированные есть, значит, разрешение было, но прекращено. Для автоматического контроля запускайте опрос /taxi по расписанию и сравнивайте новый ответ с предыдущим.
Работает ли проверка для Москвы, Московской области и Санкт-Петербурга?
Запрос строится по госномеру или VIN, а не по региону, поэтому выглядит одинаково везде. Регион выдачи разрешения приходит в ответе, и его можно сверять с регионом работы водителя.
Сколько стоит проверка одной машины?
1,8 ₽ за запрос. Стоимость каждого запроса видна в блоке billing и заголовке X-Charged. Ошибки и сбои источника не списываются, а тестовые значения работают бесплатно.
Как проверить весь парк сразу без программирования?
Загрузите список до 100 машин в раздел массовой проверки в личном кабинете (Excel, CSV или вставка текста), выберите проверку такси и запустите. Результат придёт таблицей с выгрузкой в Excel, о готовности сообщат на почту и в Telegram.
Можно ли следить за изменением статуса разрешения такси автоматически?
Кабинетный мониторинг автомобилей такие изменения не отслеживает: он сообщает о штрафах, залогах, запретах, розыске, смене собственника или госномера, окончании ОСАГО, ДТП и лизинге. Для статуса разрешения настройте периодический опрос /taxi по расписанию (cron) и сравнивайте результат с предыдущим.
Что делать, если разрешение не найдено?
Сначала проверьте корректность госномера и при необходимости повторите запрос по VIN, получив его через /gos2vin. Если разрешения действительно нет, отправьте машину на отказ или ручную проверку по вашим правилам: возможно, разрешение ещё не оформлено либо оформлено на другую машину.
Проверка автомобилей через API
Без договора и долгих согласований: пополните баланс от 100 ₽ и проверяйте реальные машины. Тестовые значения бесплатно, документация с примерами на популярных языках.
Получить токен Документация API

