API ГИБДД (Госавтоиспекция)

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

Алгоритм получения результата запроса с помощью нашего сервиса достаточно прост и практически одинаков для всех видов ресурсов.
Получите ваш персональный ключ API в настройках вашего аккаунта.
для каждого пользователя генерируется уникальный аутентификационный токен, мы называем "персональный ключ API". Это строка из 32 символов, которая выглядит примерно так:
53ba1b7a55abbа14aa97eff3a5220792
Этот ключ используется для всех ваших запросов к api-cloud.

История изменений/обновлений API

Предупреждение Установите таймаут (TIMEOUT) ожидания минимум 120 секунд, иначе вы можете не получить результат, ваш код может прерваться не дождавшись ответа

HTTPS GET запрос: https://api-cloud.ru/api/gibdd.php
Обязательно использовать HTTPS протокол, иначе запросы будут дублироваться при перенаправлении с HTTP на HTTPS.
Обязательно использовать GET запрос, иначе мы не увидим параметры, которые вы передаете.

type Обязательно	Описание	Параметры в запросе Обязательно
	В одном запросе возможно отправить только 1 тип
driver	Проверка водительского удостоверения • Дата рождения владельца • Срок действия удостоверения • Категории ТС • Информация о лишениях права управления	Обязательные serianomer - Серия и Номер водительского удостоверения (без пробелов) Разрешено: цифры date - Дата выдачи удостоверения (в формате дд.мм.гггг) Разрешено: цифры, знак "." token - персональный ключ API
gibdd	Основная информация по VIN номеру • Информация по утилизации • Номер кузова • Номер двигателя • Марка и(или) модель • Цвет • Год выпуска • Рабочий объем • Мощность л.с. • Мощность Квт • Категория • Тип ТС • Информация по таможне • История регистраций	Обязательные vin - VIN номер Разрешено: латиница, цифры, знак "-" token - персональный ключ API
gibddv2 ^new	Основная информация по VIN номеру v2 (использовать в случае, если необходим номер шасси и экологический класс. отсутствует подробная информация по регистрации и некоторые другие результата как в типе запроса "gibdd") • Статус записи реестра • id записи • Номер кузова • Номер шасси • Экологический класс • Марка и(или) модель • Цвет • Год выпуска • Рабочий объем • Мощность л.с. • Мощность Квт • Тип ТС • История регистраций (без уточнения причины регистрации)	Обязательные vin - VIN номер Разрешено: латиница, цифры, знак "-" token - персональный ключ API Дополнительные extract=1 - сделать дополнительно запрос выписки
restrict	Наличие ограничений • Регион наложения ограничения • Основание ограничения • Ключ ГИБДД • Дата наложения • Расшифровка ограничения • Срок окончания ограничения • Телефон инициатора ограничения • Мощность л.с. • Кем наложено ограничение	Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API
wanted	Нахождение в розыске • Регион инициатора розыска • Дата постоянного учета в розыске • Другая информация	Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API
dtp	Участие в дорожно-транспортных происшествиях • Дата ДТП • Повреждения • Номер инцидента • Тип повреждения • Описание инцидента • Место ДТП • Владелец • Регион владения • Карта нанесенного ущерба • Фото карты нанесенного ущерба	Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API Дополнительные dtpimg=1 - в результате будет ссылка на изображение карты нанесенного ущерба
fines	Проверка на штрафы • Действие скидки • Период окончания скидки • Дата возникновения штрафа • Текст штрафа по коАП • Номер постановления • КБК • Сумма штрафа • Токен фотографии нарушения для типа finesPhoto • Информация о подразделении инициатора	Обязательные regNumber - регистрационный номер авто Разрешено: кириллица, цифры, знак "-" stsNumber - номер СТС авто Разрешено: кириллица, латиница, цифры, знак "-" token - персональный ключ API Дополнительные requisites=1 - Платежные реквизиты подразделения которое выставило штраф (результат в массиве division_requisites)
finesPhoto	Запрос данных фотофиксации нарушения • Временный URL с изображением (доступно 10 минут) • base64 код с изображением	Обязательные postNum - Номер постановления Разрешено: цифры regNumber - Регистрационный номер ТС Разрешено: кириллица, цифры division - Номер подразделения ГИБДД Разрешено: цифры photoToken - Токен изображения из типа fines латиница, цифры token - персональный ключ API
eaisto	Проверка диагностических карт, пробег • Дата окончания • Место прохождения осмотра • Информация об операторе • Номер ДК • Дата начала ДК • Информация о ТС • Информация о пробеге	Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API
otoInfo ^new	Получение информации по Оператору Технического Осмотра • Статус аттестата • Директор • Полное Наименование • ОГРН • Адрес юридический • Адрес почтовый • Адрес ПТО • Телефон • E-mail • Сайт • Пропускная способность • Область аккредитации	Обязательные id - id оператора из значения operatorName типа запроса eaisto Разрешено: цифры token - персональный ключ API

Пример отправки GET запроса на PHP:

