Autional Autional
API Reference GitHub autional.com →

POST /mfa/totp/validate

Verify TOTP dynamic code during user login, supporting backup recovery codes. Reference: RFC 6238 (TOTP), OWASP ASVS V2.8.3.

Multi-Factor Authentication `bearerAuth` application/json

Request Body

Schema: dto.TOTPValidateRequest

FieldTypeRequiredExampleConstraintsDescription
code string Yes
user_id string Yes

Responses

StatusDescriptionSchema
200Verification Resultdto.ValidDetailResponse
400Invalid Parametersgitee_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.ValidDetailResponse

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

dto.ValidResponse

FieldTypeRequiredExampleConstraintsDescription
valid boolean No True

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No