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

POST /mfa/sms/verify

验证用户输入的短信验证码,完成短信MFA认证。使用限流保护。参考:OWASP ASVS V2.8。

MFA `bearerAuth` application/json

Request Body

Schema: dto.SMSVerifyRequest

FieldTypeRequiredExampleConstraintsDescription
code string Yes
phone string No 手机号,用于创建 MFAConfig 记录

Responses

StatusDescriptionSchema
200验证结果dto.SMSVerifyDetailResponse
400参数错误gitee_com_linmes_authms_base_dto.SimpleResponse
401未认证gitee_com_linmes_authms_base_dto.SimpleResponse
429请求过于频繁gitee_com_linmes_authms_base_dto.SimpleResponse
500服务器内部错误gitee_com_linmes_authms_base_dto.SimpleResponse

Referenced Schemas

dto.SMSVerifyDetailResponse

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

dto.SMSVerifyResponse

FieldTypeRequiredExampleConstraintsDescription
valid boolean No True

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No