Autional Autional
API Reference GitHub autional.com →

POST /mfa/backup-codes/verify

Verify a backup recovery code, return the verification result and remaining backup code count, used for frontend to independently handle backup code login flow. Reference: RFC 6238 (TOTP), OWASP ASVS V2.8.3.

Multi-Factor Authentication `bearerAuth` application/json

Request Body

Schema: dto.BackupCodeVerifyRequest

FieldTypeRequiredExampleConstraintsDescription
code string Yes 12345678

Responses

StatusDescriptionSchema
200Verification resultdto.BackupCodeVerifyDetailResponse
400Invalid parameter or invalid backup codegitee_com_linmes_authms_base_dto.SimpleResponse
401Unauthenticatedgitee_com_linmes_authms_base_dto.SimpleResponse
500Internal server errorgitee_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
Try this API in Scalar → Download OpenAPI spec (JSON) ↓