/mfa/backup-codes/verify
验证备用恢复码,返回验证结果和剩余备用码数量,用于前端独立处理备用码登录流程。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。
Request Body
Schema: dto.BackupCodeVerifyRequest
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
string |
Yes | 12345678 |
Responses
| Status | Description | Schema |
|---|---|---|
| 200 | 验证结果 | dto.BackupCodeVerifyDetailResponse |
| 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.BackupCodeVerifyDetailResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
data |
dto.BackupCodeVerifyResponse |
No | |||
message |
string |
No | |||
timestamp |
string |
No |
dto.BackupCodeVerifyResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
remaining_codes |
integer |
No | 9 |
||
valid |
boolean |
No | True |
gitee_com_linmes_authms_base_dto.SimpleResponse
| Field | Type | Required | Example | Constraints | Description |
|---|---|---|---|---|---|
code |
integer |
No | |||
message |
string |
No | |||
timestamp |
string |
No |