/mfa/backup-codes/generate
为用户生成10个备用恢复码，用于TOTP不可用时进行身份验证。恢复码仅显示一次，请妥善保存。参考：RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
请求体
Schema： service-mfa/internal/handler/dto.GenerateBackupCodesRequest
Type: object
响应
| 状态 | 描述 | Schema |
|---|---|---|
| 200 | 备用码生成成功 | service-mfa/internal/handler/dto.BackupCodesDetailResponse |
| 400 | 参数错误 | service-core/base/dto.SimpleResponse |
| 401 | 未认证 | service-core/base/dto.SimpleResponse |
| 500 | 服务器内部错误 | service-core/base/dto.SimpleResponse |
引用的 Schema
service-core/base/dto.SimpleResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.BackupCodesDetailResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
code |
integer |
否 | |||
data |
service-mfa/internal/handler/dto.BackupCodesResponse |
否 | |||
message |
string |
否 | |||
timestamp |
string |
否 |
service-mfa/internal/handler/dto.BackupCodesResponse
| 字段 | 类型 | 必填 | 示例 | 约束 | 描述 |
|---|---|---|---|---|---|
codes |
array of string |
否 | ['["12345678"', '"23456789"]'] |
||
message |
string |
否 | Store these backup codes securely |