Проверка водительского удостоверения¶
checkGibdd¶
Тип HTTP запроса: POST
URL вызова: https://api.id-x.org/idx/api2/gibdd/checkDriver
Поддерживаются следующие форматы передачи параметров:
-
JSON, Content-Type: application/json
-
Form submit, Content-Type: application/x-www-form-urlencoded
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| accessKey | String | Да | Ключ доступа, выданный при регистрации в Системе IDX |
| secretKey | String | Да | Секретный ключ, выданный при регистрации в Системе IDX |
| drivingLicenseNumber | String | Да | Номер водительского удостоверения |
| drivingLicenseDate | String | Да | Дата выдачи водительского удостоверения в формате DD.MM.YYYY |
| async | Boolean | Нет | Признак асинхронного вызова |
Функция возвращает:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| resultCode | Int | Да | Результат выполнения функции (0 – успешное завершение функции, иные значения – ошибка выполнения) |
| resultMessage | String | Нет | Сообщение об ошибке |
| operationToken | String | Нет | Уникальный идентификатор операции |
| personBirthDate | Stirng | Нет | Дата рождения владельца водительского удостоверения в формате DD.MM.YYYY |
| drivingLicenseNumber | String | Нет | Номер водительского удостоверения |
| drivingLicenseIssueDate | String | Нет | Дата выдачи водительского удостоверения в формате DD.MM.YYYY |
| drivingLicenseExpiryDate | String | Нет | Срок действия водительского удостоверения в формате DD.MM.YYYY |
| drivingLicenseCategory | String | Нет | Категория |
| status | String | Нет | Статус документа (Действует, Недействителен) |
| stagStart | Int | Нет | Год начала стажа |
| stag | Int | Нет | Водительский стаж (полных лет) |
| wanted | String | Нет | При нахождении в розыске – возвращается дата постановки в розыск |
| decisionList | Array | Нет | Массив объектов – решений по лишению водительского удостоверения. Подробнее см. решение о лишении водительского удостоверения |
Пример вызова (передача параметров в формате json):
POST /idx/api2/checkGibdd
Host: api.id-x.org
Content-Type: application/json
Accept: application/json
{
"accessKey": "Выданный accessKey",
"secretKey": "Выданный secretKey",
"drivingLicenseNumber": "1234567890",
"drivingLicenseDate": "10.10.2020"
}
Пример ответа, когда данные найдены:
{
"resultCode": 0,
"operationToken": "d97c25d6bc1449b1942f3f56f81117a8",
"startMoment": "15.12.2017 11:58:01",
"stopMoment": "15.12.2017 11:58:13",
"personBirthDate": "01.01.1970",
"drivingLicenseIssueDate": "10.10.2020",
"drivingLicenseExpiryDate": "10.10.2030",
"drivingLicenseCategory": "В, В1, М",
"wanted": "",
"status": "Действует",
"stagStart": 2010,
"stag": 13,
"decisionList": [*Решение о лишении водительского удостоверения*]
}
Пример ответа, когда данные НЕ найдены:
{
"resultCode": 0,
"startMoment": "15.12.2017 12:08:46 +0300",
"stopMoment": "15.12.2017 12:08:48 +0300",
"decisionList": []
}
Решение о лишении водительского удостоверения¶
Объект «Решение о лишении водительского удостоверения» включает следующие атрибуты:
| Атрибут | Тип | Описание |
|---|---|---|
| state | String | Статус решения |
| date | String | Дата вступления решения в силу в формате DD.MM.YYYY |
| period | String | Период действия |
| birthPlace | String | Место рождения владельца водительского удостоверения в формате DD.MM.YYYY |
| regName | String | Регион |
| comment | String | Комментарий |
Пример объекта «Решение о лишении водительского удостоверения» в формате json:
{
"state": "Начато исчисление срока лишения права управления",
"birthPlace": "РОССИЙСКАЯ ФЕДЕРАЦИЯ",
"regName": "Нет данных",
"period": "18 мес.",
"date": "19.06.2017",
"comment": "ЛИШЕНИЕ ПРАВА УПРАВЛЕНИЯ ТС+ШТРАФ"
}