Проверка совершеннолетия¶
verifyAge¶
Тип HTTP запроса: POST
URL вызова: https://api.id-x.org/idx/api2/verifyAge
Поддерживаются следующие форматы передачи параметров:
-
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 | Нет | Дата рождения в формате ДД.ММ.ГГГГ |
| phone | String | Да | Номер телефона |
Функция возвращает:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| resultCode | Int | Да | Результат выполнения функции (0 – успешное завершение функции, -100 – данные не найдены, иные значения – ошибка выполнения) |
| resultMessage | String | Нет | Сообщение об ошибке |
| operationToken | String | Нет | Уникальный идентификатор операции |
| score | Int | Нет | Числовой результат проверки. Варианты результатов см. расшифровка скоринга |
| scoreText | String | Нет | Текстовое описание результата |
Пример вызова:
POST /idx/api2/verifyAge
Host: api.id-x.org
Content-Type: application/json
Accept: application/json
{
"accessKey": "выданный accessKey",
"secretKey": "выданный secretKey",
"lastName": "Иванов",
"firstName": "Иван",
"midName": "Иванович",
"birthDate": "01.01.1970",
"phone":"79991112233"
}
Пример успешного ответа:
{
"resultCode": 0,
"operationToken": "82e9d6ec643242e348bbefbe4d7b",
"score": 100,
"scoreText": "Возраст подтвержден: 18+"
}
Пример неуспешного ответа:
{
"resultCode": -100,
"operationToken": "edeee3ec059b429089ba2d963ec4029a",
"score": 10,
"scoreText": "Данные не совпадают"
}
Расшифровка скоринга¶
| Значение | Описание |
|---|---|
| 100 | Возраст подтвержден: 18+ |
| 50 | Возраст подтвержден: 18- |
| 10 | Возраст не подтвержден: Данные не совпадают |
| 0 | Возраст не подтвержден: Информация не найдена |