Документация по работе с API ГИБДД (Госавтоинспекция)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 | Основная информация по VIN номеру v2 (использовать в случае, если необходим номер шасси и экологический класс. отсутствует подробная информация по регистрации и некоторые другие результата как в типе запроса "gibdd")
• Статус записи реестра
• id записи
• Номер кузова
• Номер шасси
• Экологический класс
• Марка и(или) модель
• Цвет
• Год выпуска
• Рабочий объем
• Мощность л.с.
• Мощность Квт
• Тип ТС
• История регистраций (без уточнения причины регистрации)
|
Обязательные vin - VIN номер Разрешено: латиница, цифры, знак "-" token - персональный ключ API Дополнительные extract=1 - сделать дополнительно запрос выписки |
| restrict | Наличие ограничений
• Регион наложения ограничения
• Основание ограничения
• Ключ ГИБДД
• Дата наложения
• Расшифровка ограничения
• Срок окончания ограничения
• Телефон инициатора ограничения
• Мощность л.с.
• Кем наложено ограничение
|
Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
| wanted | Нахождение в розыске
• Регион инициатора розыска
• Дата постоянного учета в розыске
• Другая информация
|
Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
| dtp | Участие в дорожно-транспортных происшествиях
• Дата ДТП
• Повреждения
• Номер инцидента
• Тип повреждения
• Описание инцидента
• Место ДТП
• Владелец
• Регион владения
• Карта нанесенного ущерба
• Фото карты нанесенного ущерба
Карта нанесенного ущерба (GET HTTPS, не тарифицируется): https://api-cloud.ru/api/damage_svg.php Обязательные параметры:
|
Обязательные 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 (обратите внимание, что запросы на фото необходимо делать в течение 5 минут, иначе токен устареет) латиница, цифры token - персональный ключ API |
| eaisto | Проверка диагностических карт, пробег
• Дата окончания
• Место прохождения осмотра
• Информация об операторе
• Номер ДК
• Дата начала ДК
• Информация о ТС
• Информация о пробеге
|
Обязательные vin - VIN/КУЗОВ/ШАССИ Разрешено: латиница, цифры, знак "-" token - персональный ключ API |
| otoInfo | Получение информации по Оператору Технического Осмотра
• Статус аттестата
• Директор
• Полное Наименование
• ОГРН
• Адрес юридический
• Адрес почтовый
• Адрес ПТО
• Телефон
• E-mail
• Сайт
• Пропускная способность
• Область аккредитации
|
Обязательные id - id оператора из значения operatorName типа запроса eaisto Разрешено: цифры token - персональный ключ API |
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)
Сервер вернёт результат обработки или код ошибки, если что-то пошло не так.
https://api-cloud.ru/api/gibdd.php?type=driver&serianomer=*623***977&date=07.11.2014&token=53ba1b7a55abbB014aa97eff3a522079
{
"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, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?type=gibdd&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079
{
"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":"6 дней" // Перид владения
}
],
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{"status":404,"message":"Ресурс не вернул ID запроса"}
{
"status":200,
"found": true, // Результат не найден
"message":"Указан некорректный идентификатор транспортного средства (VIN).",
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200,
"found": false, // Результат не найден
"message":"По указанному VIN не найдена информация",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?type=gibddv2&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079
{
"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": "ЧЕТВЕРТЫЙ/4", // Экологический класс
"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": "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": "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,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 9,
"attempts": 1
}
}
{"status":404,"message":"Ресурс не вернул ID запроса"}
{
"status":200,
"found": true, // Результат не найден
"message":"Указан некорректный идентификатор транспортного средства (VIN).",
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200,
"found": false, // Результат не найден
"message":"По указанному VIN не найдена информация",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?regNumber=СК666T666&type=fines&stsNumber=9920389197&token=53ba1b7a55abbB014aa97eff3a522079
{
"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, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
Если штрафы не найдены в базе ГИБДД
{
"status":200,
"num":0,
"message":"В результате проверки не были найдены сведения о неуплаченных штрафах",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":404,
"message":"Не найдено ТС с таким сочетанием СТС и ГРЗ",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?type=finesPhoto&postNum=1881012*****22207167& regNumber=СК666T666&division=1***999&photoToken=15b19f1ba1f01b01f9*********71001031fe11118d1ef115&token=53ba1b7a55abbB014aa97eff3a522079
{
"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, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
{
"status": 200,
"num": 0, // Количество будет 0
"rez": [], // Массив будет пустой
"inquiry": {
"price": 0.5,
"balance": 492.67,
"credit": 20000,
"speed": 3,
"attempts": 1
}
}
https://api-cloud.ru/api/gibdd.php?type=wanted&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079
{
"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, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{"status":404,"message":"Не найдено ТС с таким сочетанием СТС и ГРЗ"}
{
"status":200,
"count":0,
"message":"Ограничения отсутствуют",
"inquiry":
{
"price":0.5,
"balance":1084.54,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed":1,
"attempts":1
}
}
https://api-cloud.ru/api/gibdd.php?type=restrict&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079
{
"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, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200,
"count":0,
"message":"Ограничения отсутствуют",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?type=dtp&vin=XTA111610A0101192&token=53ba1b7a55abbB014aa97eff3a522079
{
"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": [
"214",
"215",
"216"
],
// Разбор точек повреждений ((Подробнее))
"DamageTranscript": [
// С указанием места и степени повреждения (новый формат ГИБДД)
{
"code": "214", // Код точки
// Степень повреждения
"level": {
// Значение
"value": "2",
// Расшифровка
"title": "Вмятины, вырывы, заломы, перекосы, разрывы и другие повреждения с изменением геометрии элементов (деталей) кузова и эксплуатационных характеристик ТС"
},
// Место повреждения
"damage": {
// Значение
"value": "14",
// Расшифровка
"title": "Правая задняя часть (фара, бампер и т.д.)"
},
// Цвет на карте ГИБДД (red - красный, yellow - желтый, Red Cross - красный крест)
"color": "red"
},
{
"code": "215",
"level": {
"value": "2",
"title": "Вмятины, вырывы, заломы, перекосы, разрывы и другие повреждения с изменением геометрии элементов (деталей) кузова и эксплуатационных характеристик ТС"
},
"damage": {
"value": "15",
"title": "Левая задняя часть (фара, бампер и т.д.)"
},
"color": "red"
},
{
"code": "216",
"level": {
"value": "2",
"title": "Вмятины, вырывы, заломы, перекосы, разрывы и другие повреждения с изменением геометрии элементов (деталей) кузова и эксплуатационных характеристик ТС"
},
"damage": {
"value": "16",
"title": "Левое заднее крыло (колесо и т.д.)"
},
"color": "red"
},
// Без указания степени повреждения (использовался до 01.12.2017)
{
"code": "216", // Код точки
// Степень повреждения (всегда null)
"level": {
"value": null,
"title": null
},
// Место повреждения
"damage": {
// Значение
"value": "16",
// Расшифровка
"title": "Левое заднее крыло (колесо и т.д.)"
},
// Цвет на карте ГИБДД (red - красный, yellow - желтый, Red Cross - красный крест)
"color": null
}
]
}
],
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200,
"count":0,
"message":"Ограничения отсутствуют",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?vin=XTA111610A0101192&type=eaisto&token=53ba1b7a55abbB014aa97eff3a522079
{
// Статус запроса
"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, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
{
"status":200,
"count":0,
"message":"Данные о ДК не найдены",
// Информация о запросе
"inquiry": {
"price": 0.8, // Списание за запрос
"balance": 100462.11, // Баланс после текущего запроса
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed": 1, // Скорость запроса
"attempts": 1 // Попыток
}
}
https://api-cloud.ru/api/gibdd.php?id=799&type=otoInfo&token=53ba1b7a55abbB014aa97eff3a522079
{
"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,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed":0,
"attempts":1
}
}
}
{
"status":200,
"found":false,
"inquiry":{
"price":0.1,
"balance":227.2,
"credit": "0.00", // Кредитный лимит (сумма лимита расходов при нуле)
"speed":0,
"attempts":1
}
}
| дата | что изменилось | |
|---|---|---|
| 25.03.2025 | Метод finesPhoto: Добавлено исколючение в случае, если передается старый токен (photoToken) или какие то из обязательных параметров не относятся к фото которое запрашивается. |
|
| 24.03.2025 | Метод finesPhoto: Адаптация под источник, иправляет частую ошибку TIME_MAX_CONNECT |
|
| 02.03.2025 | Методы gibdd и gibddv2: в массиве ownershipPeriod->period поправили текст со сроком владения. |
|
| 02.03.2025 | 1. Карта нанесенного ущерба ДТП адаптирована для мобильных устройств. |
|
| 25.01.2025 | Метод dtp: В выводе добавлен массив (DamageTranscript) с расшифровками повреждений. |
|
| 22.01.2025 | Метод finesPhoto: Выпущен фикс, исправляющий многие ошибки TIME_MAX_CONNECT. |
|
| 01.09.2024 | finesPhoto: выпущен фикс, исправляющий большинство ошибок TIME_MAX_CONNECT |
|
| 08.06.2024 | Метод gibddv2: |
|
| 29.03.2024 | Добавлен новый метод запроса 'gibddv2' для тех, кому необходим Экологический класс и номер шасси в ответе. |
|
| 24.03.2024 | Тип запроса dtp: Добавлена возможность получить ссылку на скачивание фото карты нанесенного ущерба (JPG) |
|
| 22.03.2024 | Метод запроса wanted: В вывод добавлены Номер шасси, Номер двигателя, Государственный регистрационный номер |
|
| 01.02.2024 | Добавлен новый метод запроса otoInfo |
|
| 09.09.2023 | Метод finesPhoto: Добавили обработчик ошибки при которой фотографии по определенному постановлению отсутствуют, но при этом в методе запроса fines результат photo=true |
|
| 07.06.2023 | Метод fines: |
|
| 28.05.2023 | Метод запроса fines: |
|
| 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'. |
|
| 25.04.2022 | type->gibdd |
|
| 06.04.2022 | 1. Переработан алгоритм работы по типу запроса "driver" |
|
| 01.04.2022 | 1. Добавлен заголовок "Content-type: application/json; charset=utf-8" |
|
| 05.03.2022 | По типу запроса restrict добавлены дополнительные попытки получить запрос. |
|
| 22.02.2022 | type->fines стал более стабильней. |
|
| 08.02.2022 | Типы запросов: wanted, eaisto. |
|
| 24.01.2022 | VIN/Кузов/Шасси |
|
| 03.01.2022 | Отключение отдельных типов запросов |
|
| 16.12.2021 | Кэширование |
|
| 18.11.2021 | ТРЕБУЕТСЯ ДОРАБОТКА ВАШЕГО КОДА |
|
| 26.10.2021 | type->wanted |
|
| 15.10.2021 | Новые параметры поиска |
|
| 14.10.2021 |
|
|
| 19.09.2021 | В type -> fines добавлена новая ошибка 706 - DATA TRANSMITTED WITH ERRORS |
|
| 19.08.2021 | Расшифровка нового ответа по type->gibdd |
|
| 29.07.2021 | 1. Исправлена ошибка с переодическим получением ошибки по SLL сертификату. |
|
| 14.07.2021 | Изменение статуса результата |
|
| 17.06.2021 | type -> gibdd |
|
| 09.06.2021 | Проверка штрафов (type -> fines) |
|
| 21.05.2021 | Срок владения ТС (type -> gibdd) |
|
| 02.05.2021 | Проверка водительского удостоверения |
|
| 23.04.2021 | Изображение нарушения |
|
| 17.04.2021 | Добавлен вывод информации об утилизации |
|
| 17.04.2021 | Добавлен type "eaisto" |
|
| 17.04.2021 | Добавили проверку доступности сервиса решения капч. Если сервис недоступен, то средства за запрос не снимаются. Вы сможете отправить запрос позднее, когда сервис будет вновь доступен. |
| код (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, что-то одно. |
| 15 | DATE_ERROR Ошибка значения переданной даты |
| 5 | TEST_TIME_OFF Закончился период тестирования |
| 3 | TOKEN_BLOCKED_BY_QUALITY_SERVICE Ваш токен заблокирован службой качества. Свяжитесь с технической поддержкой |
| 2 | TOKEN_TEHBLOCK Установлена техническая блокировка токена. Включить или выключить можно самостоятельно в настройках безопасности. |
| 1 | API_SUSPENDED Работа этого API или метода временно приостановлена. Это значит, что источник не отвечает. Мы уже в курсе проблемы и занимаемся решением. Повторите запрос позже. |
{"error":"503","message":"TOKEN_NOT_REGISTERED_IN_THE_SYSTEM"}
| value (Значение) | title (Место поврежедния) |
|---|---|
| 01 | Правая передняя сторона |
| 02 | Правая боковая (передняя) сторона |
| 03 | Правая боковая (задняя) сторона |
| 04 | Правая задняя сторона |
| 05 | Левая задняя сторона |
| 06 | Левая боковая (задняя) сторона |
| 07 | Левая боковая (передняя) сторона |
| 08 | Левая передняя сторона |
| 09 | Крыша |
| 11 | Полная деформация кузова |
| value (Значение) | title (Степень повреждения) |
|---|---|
| 0 | Другие повреждения Дополнительные коды: 001 — Полная деформация кузова, 002 — Смещение двигателя, 003 — Смещение переднего моста, 004 — Смещение заднего моста, 005 — Возгорание, 006 — Повреждение (уничтожение) VIN |
| 1 | Повреждения колёс (шин), элементов ходовой части, стёкол, фар, указателей поворота, стоп-сигналов и других стеклянных элементов (в т.ч. зеркал), а также царапины, сколы, потёртости лакокрасочного покрытия или пластиковых конструктивных деталей и другие повреждения без изменения геометрии элементов (деталей) кузова и эксплуатационных характеристик ТС |
| 2 | Вмятины, вырывы, заломы, перекосы, разрывы и другие повреждения с изменением геометрии элементов (деталей) кузова и эксплуатационных характеристик ТС |
| value (Значение) | title (Место повреждения) |
|---|---|
| Легковое ТС | |
| 10 | Правое переднее крыло (колесо и т.д.) |
| 11 | Правая передняя дверь (порог, стекло, зеркало и т.д.) |
| 12 | Правая задняя дверь (порог, стекло и т.д.) |
| 13 | Правое заднее крыло (колесо и т.д.) |
| 14 | Правая задняя часть (фара, бампер и т.д.) |
| 15 | Левая задняя часть (фара, бампер и т.д.) |
| 16 | Левое заднее крыло (колесо и т.д.) |
| 17 | Левая задняя дверь (порог, стекло и т.д.) |
| 18 | Левая передняя дверь (порог, стекло, зеркало и т.д.) |
| 19 | Левое переднее крыло (колесо и т.д.) |
| 20 | Правая передняя часть (фара, бампер и т.д.) |
| 21 | Левая передняя часть (фара, бампер и т.д.) |
| 22 | Передний капот (багажник) |
| 23 | Крыша |
| 24 | Задний капот (багажник) |
| 25 | Днище |
| Мототранспорт | |
| 50 | Правая сторона передняя (фары, стекло, вилка, колесо и т.д.) |
| 51 | Правая сторона средняя (двигатель, бензобак и т.д.) |
| 52 | Правая сторона задняя (колесо, сиденье, фары и т.д.) |
| 53 | Левая сторона передняя (фары, стекло, вилка, колесо и т.д.) |
| 54 | Левая сторона средняя (двигатель, бензобак и т.д.) |
| 55 | Левая сторона задняя (колесо, сиденье, фары и т.д.) |
| Автобус | |
| 30 | Правая передняя сторона (фары, стекло, бампер и т.д.) |
| 31 | Правая боковая (передняя) сторона (дверь, стекло, элементы кузова и т.д.) |
| 32 | Правая боковая (средняя) сторона (дверь, стекло, элементы кузова, колёса и т.д.) |
| 33 | Правая боковая (задняя) сторона (дверь, стекло, элементы кузова, колёса и т.д.) |
| 34 | Правая задняя сторона (фары, стекло, бампер и т.д.) |
| 35 | Левая задняя сторона (фары, стекло, бампер и т.д.) |
| 36 | Левая боковая (задняя) сторона (стекло, элементы кузова, колёса и т.д.) |
| 37 | Левая боковая (средняя) сторона (стекло, элементы кузова, колёса и т.д.) |
| 38 | Левая боковая (передняя) сторона (дверь, стекло, элементы кузова, колёса и т.д.) |
| 39 | Левая передняя сторона (фары, стекло, бампер и т.д.) |
| 40 | Передняя сторона крыши (габаритные огни, элементы кузова и т.д.) |
| 41 | Средняя сторона крыши (габаритные огни, элементы кузова, люки и т.д.) |
| 42 | Задняя сторона крыши |
| 43 | Днище |
| Грузовое ТС | |
| 60 | Правая передняя сторона (фары, стекло, бампер и т.д.) |
| 61 | Правая передняя сторона тентового покрытия грузовика |
| 62 | Правая боковая (передняя) сторона (дверь, стекло, элементы кузова, колесо и т.д.) |
| 63 | Правая боковая сторона (рама, колёса, элементы кузова и т.д.) |
| 64 | Правая боковая сторона борта грузовика |
| 65 | Правая боковая сторона тентового покрытия грузовика |
| 66 | Правая задняя сторона тентового покрытия грузовика |
| 67 | Правая задняя сторона борта грузовика |
| 68 | Правая задняя сторона (фары, бампер и т.д.) |
| 69 | Левая задняя сторона (фары, бампер и т.д.) |
| 70 | Левая задняя сторона борта грузовика |
| 71 | Левая задняя сторона тентового покрытия грузовика |
| 72 | Левая боковая сторона тентового покрытия грузовика |
| 73 | Левая боковая сторона борта грузовика |
| 74 | Левая боковая сторона (рама, колёса, элементы кузова и т.д.) |
| 75 | Левая боковая (передняя) сторона (дверь, стекло, элементы кузова, колесо и т.д.) |
| 76 | Левая передняя сторона (фары, стекло, бампер и т.д.) |
| 77 | Левая передняя сторона тентового покрытия грузовика |
| 78 | Крыша кабины грузовика |
| 79 | Крыша тентового покрытия (днище бортового кузова) |
| 80 | Днище |
| Автобус и грузовое ТС | |
| 90 | Передний правый угол |
| 91 | Передний правый бок |
| 92 | Задний правый бок |
| 93 | Задний правый угол |
| 94 | Задний левый угол |
| 95 | Задний левый бок |
| 96 | Передний левый бок |
| 97 | Передний левый угол |
| 98 | Крыша |
| 99 | Днище |