В современном мире автоматизированный доступ к данным ГИБДД (Государственная инспекция безопасности дорожного движения) открывает широкие возможности для разработки сервисов: от проверки штрафов и статуса ТС до интеграции с сервисами такси и страхования. В статье подробно рассматривается, как получить доступ к API ГИБДД, какие эндпоинты доступны, как формировать запросы и обрабатывать ответы.
Что такое API ГИБДД и какие сервисы доступны
API ГИБДД – это набор HTTP‑интерфейсов, позволяющих получать официальные данные из государственных реестров в формате JSON. На сегодняшний день существует несколько связанных сервисов:
- API ГИБДД – основной набор методов для работы с ТС, штрафами, водителями.
- МосТранспорт API – данные о транспортных средствах, зарегистрированных в Москве.
- НСИС API – Национальная система информации о страховании.
- ЕАИСТО API – единый автоматизированный информационный сервис технического осмотра.
- РЕЕСТР БАНКРОТСТВ API – информация о банкротстве юридических лиц.
Все эти сервисы работают по единой схеме: клиент отправляет HTTP‑запрос к определённому эндпоинту, указывая API‑ключ, а сервер возвращает ответ в JSON.
Как получить доступ к API
- Регистрация на портале поставщика API. На официальном сайте api-gibdd.ru необходимо создать учетную запись.
- Запрос API‑ключа. После подтверждения e‑mail вы можете отправить запрос на получение API‑ключа. На бесплатном тарифе предоставляется 1000 запросов в месяц.
- Утверждение условий использования. При регистрации вы соглашаетесь с политикой использования данных и ограничениями по частоте запросов.
- Тестовый доступ. На каждый ключ предоставляется тестовый режим, в котором можно выполнять запросы без списания лимита (до 100 запросов).
- Контакт с поддержкой. Если требуется больше запросов или специфический набор сервисов, пишите на support@api-gibdd.ru – вам предложат индивидуальный тариф.
Важно помнить, что API‑ключ – это секретный токен, который следует хранить в защищённом месте и никогда не передавать клиентским приложениям в открытом виде.
Технические детали: базовый URL, форматы запросов и ответов
Все запросы отправляются к базовому URL:
https://api-gibdd.ru/v1/В зависимости от задачи добавляются пути (эндпоинты) и параметры. Формат запросов – GET или POST с указанием заголовка Authorization: Bearer <API_KEY> либо параметра api_key=<API_KEY> в строке запроса.
Формат запросов
- Метод:
GETдля получения данных,POSTдля отправки сложных запросов (например, пакетный поиск). - Параметры: передаются в строке URL (для GET) или в теле запроса в формате
application/json(для POST). - Заголовки:
Accept: application/jsonContent-Type: application/json(только для POST)Authorization: Bearer <API_KEY>(рекомендованный способ)
Формат ответов (JSON)
Ответ всегда содержит объект status и поле data. Пример успешного ответа:
{
"status": "ok",
"code": 200,
"data": {
"plate": "А123ВС77",
"region": "77",
"model": "Toyota Camry",
"year": 2018,
"owner": {
"name": "Иванов Иван Иванович",
"address": "Москва, ул; Пушкина, д.10"
},
"fines": [
{
"id": "1234567890",
"date": "2024-09-15",
"amount": 2500,
"status": "неоплачен"
}
]
}
}В случае ошибки поле error содержит описание проблемы:
{
"status": "error",
"code": 401,
"error": "Invalid API key"
}Основные эндпоинты API ГИБДД
- /plate_fields – список регионов и параметров для поиска по номеру. Бесплатный запрос, полезен для формирования выпадающих списков.
- /vehicle – информация о транспортном средстве по номеру
plateи регионуregion. - /vin – поиск ТС по VIN‑коду.
- /fines – список штрафов по номеру ТС или ИНН владельца.
- /owner – данные о владельце ТС (при наличии согласия).
- /monitoring – управление мониторингом ТС (добавление/удаление из списка наблюдения).
Пример запроса по номеру автомобиля
curl -X GET "https://api-gibdd.ru/v1/vehicle?plate=А123ВС77®ion=77&api_key=YOUR_API_KEY"
-H "Accept: application/json"Пример запроса по VIN
curl -X GET "https://api-gibdd.ru/v1/vin?vin=1HGCM82633A004352&api_key=YOUR_API_KEY"
-H "Accept: application/json"Получение списка регионов (эндпоинт /plate_fields)
curl -X GET "https://api-gibdd.ru/v1/plate_fields?api_key=YOUR_API_KEY"
-H "Accept: application/json"Ответ содержит массив объектов, каждый из которых описывает регион (код, название, форматы номеров).
Как отправлять запросы: HTTP‑методы, заголовки, параметры
Для большинства задач достаточно GET‑запросов. При работе с большими объемами данных (например, пакетный поиск по списку VIN) рекомендуется использовать POST с массивом в теле запроса.
Пример пакетного запроса (POST) для получения информации о нескольких ТС:
curl -X POST "https://api-gibdd.ru/v1/vehicle/batch?api_key=YOUR_API_KEY"
-H "Content-Type: application/json"
-d '{
"vehicles": [
{"plate": "А123ВС77", "region": "77"},
{"plate": "В456ЕГ78", "region": "78"}
] }'Ответ будет массивом объектов data в том же порядке, что и запрос.
Обработка ответов и типичные коды ошибок
- 200 OK – запрос выполнен успешно, данные находятся в поле
data. - 400 Bad Request – неверные параметры запроса (например, отсутствует
plate). - 401 Unauthorized – неверный или отсутствующий
API‑key. - 403 Forbidden – превышен лимит запросов или нет доступа к запрашиваемому сервису.
- 404 Not Found – указанный ресурс (например, VIN) не найден в базе.
- 429 Too Many Requests – превышен rate‑limit. Нужно подождать или перейти на платный тариф.
- 500 Internal Server Error – ошибка на стороне сервера, рекомендуется повторить запрос через несколько секунд.
Для надёжной работы рекомендуется реализовать повтор запросов при получении 5xx‑ошибок и экспоненциальную задержку при 429.
Ограничения по частоте запросов и тарифы
На бесплатном тарифе предоставляется:
- До 1000 запросов в месяц.
- Ограничение 10 запросов в секунду (burst‑limit 20 запросов).
- Доступ к основным эндпоинтам:
/vehicle,/vin,/fines,/plate_fields.
Для коммерческих проектов доступны платные тарифы с:
- Скидкой от объёма (чем больше запросов – тем ниже цена). Пример: 10 000 запросов – 0,005 USD за запрос, 100 000 запросов – 0,003 USD.
- Повышенными лимитами (до 100 000 запросов в секунду для крупномасштабных интеграций).
- Доступом к дополнительным сервисам (например, мониторинг ТС, интеграция с ЕАИСТО).
Для получения индивидуального предложения необходимо написать в службу поддержки (см. раздел Контактная информация).
Безопасность и защита от роботов (reCAPTCHA)
Официальный сайт ГИБДД использует Google reCAPTCHA для защиты от автоматизированного сбора данных. При работе через официальное API ГИБДД эта защита не требуется – сервис предоставляет чистый HTTP‑интерфейс без капчи.
Если вам необходимо парсить данные напрямую с сайта ГИБДД (не через API), можно воспользоваться сервисами‑прокси, например api-parser.com, которые решают проблему reCAPTCHA. Однако такой подход нарушает условия использования официального сайта и может привести к блокировке IP‑адресов.
Часто задаваемые вопросы (FAQ)
- Как получить бесплатный API‑ключ?
Зарегистрируйтесь на api-gibdd.ru, подтвердите e‑mail и в личном кабинете запросите ключ. На бесплатном тарифе вы получаете 1000 запросов в месяц. - Можно ли использовать API без указания API‑ключа?
Нет. Все запросы требуют аутентификации. Без ключа вы получите ответ401 Unauthorized. - Как узнать, сколько запросов я уже использовал?
В личном кабинете есть раздел Usage Statistics, где отображается количество запросов за текущий месяц и оставшийся лимит. - Что делать, если я превысил лимит запросов?
При получении кода429 Too Many Requestsзапросы временно отклоняются. Вы можете:- Подождать до начала следующего окна (обычно 1 минуту).
- Перейти на платный тариф, запросив увеличение лимита у поддержки.
- Можно ли получать данные о владельце ТС без его согласия?
Доступ к персональным данным (ФИО, адрес) предоставляется только при наличии согласия владельца или в рамках официальных запросов от государственных органов. В противном случае API вернёт полеownerпустым. - Как интегрировать API в мобильное приложение?
Рекомендуется использовать сервер‑прокси: мобильное приложение отправляет запросы на ваш бекенд, а бекенд уже взаимодействует с API ГИБДД, скрываяAPI‑keyот клиента.
Контактная информация
Если у вас возникли вопросы по подключению, тарифам или техническим деталям, свяжитесь с поддержкой:
- Email: support@api-gibdd.ru
- Телефон: +7 (495) -23‑45‑67 (работаем в будние дни с 09:00 до 18:00 МСК)
- Форма обратной связи: https://api-gibdd.ru/contact
- Telegram‑бот: @api_gibdd_bot – быстрый ответ в течение нескольких минут.
Для крупных проектов предусмотрены персональные менеджеры, которые помогут подобрать оптимальный тариф и настроить интеграцию.
API сайта ГИБДД – мощный инструмент для получения официальных данных о транспортных средствах, штрафах и владельцах. Следуя рекомендациям, описанным в этой статье, вы сможете быстро получить доступ, правильно формировать запросы и надёжно обрабатывать ответы. Не забывайте про ограничения по частоте запросов, храните API‑ключ в безопасном месте и используйте сервер‑прокси для защиты ключа в клиентских приложениях. При необходимости расширить функциональность или увеличить лимит запросов – обращайтесь в службу поддержки, где вам предложат индивидуальные условия.
Удачной разработки и безопасного доступа к данным ГИБДД!