Проверка нахождения в розыске МВД¶
checkMvdWanted¶
Данный метод работает исключительно в режиме асинхронного выполнения. Подробнее, см. асинхронный режим выполнения запросов
Тип HTTP запроса: POST
URL вызова: https://api.id-x.org/idx/api2/checkMvdWanted
Поддерживаются следующие форматы передачи параметров:
-
JSON, Content-Type: application/json
-
Form submit, Content-Type: application/x-www-form-urlencoded
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| accessKey | String | Да | Ключ доступа, выданный при регистрации в Системе IDX |
| secretKey | String | Да | Секретный ключ, выданный при регистрации в Системе IDX |
| lastName | String | Да | Фамилия |
| firstName | String | Да | Имя |
| midName | String | Нет | Отчество |
| birthDate | String | Да | Дата рождения в формате ДД.ММ.ГГГГ |
Функция возвращает:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| resultCode | Int | Да | Результат выполнения функции (0 – успешное завершение функции, -100 – данные не найдены, иные значения – ошибка выполнения) |
| resultMessage | String | Нет | Сообщение об ошибке |
| operationToken | String | Нет | Уникальный идентификатор операции |
| data | Массив объектов | Нет | Массив объектов с данными о разыскиваемых персонах, подробнее см. разыскиваемое лицо |
Пример асинхронного вызова:
POST /idx/api2/checkMvdWanted
Host: api.id-x.org
Content-Type: application/json
Accept: application/json
{
"accessKey": "выданный accessKey",
"secretKey": "выданный secretKey",
"lastName": "ИВАНОВ",
"firstName": "ИВАН",
"midName": "ИВАНОВИЧ",
"birthDate": "10.01.1980"
}
Пример ответа на асинхронный запрос:
{
"resultCode": 0,
"resultMessage": "",
"operationToken": "82e9d47328947457353543565349"
}
operationToken используется для вызова getAsyncResult (подробнее см. getAsyncResult) для получения результата.
Пример успешного ответа, получаемого через getAsyncResult:
{
"resultCode": 0,
"resultMessage": "",
"operationToken": "82e9d47328947457353543565349",
"data": [
{
"fio": "ИВАНОВ ИВАН ИВАНОВИЧ",
"sex": "МУЖ",
"birthdate": "1.1.1980",
"birthplace": "ГОРОД МОСКВА",
"reason": "Разыскивается по статье УК",
"info": ""
}
]
}
Разыскиваемое лицо¶
Это объект, содержащий следующие атрибуты:
| Атрибут | Тип | Описание |
|---|---|---|
| fio | String | Фамилия, имя и отчество разыскиваемого лица |
| sex | String | Пол |
| birthdate | String | Дата рождения |
| birthplace | String | Место рождения |
| reason | String | Основание для розыска |
| info | String | Дополнительная информация |