Проверка действительности разрешений на работу и патентов на осуществление трудовой деятельности иностранными гражданами (ИГ) и лиц без гражданства (ЛБГ)¶
checkMigrantWorker¶
Данный метод работает исключительно в режиме асинхронного выполнения. Подробнее, см. асинхронный режим выполнения запросов
Тип HTTP запроса: POST
URL вызова: https://api.id-x.org/idx/api2/checkMigrantWorker
Поддерживаются следующие форматы передачи параметров:
-
JSON, Content-Type: application/json
-
Form submit, Content-Type: application/x-www-form-urlencoded
Параметры:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| accessKey | String | Да | Ключ доступа, выданный при регистрации в Системе IDX |
| secretKey | String | Да | Секретный ключ, выданный при регистрации в Системе IDX |
| blankSeries | String | Да | Серия бланка документа |
| blankNumber | String | Да | Номер бланка документа |
| docSeries | String | Да | Серия документа |
| docNumber | String | Да | Номер документа |
| docType | String | Да | Тип документа (Patent или WorkPermission) |
| passportNumber | String | Да | Номер паспорта ИГ (ЛБГ) |
Функция возвращает:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| resultCode | Int | Да | Результат выполнения функции (0 – успешное завершение функции, иные значения – ошибка выполнения) |
| resultMessage | String | Нет | Сообщение об ошибке |
| operationToken | String | Нет | Уникальный идентификатор операции |
| isValid | Boolean | Нет | True - разрешение действительно, False – разрешение недействительно |
Пример асинхронного вызова:
POST /idx/api2/checkMigrantWorker
Host: api.id-x.org
Content-Type: application/json
Accept: application/json
{
"accessKey": "выданный accessKey",
"secretKey": "выданный secretKey",
"blankSeries": "ПР",
"blankNumber": "1234567",
"docSeries": "50",
"docNumber": "1234567890",
"docType": "Patent",
"passportNumber": "123456789"
}
Пример ответа на асинхронный запрос:
{
"resultCode": 0,
"resultMessage": "",
"operationToken": "82e9d47328947457353543565349"
}
operationToken используется для вызова getAsyncResult (подробнее см. getAsyncResult) для получения результата.
Пример успешного ответа, получаемого через getAsyncResult:
{
"resultCode": 0,
"resultMessage": "",
"operationToken": "82e9d47328947457353543565349",
"isValid": true
}