function get_rez($url) {
		$ch = curl_init($url);
		curl_setopt($ch, CURLOPT_RETURNTRANSFER,true);
		curl_setopt($ch,CURLOPT_TIMEOUT,120); // Таймаут необходим, поскольку 30 секунд может не хватить и вы не получите ответ 
		$res = curl_exec($ch);
		curl_close($ch);
		return $res;
	}

  $data = [
    'type' => 'Тип запроса (type)',
    ...
    Необходимы для запроса параметры
    ...
    'token' => 'Токен',
    ];

    // Структурированная ссылка для GET запроса
    $url = 'https://api-cloud.ru/api/gibdd.php?' . http_build_query($data);

    $data = get_rez($url); // Результат ответа (JSON)

Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
Сервер возвращает ответ в формате JSON.

Важная информация:

Обратите внимание, что скорость загрузки результата зависит напрямую от ресурса источника
При подсчете количества запросов будут приняты к учету только те запросы, которы вернули "status": 200, т.е. получили результат.

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

Проверка водительского удостоверения

Пример запроса "Проверка водительского удостоверения" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=driver&serianomer=*623***977&date=07.11.2014&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу driver с сайта ГИБДД в формате JSON

{
  "doc": {
	// Кем выдано
    "division": "МРЭО ГИБДД Г. ИЗОБИЛЬНЫЙ ГУ МВД РОССИИ ПО СК",
	// Дата выдачи
    "date": "2015-10-07",
	// Стаж с
    "stag": "1992",
	// Дата рождения
    "bdate": "1974-10-01",
	// Серия и номер
    "num": "2623953977",
	// Категории ТС
    "cat": "В,В1,С,С1,СЕ,С1Е",
    "type": "45",
	// Срок действия
    "srok": "2025-10-07",
    "divid": "050 "
  },
  // Ифнормаци о лишениях
  "decis": [
    {
	  // Дата вынесения постановления
      "date": "2011-06-30",
      "fis_id": "26#110720000000007306",
      "bplace": "СВЕРДЛОВСКАЯ ОБЛАСТЬ",
	  // Комментарий ГИБДД
      "comment": "ЛИШЕНИЕ",
	  // Место рождения нарушителя
      "reg_name": "СТАВРОПОЛЬСКИЙ КРАЙ",
	  // Состояние исполнения постановления
      "state": "78",
	  // Срок лишения (в месяцах)
      "srok": 16,
      "reg_code": "1107",
      // Состояние исполнения постановления (расшифровка)
      "stateinfo": "Начато исчисление срока лишения права управления"
    }
  ],
  // Статус ответа
  "status": 200,
  "found": true, // Найдено удостоверение или нет, true - найдено | false - не найдено
  // Информация о запросе
  "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Основная информация по VIN номеру

Пример запроса "Основной информации" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=gibdd&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу gibdd с сайта ГИБДД в формате JSON

{
  "status": 200, // Статус ответа
  "found": true, // Результат найден
  "utilicazia": 0, // Если подлежит утилизации, то значение 1
  "utilicaziainfo": "", Если подлежит утилизации, информация об этом
  "vehicle": {
    "vin": "VF34C5***55170236", // VIN ТС
    "bodyNumber": "VF34C5***55170236", // Номер кузова
    "engineNumber": "0260240",
    "model": "ПЕЖО 308 ", // Марка и(или) модель
    "color": "ЖЕЛТЫЙ", // Цвет ТС
    "year": "2008", // Год ТС
    "engineVolume": "1598.0", // Рабочий объем (см³)
    "powerHp": "120.0", // Мощность л.с.
    "powerKwt": "88.300", // Мощность кВт
    "category": "В", // Категория ТС
    "type": "22", // Тип ТС
    "typeinfo": "Легковые автомобили комби (хэтчбек)" // Расшифровка Тип ТС
  },
  "vehiclePassport": {
    "number": "78ТУ***168",
    "issue": "ТАМОЖНЯ: 10009194"
  },
  // История регистраций ТС
  "ownershipPeriod": [
    {
      "lastOperation": "15", // Причина регистрации
      "lastOperationInfo": "регистрация ТС, ввезенных из-за пределов Российской Федерации", // Расшифровка Причина регистрации
      "simplePersonType": "Natural", // Тип владелец
      "simplePersonTypeInfo": "Физическое лицо", // Расшифровка Тип владелец
      "from": "29.04.2008", // Дата регистрации
      "to": "05.11.2018" // Дата снятия с учета
      "period": "10 лет 6 месяцев 12 дней" // Перид владения
    },
    {
      "lastOperation": "03",
      "lastOperationInfo": "Изменение собственника (владельца) в результате совершения сделки, вступления в наследство, слияние и разделение капитала у юридического лица, переход права по договору лизинга, судебные решения и др.",
      "simplePersonType": "Natural", // Natural - физическое лицо, Legal - юридическое лицо
      "simplePersonTypeInfo": "Физическое лицо",
      "from": "05.11.2018",
      "to": "18.10.2019"
      "period":" 11 месяцев 17 дней" // Перид владения
    },
    {
      "lastOperation": "03",
      "lastOperationInfo": "Изменение собственника (владельца) в результате совершения сделки, вступления в наследство, слияние и разделение капитала у юридического лица, переход права по договору лизинга, судебные решения и др.",
      "simplePersonType": "Natural",
      "simplePersonTypeInfo": "Физическое лицо",
      "from": "18.10.2019",
      "to": "null"
      "period":" 1 год 7 месяцев 6 дней" // Перид владения
    }
  ],
  // Информация о запросе
  "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если неверно переданы данные или результат не найден

{"status":404,"message":"Ресурс не вернул ID запроса"}

Некорректный переданный параметр vin

{
"status":200,
"found": true, // Результат не найден
"message":"Указан некорректный идентификатор транспортного средства (VIN).",   
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

По указанному VIN не найдена информация

{
"status":200,
"found": false, // Результат не найден
"message":"По указанному VIN не найдена информация",  
// Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Основная информация по VIN номеру V2

Пример запроса "Основной информации" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=gibddv2&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу gibddv2 с сайта ГИБДД в формате JSON

{
  "status": 200, // Статус ответа
  "found": true, // Результат: true - найдено, false - отсутствует
  // Массив с информацией об авто
  "vehicle": {
    "vin": "VF34C5FWF22170236", // VIN номер
    "bodyNumber": "VF34C5FWF22170236", // Номер кузова
    "chassisnumber": "", // Номер шасси
    "model": "ПЕЖО 308 ", // Марка и модель
    "color": "ЖЕЛТЫЙ", // Цвет кузова
    "year": "2008", // Год выпуска
    "engineVolume": "1598", // Рабочий объем (см³)
    "powerHp": "120.0", // Мощность л.с.
    "powerKwt": "88.3", // Мощность кВт
    "eco_class": "ЧЕТВЁРТЫЙ", // Экологический класс
    "typeinfo": "Легковой комби (хэтчбек)" // Расшифровка Тип ТС
  },
  // Массив с историей регистрацией
  "ownershipPeriod": [
    {
      "simplePerson": "Natural" // Natural - физическое лицо, Legal - юридическое лицо
      "simplePersonType": "физическое лицо", // Расшифровка Тип владелец
      "from": "29.04.2008", // Дата регистрации
      "to": "05.11.2018", // Дата снятия с учета
      "period": "10 лет 6 месяцев 12 дней" // Перид владения
    },
    {
      "simplePerson": "Natural" // Natural - физическое лицо, Legal - юридическое лицо
      "simplePersonType": "физическое лицо",
      "from": "05.11.2018",
      "to": "18.10.2019",
      "period": "0 лет 11 месяцев 17 дней"
    },
    {
      "simplePerson": "Natural" // Natural - физическое лицо, Legal - юридическое лицо
      "simplePersonType": "физическое лицо",
      "from": "18.10.2019",
      "to": "29.12.2021",
      "period": "2 года 2 месяца 13 дней"
    },
    {
      "simplePerson": "Natural" // Natural - физическое лицо, Legal - юридическое лицо
      "simplePersonType": "физическое лицо",
      "from": "29.12.2021",
      "to": "null",
      "period": "2 года 3 месяца 1 день"
    }
  ],
  "reestr_status": "действующая",
  "id": "969446569",
  // Массив информации о выписке (если в запросе был передан параметр extract=1)
  "extract":{
    "param":1, // 1 - был передан параметр на запрос выписки, 0 - нет
    "statusLoad": 200, // 200 выписка скачана успешно, 404 - не удалось скачать выписку
    "url":"https:\/\/api-cloud.ru\/api\/notification\/5e70c8d113cd0316772343b173dc4efc.pdf" // Ссылка на скачивание выписки (действует 15 минут)
},
  "inquiry": {
    "price": 0.5,
    "balance": 427.4,
    "speed": 9,
    "attempts": 1
  }
}

Если неверно переданы данные или результат не найден

{"status":404,"message":"Ресурс не вернул ID запроса"}

Некорректный переданный параметр vin

{
"status":200,
"found": true, // Результат не найден
"message":"Указан некорректный идентификатор транспортного средства (VIN).",   
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

По указанному VIN не найдена информация

{
"status":200,
"found": false, // Результат не найден
"message":"По указанному VIN не найдена информация",  
// Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Проверка на штрафы

Пример запроса "Проверка штрафов" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?regNumber=СК666T666&type=fines&stsNumber=9920389197&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу fines с сайта ГИБДД в формате JSON

{
"status":200, // Статус ответа
"num":1, // Количество штрафов
// Массив с данными штрафов
"rez":[
{
// Порядковый номер штрафа
"numfines":1,
// 1 если действует скидка, 0 если нет
"Discount":"1",
// Дата / Время окончания скидки на оплату
"DateDiscount":"2020-12-21 23:59:59",
// Дата / Время нарушения
"DateDecis":"2020-11-23 21:03:00",
// Расшифровка КоАП
"KoAPtext":"ПРЕВЫШЕНИЕ УСТАНОВЛЕННОЙ СКОРОСТИ ДВИЖЕНИЯ ТРАНСПОРТНОГО СРЕДСТВА НА ВЕЛИЧИНУ БОЛЕЕ 20, НО НЕ БОЛЕЕ 40 КМ\/Ч",
// Код КоАП
"KoAPcode":"12.9ч.2",
// Номер постановления, необходим для типа finesPhoto > параметр postNum
"NumPost":"18810123201130511194",
"kbk":"18811601121010001140",
// Сумма штрафа
"Summa":500,
// Если присутствует фото, то true, если нет, то false
"photo":true,
// Токент фотофиксации нарушения (действует 5 минут, запрос на получения фото необходимо делать сразу же), необходим для типа finesPhoto > параметр photoToken (если значение photo = false, то и значение phototoken будет = false)
"phototoken":"1081ec1b01041a41a91bd11e12718b16819d1a318712c1f1", // или false при отсутствии фотографий
// Марка/модель транспортного средства
"VehicleModel":"ЛАДА 111930 ЛАДА КАЛИНА",
// Дата постановления
"DatePost":"2020-11-30",
// Номер подразделения ГИБДД, необходим для типа finesPhoto > параметр division
"Division_id":1103999,
// Расшифровка подразделения
"division_name":"ЦАФАПОДД ГИБДД (дислокация г. Краснодар) ГУ МВД России по Краснодарскому краю",
// Регион подразделения
"division_regkod":"23",
// Адрес подразделения
"division_address":"г Краснодар, ул Старокубанская, д 86",
// Координаты подразделения
"division_coords":"39.044942034595998,45.012434698036998",
// Платежные реквизиты (доп параметр requisites=1)
"division_requisites":{
"payment_receiver":"УФК по Республике Дагестан (Министерство внутренних дел по Республике Дагестан л\/с 04031420570)", // Получатель платежа
"ogrn":"", // ОГРН
"inn":"0541018037", // ИНН
"kpp":"057201001", // КПП
"kazn_rs":"03100643000000017200", // Казначейский счет
"single_bank_rs":"40102810945370000069", // Единый казначейский счет
"bank":"ОТДЕЛЕНИЕ-НБ РЕСПУБЛИКА ДАГЕСТАН \/\/УФК по Республике Дагестан, г. Махачкала", // Банк получателя платежа
"bik_tofk":"018209001", // БИК ТОФК
"oktmo":"82701362" // ОКТМО

},
// Дата направления постановления в ФССП России
"DateSSP": "2021-09-02",
}
],
  // Информация о запросе
  "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
}
}

Если штрафы не найдены в базе ГИБДД

{
"status":200,
"num":0,
"message":"В результате проверки не были найдены сведения о неуплаченных штрафах",
// Информация о запросе
  "inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

{
	"status":404,
	"message":"Не найдено ТС с таким сочетанием СТС и ГРЗ",
	// Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
	
}

Запрос фотофиксации нарушения

Пример запроса "Фотофиксации нарушения" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=finesPhoto&postNum=1881012*****22207167& regNumber=СК666T666&division=1***999&photoToken=15b19f1ba1f01b01f9*********71001031fe11118d1ef115&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу finesPhoto с сайта ГИБДД в формате JSON

{
"status":200, // Статус ответа
"num":1, // Количество фотографий
// Массив с фотографиями
"rez": [
  {
	// url временного изображения (доступно 10 минут)
    "urlPhoto": "https://api-cloud.ru/api/fines/18810123210422207167-0.jpeg",
	// base64 код изображения который можно привести к необходимому формату изображения
    "base64Value": "/9j/4AAQSkZJRgABAQAAAQABAAD//KMjSVlpgZGiQjoTTGLbkJfq3ZxWi6lXIUHJoPXim0qAO88UWmpt4ItpPEOjR2Jh0cNA7aZHZlbv+0HHlqVReTAzt5fQjL7c/NWpc6H4ftfFtxpkVhY3EyeNbJZpY0Volgmaci1",
    "type": -2
  }
],
	// Информация о запросе
	"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
}

Если неверно переданы данные или токен фото устарел

{"status":404,"message":"Переданные параметры указаны с ошибкой или токен фото устарел."}

Проверка на розыск

Пример запроса "Нахождение в розыске" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=wanted&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу wanted с сайта ГИБДД в формате JSON

{
  "status": 200, // Статус ответа
  "count": 1, // Количество в розыске
  "records": [
    {
      "num": 1,
      "w_rec": 1,
      "w_reg_inic": "Республика Ингушетия", // Регион инициатора розыска
      "w_dvig": "G4КN****6109" // Номер двигателя
      "w_kuzov": "", // Номер кузова
      "w_model": "ВМW640I", // Марка (модель) ТС
      "w_reg_zn":"K9****7**" // Государственный номер
      "w_shassi":"K*************" // Шасси
      "w_data_pu": "17.10.2018", // Дата постоянного учета в розыске
      "w_vin": "WBALW31***C540031", // VIN ТС
      "w_god_vyp": "2013", // Год ТС
      "w_vid_uch": "Т",
      "w_un_gic": "1267791"
    }
  ], 
  // Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если неверно переданы Рег.номер или СТС

{"status":404,"message":"Не найдено ТС с таким сочетанием СТС и ГРЗ"}

Если в розыске нет

{
  "status":200,
  "count":0,
  "message":"Ограничения отсутствуют",
  "inquiry":
  {
    "price":0.5,
    "balance":1084.54,
    "speed":1,
    "attempts":1
  }
}

Проверка на ограничения

Пример запроса "Наличие ограничений" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=restrict&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу restrict с сайта ГИБДД в формате JSON

{
  "status": 200, // Статус запроса
  "count": 1, // Количество ограничений
  "records": [
    {
      "num": 1, // Порядковый номер штрафа
      "regname": "Краснодарский край", // Регион
      "osnOgr": "Документ: 14706**623/2388 от 10.11.2020, ****** Дарина *******, СПИ: 38810***802636, ИП: 5820**/20/23088-ИП от 12.10.2020", // Основание ограничения
      "gid": "23#SP3123**101", // Ключ ГИБДД
      "tsyear": "2011", // Год транспортного средства
      "tsVIN": "WBALW31***0C540031", // VIN транспортного средства
      "codDL": 0,
      "dateogr": "10.11.2020", // Дата наложения ограничения
      "ogrkod": "1", // Вид ограничения
      "ogrkodinfo": "Запрет на регистрационные действия", // Расшифровка Вид ограничения
      "tsmodel": "Нет данных", // Марка (модель) ТС
      "tsKuzov": "WBALW31***0C540031", // Номер кузова
      "codeTo": 47,
      "dateadd": "10.11.2029", // Срок окончания ограничения
      "phone": "+7(861)9**-*4-1*", // Телефон инициатора
      "regid": "1103",
      "divtype": "2", // Кем наложено
      "divtypeinfo": "Судебный пристав", // Расшифровка Кем наложено
      "divid": "2"
    }
  ],
  // Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если в ограничений нет

{
"status":200,
"count":0,
"message":"Ограничения отсутствуют",
// Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Проверка на ДТП

Пример запроса "Участие в дорожно-транспортных происшествиях" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?type=dtp&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу dtp с сайта ГИБДД в формате JSON

{
  "status": 200, // Статус запроса
  "count": 3, // Количество ДТП
  "records": [
    {
      "num": 1, // Номер ДТП
      "AccidentDateTime": "19.03.2018 12:50", // Дата ДТП
      "VehicleDamageState": "Повреждено", // Повреждения
      "AccidentNumber": "790**1094", // Номер инцидента
      "AccidentType": "Столкновение", // Тип
      "DamageDestription": "", // Описание инцидента
      "VehicleMark": "PORSCHE", // Марка ТС
      "VehicleAmount": "2",
      "VehicleYear": "2014", // Год выпуска ТС
      "AccidentPlace": "Республика Адыгея (Адыгея), Тахтамукайский район", // Место ДТП
      "VehicleSort": "1",
      "VehicleModel": "Cayman", // Модель ТС
      "OwnerOkopf": "ФИЗИЧЕСКИЕ ЛИЦА", // Владелец
      "RegionName": "Республика Адыгея", // Регион владения
	  // Нанесенный ущерб
	  "DamagePointsSVG": "https://api-cloud.ru/api/damage_svg.php?damage=110", // Карта нанесенного ущерба
    "DamagePointsIMG":"https:\/\/api-cloud.ru\/api\/carPhoto\/83c36dc28a0fc51eda6666fb469bf1.jpg" // Изображение нанесенного ущерба (ссылка действует 15 минут). Работает при передаче параметра dtpimg=1, иначе null
      "DamagePointsSVGdesc": "https://api-cloud.ru/api/damage_svg.php?damage=110&desc=1", // Карта нанесенного ущерба + описание
      "DamagePoints": [
        "110"
      ]
    }
  ], 
  // Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если ДТП отсутствуют

{
"status":200,
"count":0,
"message":"Ограничения отсутствуют",   
// Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Проверка диагностических карт, пробег

Пример запроса "Проверка диагностических карт, пробег" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?vin=XTA111610A0101192&type=eaisto&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу eaisto с сайта ГИБДД в формате JSON

{
  // Статус запроса
  "status": 200,
  // Количество найденных записей
  "count": 1,
  "records": [
    {
	  // Номер записи
      "num": 1,
	  // Дата окончания ДК
      "dcExpirationDate": "2021-10-16",
	  // Адрес выдачи ДК
      "pointAddress": "170039, ТВЕРСКАЯ ОБЛАСТЬ, ТВЕРЬ ГОРОД, , СТЕКЛОПЛАСТИК ПРОЕЗД, 5, 0, 0",
	  // Шасси
      "chassis": "",
	  // Кузов 
      "body": "",
	  // ID Оператора (ОТО)
      "operatorName": 779, // Получить информацию по оператору можно через метод (otoInfo).
	  // Показания одометра
      "odometerValue": "235000",
	  // Номер ДК
      "dcNumber": "099970012021273",
	  // Дата выдачи ДК
      "dcDate": "2020-10-15",
	  // VIN ТС
      "vin": "VF34C534565170236",
	  // Модель ТС
      "model": "308",
	  // Марка ТС
      "brand": "Peugeot",
	  // Предидущие ДК
      "previousDcs": [
        {
		  // Показания одометра
          "odometerValue": "190000",
		  // Дата окончания ДК
          "dcExpirationDate": "2018-05-19",
		  // Номер ДК
          "dcNumber": "081050071701275",
		  // Дата начала ДК
          "dcDate": "2017-05-19"
        },
        {
          "odometerValue": "204000",
          "dcExpirationDate": "2019-11-01",
          "dcNumber": "090300011812673",
          "dcDate": "2018-10-31"
        },
        {
          "odometerValue": "180000",
          "dcExpirationDate": "2020-10-16",
          "dcNumber": "079770011903913",
          "dcDate": "2019-10-15"
        },
        {
          "odometerValue": "101201",
          "dcExpirationDate": "2014-04-01",
          "dcNumber": "0005052247",
          "dcDate": "2012-04-24"
        }
      ]
    }
  ], 
  // Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Если диагностические карты не найдены

{
"status":200,
"count":0,
"message":"Данные о ДК не найдены",   
// Информация о запросе
"inquiry": {
    "price": 0.8, // Списание за запрос
    "balance": 100462.11, // Баланс после текущего запроса
    "speed": 1, // Скорость запроса
    "attempts": 1 // Попыток
  }
}

Получение информации по Оператору Технического Осмотра

Пример запроса "Получение информации по Оператору Технического Осмотра" HTTP GET на URL нашего API

https://api-cloud.ru/api/gibdd.php?id=799&type=otoInfo&token=53ba1b7a55abbB014aa97eff3a522079

Пример успешного запроса по типу otoInfo с сайта ГИБДД в формате JSON


{
"status":200, // Статус ответа
"found":true, // Найден результат или нет
  // Массив с информацией о ПТО
  "rez":{
    "otoID":"779", // ID
    "status":"Аттестат действителен", // Статус аттестата
    "director":"Кияшко Владимир Анатольевич", // Директор
    "orgname":"Общество с ограниченной ответственностью "СЭСМА-3"", // Полное Наименование
    "ogrn":"1022304037799", // ОГРН
    "adressur":"353800, Краснодарский край, Красноармейский р-н, ст-ца Полтавская, ул Народная, 157", // Адрес юридический
    "adressMailing":"353800, Краснодарский край, Красноармейский р-н, ст-ца Полтавская, ул Народная, 157", // Адрес почтовый
    "adressPTO":"353800, Краснодарский край, Красноармейский р-н, ст-ца Полтавская, ул Народная, 157", // Адрес ПТО
    "tel":"88616543051", // Телефон
    "email":"mailto:oopks@mail.ru", // E-MAIL
    "site":"https:\/\/00779.umax.ru", // Сайт
    "throughput":"64", // Пропускная способность
    "accreditation":"N2,O4,N1,O1,O2,L,O3,M3,N3,M2,M1" // Область аккредитации
  },
"inquiry":{
"price":0.1,
"balance":228.3,
"speed":0,
"attempts":1
    }
  }
}

Если результат не найден

{
"status":200,
"found":false,
"inquiry":{
"price":0.1,
"balance":227.2,
"speed":0,
"attempts":1
}
}

История изменений API ГИБДД (Госавтоинспекция)

дата

что изменилось

01.09.2024

finesPhoto: выпущен фикс, исправляющий большинство ошибок TIME_MAX_CONNECT

08.06.2024

Метод gibddv2:
1. Добавили запрос выписки (extract=1). Вместе с запросом скачаем выписку и отдадим url на скачивание.
2. В выводе массива ownershipPeriod добавили Natural или Legal обозначения в дополнинение к физическое или юридическое лицо.

29.03.2024

Добавлен новый метод запроса 'gibddv2' для тех, кому необходим Экологический класс и номер шасси в ответе.
Этот метод похож на метод 'gibdd', но в результате отсутствует подробная информация о регистрациях ТС, информация о ПТС.
Подробнее в документации.

24.03.2024

Тип запроса dtp: Добавлена возможность получить ссылку на скачивание фото карты нанесенного ущерба (JPG)
В запросе необходимо передать параметр dtpimg=1, в результате в DamagePointsIMG будет ссылка на изображение, которая действует 15 минут.
Параметр экспериментальный, в случае выявления багов сообщать в тех поддержку.

22.03.2024

Метод запроса wanted: В вывод добавлены Номер шасси, Номер двигателя, Государственный регистрационный номер

01.02.2024

Добавлен новый метод запроса otoInfo
Позволяет получить информацию по Оператору Технического Осмотра.
Для запроса необходим ID Оператора (ОТО), найти его можно в результате запроса eaisto, значение из operatorName. Подробнее в документации.
Цена 0.10 руб / запрос

09.09.2023

Метод finesPhoto: Добавили обработчик ошибки при которой фотографии по определенному постановлению отсутствуют, но при этом в методе запроса fines результат photo=true
Если по постановлению фотографии не грузятся (отсутствуют в базе), то результатом ответа от API будет status => 200, num => 0, rez => array()
Это касается некоторых поставлений, особенно тех, которые уже были направлены в ФССП.
Результатом данного патча будет исправление работы мониторинга API, который при получении подобных ответов отключал API на некоторое время.

07.06.2023

Метод fines:
1. Если фотофиксация по выбранному постановлению невозможна и ключ photo = false, то значение ключа phototoken так же будет false. Ранее даже если фотографии отсутствовали, то токен был в выводе.
2. После получения списка штрафов, токены записываются в базу.
Метод finesPhoto:
1. При получении запроса мы будем проверять срок жизни photoToken, если он живой, то обработаем результат, иначе вы получите результат {"error":"588","message":"photoToken_EXPIRED"}
Обновление направлено на исключение ошибочных запросов, которые мы получаем пачками каждый день.
Ранее можно было отправить запрос на получение фотофиксации даже если фотографии отсутствовали, что приводило к ошибки таймаута.
Документацию дополнили текущими обновлениями.

28.05.2023

Метод запроса fines:
Добавили доп. параметр запроса - requisites=1
Позволяет получить платежные реквизиты подразделения которое выставило штраф

25.05.2023

Выполнена адаптация под источник

10.11.2022

Поправили ошибку, при которой на некоторые запросы получали ошибку TIME_MAX_CONNECT

23.10.2022

В массив inquiry добавили ключ balance. Вывод текущего баланса после запроса, позволит не отправлять дополнительные запросы на проверку баланса.

10.10.2022

Ускорили обработку запросов

18.09.2022

Тип запроса - finesPhoto
Поправили ошибку пустого ответа.

08.09.2022

Обновлен алгоритм работы

22.07.2022

type->fines, исправили переодическую ошибку "Сервис гибдд по проверке штрафов недоступен. Повторите попытку позже."

14.05.2022

В результат type->gibdd добавлен отличительный параметр 'found'.
found => true - результат найден
found => false - результат не найден

25.04.2022

type->gibdd
Ранее перед началом JSON { появлялся пробел ( { status => .....}). Причину возникновения нашли и устранили.

06.04.2022

1. Переработан алгоритм работы по типу запроса "driver"
2. Переработан алгоритм работы по типу запроса "wanted"
3. Переработан алгоритм работы по типу запроса "finesPhoto"

01.04.2022

1. Добавлен заголовок "Content-type: application/json; charset=utf-8"
2. В type->driver добавлен новый ключ в выводе "found", если значение "true", то водительское найдено, если "false", то нет.

05.03.2022

По типу запроса restrict добавлены дополнительные попытки получить запрос.

22.02.2022

type->fines стал более стабильней.
Решили ошибку "Сервис гибдд по проверке штрафов недоступен. Повторите попытку позже." изменением алгоритма.

08.02.2022

Типы запросов: wanted, eaisto.
В безрезультативные выводы добавлен массив inquiry, отвечающий за информацию о запросе: цена запроса, скорость ответа, попытки соединения.

24.01.2022

VIN/Кузов/Шасси
Для типов запросов (dtp, wanted, restrict, eaisto) в параметре vin возможна передача VIN/Кузов/Шасси

03.01.2022

Отключение отдельных типов запросов
Реализовали возможность отключения отдельных типов запросов, чтобы не затрагивать работу API в целом. Это необходимо в том случае, если из всех типов запросов 1 или несколько работают с ошибками. Если тип запроса выключен, то вы получите ошибку {"error":"002","message":"TYPE_SUSPENDED","errormsg":"Работа отдельного модуля API временно приостановлена. Подробнее в details","details":"Запрос по выбранному типу временно приостановлен в связи с некорректной работой ресурса источника. Он заработает как только мы начнем получать корректные ответы"}

16.12.2021

Кэширование
В типах запросов gibdd, restrict, wanted, dtp, eaisto добавлено кэширование. Теперь по умолчанию будет выводиться результат из кэша за последние 6 часов. Это увеличит скорость ответа при наличии кэша.
Если необходим только свежий результат запроса, то необходимо передавать параметр cache=2

18.11.2021

ТРЕБУЕТСЯ ДОРАБОТКА ВАШЕГО КОДА
Архитектура ответа type->fines и type->finesPhoto
Массив с результатами перенесен в переменную rez. Добавлен статус ответа, а так же информация о запросе: Тариф, скорость, количество попыток

26.10.2021

type->wanted
В записи records ранее выводилось просто количество без расшифровки

15.10.2021

Новые параметры поиска
type->restrict, type->wanted, type->dtp, type->eaisto в параметре VIN возможно передать так же номер кузова или шасси.

14.10.2021

В type -> fines добавлен вывод нового параметра
DateSSP - Дата направления постановления в ФССП России

19.09.2021

В type -> fines добавлена новая ошибка 706 - DATA TRANSMITTED WITH ERRORS
Данные переданы с ошибками

19.08.2021

Расшифровка нового ответа по type->gibdd
При передаче неверного VIN номера api-cloud вернет ответ: По указанному VIN не найдена информация. При этом запрос считается успешным.

29.07.2021

1. Исправлена ошибка с переодическим получением ошибки по SLL сертификату.
2. Увеличин лимит ожидания ответа от гибдд

14.07.2021

Изменение статуса результата
При недоступности ресурса источника изменили статус с 404 -> 503

17.06.2021

type -> gibdd
Добавили и отредактировали расшифровки причин изменения регистраций.

09.06.2021

Проверка штрафов (type -> fines)
Всвязи с участившимися случаями неработоспособности сервиса ГИБДД по проверке штрафов, был введен обработчик на ошибку "Проверка наличия неуплаченных штрафов завершилась ошибкой.". Это значит, что на самом ресурсе источнике вывод штрафов в данный момент невозможен.
{"status":404,"message":"Сервис гибдд по проверке штрафов недоступен. Повторите попытку позже."}

21.05.2021

Срок владения ТС (type -> gibdd)
Добавлен новый параметр вывода ownershipPeriod -> period
Указывается полный срок владения с рашифровкой, например: 10 лет 6 месяцев 12 дней, 11 месяцев 17 дней и т.д.

02.05.2021

Проверка водительского удостоверения
В вывод по type=driver можно получить информация о водительском удостоверении, а так же информацию о лишениях

23.04.2021

Изображение нарушения
В вывод по type=finesPhoto можно получить url на фотофиксацию нарушения, а так же base64 код самого изображения.

17.04.2021

Добавлен вывод информации об утилизации
В вывод по type=gibdd отображается информация об утилизации

17.04.2021

Добавлен type "eaisto"
Данный тип позволяет запросить информацию по диагностическим картам, получить информацию по пробегу

17.04.2021

Добавили проверку доступности сервиса решения капч. Если сервис недоступен, то средства за запрос не снимаются. Вы сможете отправить запрос позднее, когда сервис будет вновь доступен.
Код ошибки: 999. SERVICE_CAPTCHA_OFFLINE

Возможные коды ошибок

код (error)	Описание ошибки (message)
888	ИМЯ передаваемой переменной: forbidden symbols present В переменной ИМЯ присутствуют запрещенные символы
766	MISSING_MANDATORY_PARAMETER Отсутствуют обязательные параметры
706	DATA TRANSMITTED WITH ERRORS Данные переданы с ошибками
602	TOKEN_NO_ACCESS Нет доступа к запрашиваему методу запроса
598	MISSING_REQUIRED_id_PARAMETER Отсутствует параметр id
588	photoToken_EXPIRED Истек строк действия photoToken
508	MISSING_REQUIRED_DATE_PARAMETER Отсутствует параметр date или указан неверно
507	MISSING_REQUIRED_SERIANOMER_PARAMETER Отсутствует параметр serianomer или указан неверно
505	MISSING_regNumber_postNum_photoToken_division_PARAM Отсутствуют обязательные параметры regNumber или postNum или photoToken или division
505	MISSING_REQ_REGNUM_STS_PARAM Отсутствует обязательный параметр regNumber или stsNumber
504	TOKEN_LOCKED_IN_THE_SYSTEM Переданный токен заблокирован службой качества / автоматической системой
503	TOKEN_NOT_REGISTERED_IN_THE_SYSTEM Переданный токен не зарегистрирован в системе
502	MISSING_REQUIRED_TOKEN_PARAMETER Отсутствует параметр token
501	MISSING_REQUIRED_VIN_PARAMETER Отсутствует параметр vin или указан неверно
500	MISSING_REQUIRED_TYPE_PARAMETER Отсутствует параметр type
499	WRONG_TOKEN_KEY Вы указали значение параметра token в неверном формате, ключ должен содержать 32 символа.
498	TOKEN_NO_MONEY Для выполнения запроса недостаточно средств, пополните баланс.
460	NO_REQUIRED_PARAMETERS Отсутствуют обязательные параметры
456	MAX_LIMIT Превышено количество одновременных соединений (потоки)
404	TIME_MAX_CONNECT Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата. Повторите попытку позже.
123	IP_NOT_REGISTERED_IN_THE_SYSTEM Сработала защита IP. Текущий IP не совпадает с заданным в ЛК
111	PARAMETER_CONFLICT Вы указали параметры, которые конфликтуют между собой. Например VIN и regNumber. Необходимо указать либо VIN либо regNumber, что-то одно.
015	DATE_ERROR Ошибка значения переданной даты
005	TEST_TIME_OFF Закончился период тестирования
003	TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой
002	TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности.
001	API_SUSPENDED Работа этого API временно приостановлена. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже.

Пример ответа с ошибкой

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

Максимальное количество попыток соединения 3 раза. Если в результате этих попыток ресурс не вернет ответа, то API CLOUD вернет ответ {"status":404, "error":"TIME_MAX_CONNECT", "errormsg":"Достигнуто максимальное количество коннектов, при которых ресурс не вернул результата"}