Создание резервных кодов

Метод используется для создания резервных кодов, которые текущий пользователь может использовать для входа в Панель управления Клиента вместо настроенных методов MFA. Метод возвращает набор из 10 одноразовых кодов. Все ранее созданные коды становятся недействительными, включая неиспользованные. Код ответа 200 OK.

POST {reseller_domain}/internal_api/mfa/generate_backup_codes

В этой статье:

Авторизация

Требуется авторизация с помощью access token пользователя.

Аргументы

Название	Тип параметра	Тип данных	Обязательный/ Опциональный	Описание
Content-Type	header	string	Обязательный	Тип данных, передаваемых в запросе. Укажите application/vnd.api+json
Accept	header	string	Обязательный	Поддерживаемые типы данных в ответе. Укажите application/vnd.api+json
X-Api-Locale	header	string	Опциональный	Двухбуквенный код языка данных в ответе
Authorization	header	string	Обязательный	Действующий access token пользователя. Формат: `Bearer <access token>`
reseller_domain	path	string	Обязательный	Доменное имя реселлера
code	form	string	Обязательный	Код, сгенерированный методом MFA текущего пользователя (например, временный код, отображаемый в приложении для аутентификации)

Модель ответа

Название							Тип данных	Описание
backup_codes							array of strings	10 одноразовых резервных кодов

Пример запроса

Bash

curl --location --request POST 'https://test.activeplatform.com/internal_api/mfa/generate_backup_codes' \
--header 'Content-Type: application/vnd.api+json' \
--header 'Accept: application/vnd.api+json' \
--header 'X-Api-Locale: en' \
--header 'Authorization: Bearer AccessTokenExample' \
--data-raw '{ 
    "data": {
        "attributes": {
            "code": "123456"
        }
    }
}'

Пример ответа

JSON

{
    "backup_codes": [
        "b4c3da4f",
        "48a330cf",
        "7e3558ee",
        "676bd770",
        "661bcdfb",
        "7ada89f9",
        "800734a1",
        "73864b07",
        "88a55dd0",
        "76923f9e"
    ]
}