/mfa/backup-codes/generate
为用户生成10个备用恢复码,用于TOTP不可用时进行身份验证。恢复码仅显示一次,请妥善保存。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
Request Body
Schema: dto.GenerateBackupCodesRequest
Type: object
Responses
| Status | Description | Schema |
|---|---|---|
| 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
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
data |
dto.BackupCodesResponse |
No | |||
message |
string |
No | |||
timestamp |
string |
No |
dto.BackupCodesResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
codes |
array of string |
No | ['["12345678"', '"23456789"]'] |
||
message |
string |
No | Store these backup codes securely |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
message |
string |
No | |||
timestamp |
string |
No |