Контрольные вопросы#

Проверка наличия вопроса#

Метод

GET https://login.company.com/blitz/api/v3/users/{subjectId}/secQsn

Проверка наличия у пользователя контрольного вопроса.

Необходимые разрешения: blitz_api_usec или blitz_api_sys_usec.

Возвращает

  • Если контрольный вопрос задан - текст контрольного вопроса.

  • Если контрольный вопрос не задан - 404 Not Found.

Пример

GET /blitz/api/v3/users/d2580c98-e584-4aad-a591-97a8cf45cd2a/secQsn HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
Cache-Control: no-cache

{
    "question": "Как звали вашего первого питомца"
}

Проверка ответа#

Метод

POST https://login.company.com/blitz/api/v3/users/{subjectId}/secQsn/check

Проверка правильности ответа на контрольный вопрос.

Необходимые разрешения: blitz_api_usec или blitz_api_sys_usec.

Тело запроса

Контрольный вопрос (question) и ответ на него (answer).

Возвращает

  • В случае успешной проверки вопроса и ответа - 204 No Content.

  • В противном случае - 400 Bad request.

Пример

POST /blitz/api/v3/users/d2580c98-e584-4aad-a591-97a8cf45cd2a/secQsn/check HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
Content-Type: application/json
X-Forwarded-For: 200.200.100.100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5)…

{
    "question": "Как звали вашего первого питомца",
    "answer": "Тигр"
}
Не совпал контрольный вопрос#
{
    "type": "process_error",
    "error": "wrong_security_answer",
    "desc": "security question not match"
}
Не совпал ответ на контрольный вопрос#
{
    "type": "process_error",
    "error": "wrong_security_answer",
    "desc": "security answer not match"
}
Контрольный вопрос у пользователя не установлен#
{
    "type": "process_error",
    "error": "wrong_security_answer",
    "desc": "security question not found"
}

Установка или изменение вопроса#

Метод

POST https://login.company.com/blitz/api/v3/users/{subjectId}/secQsn

Установка или изменение контрольного вопроса пользователя.

Необходимые разрешения: blitz_api_sys_usec_chg или blitz_api_sys_usec_chg.

Тело запроса

Контрольный вопрос (question) и ответ на него (answer).

Возвращает

В случае успешной установки контрольного вопроса - 204 No Content.

Пример запроса#
POST /blitz/api/v3/users/d2580c98-e584-4aad-a591-97a8cf45cd2a/secQsn HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
Content-Type: application/json
X-Forwarded-For: 200.200.100.100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5)…

{
    "question": "Как звали вашего первого питомца",
    "answer": "Тигр"
}

Удаление вопроса#

Метод

DELETE https://login.company.com/blitz/api/v3/users/{subjectId}/secQsn

Удаление контрольного вопроса из учетной записи пользователя.

Необходимые разрешения: blitz_api_usec_chg или blitz_api_sys_usec_chg.

Возвращает

При успешном выполнении - 204 No Content.

Пример запроса#
DELETE /blitz/api/v3/users/d2580c98-e584-4aad-a591-97a8cf45cd2a/secQsn HTTP/1.1
Authorization: Bearer cNwIXatB0wk5ZHO0xG5kxuuLubesWcb_yPPqLOFWDuwzMDc0Nz
X-Forwarded-For: 200.200.100.100
User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_5)…