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

POST /mfa/backup-codes/verify

验证备用恢复码,返回验证结果和剩余备用码数量,用于前端独立处理备用码登录流程。参考:RFC 6238 (TOTP)、OWASP ASVS V2.8.3。

MFA `bearerAuth` application/json

Request Body

Schema: dto.BackupCodeVerifyRequest

FieldTypeRequiredExampleConstraintsDescription
code string Yes 12345678

Responses

StatusDescriptionSchema
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

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

dto.BackupCodeVerifyResponse

FieldTypeRequiredExampleConstraintsDescription
remaining_codes integer No 9
valid boolean No True

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No