API ГИБДД

Документация по работе с API ГИБДД

Таймаут: Установите таймаут ожидания минимум 120–400 секунд.

Эндпоинт

GET https://ru-api.ru/api/gibdd?type={type}&token={key}&...

Аутентификация

Получите персональный ключ API (32 символа) и передавайте его в параметре token с каждым запросом.

Типы запросов

type	Описание	Параметры
`driver`	Проверка ВУ Проверка водительского удостоверения (защищено reCAPTCHA v3)	`serianomer`* `date`*
`restrict`	Ограничения на ТС Наличие ограничений на транспортное средство (защищено reCAPTCHA v3)	`vin`*
`wanted`	Розыск ТС Нахождение транспортного средства в розыске (защищено reCAPTCHA v3)	`vin`*
`dtp`	Участие в ДТП Участие транспортного средства в ДТП (защищено reCAPTCHA v3)	`vin`*
`fines`	Штрафы ГИБДД Проверка неоплаченных штрафов (защищено reCAPTCHA v3)	`regNumber`* `stsNumber`*
`gibdd`	История ТС по VIN История регистраций и проверок ТС (защищено reCAPTCHA v3)	`vin`*

* — обязательный параметр. Все запросы также требуют параметр token.

Формат ответа

Успех:

{
  "status": 200,
  "source": "gibdd",
  "type": "тип_запроса",
  "num": 3,
  "rez": [ ... ],
  "inquiry": {
    "price": 1.50,
    "speed": "5.2 сек",
    "attempts": 1,
    "balance": 498.50,
    "cached": false
  }
}

Ошибка:

{"error": "503", "message": "TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}

Пример запроса

curl "https://ru-api.ru/api/gibdd?type=driver&token=ВАШ_ТОКЕН"&serianomer=...&date=...

Коды ошибок

Код	Описание
502	Отсутствует параметр token
503	Токен не зарегистрирован
499	Неверный формат токена
498	Недостаточно средств
500	Отсутствует параметр type
460	Отсутствуют обязательные параметры
404	Источник не найден
456	Превышен лимит одновременных соединений
1	API временно приостановлен