Autional Autional
API Reference GitHub autional.com →

POST /mfa/totp/verify

Verify the TOTP verification code submitted by the user. Enable TOTP multi-factor authentication after successful verification. Rate limiting is applied (checkRateLimit). Reference: RFC 6238 (TOTP), OWASP ASVS V2.8.3.

Multi-Factor Authentication `bearerAuth` application/json

Request Body

Schema: dto.TOTPVerifyRequest

FieldTypeRequiredExampleConstraintsDescription
code string Yes

Responses

StatusDescriptionSchema
200Verification Successfuldto.ValidDetailResponse
400Invalid Parameters or Invalid Verification Codegitee_com_linmes_authms_base_dto.SimpleResponse
401Unauthenticatedgitee_com_linmes_authms_base_dto.SimpleResponse
429Request Too Frequentgitee_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