A AuthMS API Wiki API Reference iam.tianv.com →

POST /mfa/backup-codes/generate

为用户生成10个备用恢复码,用于TOTP不可用时进行身份验证。恢复码仅显示一次,请妥善保存。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。

MFA `bearerAuth` application/json

Request Body

Schema: dto.GenerateBackupCodesRequest

Type: object

Responses

StatusDescriptionSchema
200备用码生成成功dto.BackupCodesDetailResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.BackupCodesDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.BackupCodesResponse No
message string No
timestamp string No

dto.BackupCodesResponse

FieldTypeRequiredExampleConstraintsDescription
codes array of

string

No ['["12345678"', '"23456789"]']
message string No Store these backup codes securely

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No