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

POST /mfa/sms/send

向用户手机发送短信验证码,用于短信MFA认证。生产环境不返回验证码明文。参考:OWASP ASVS V2.8。

MFA `bearerAuth` application/json

Request Body

Schema: dto.SMSSendRequest

FieldTypeRequiredExampleConstraintsDescription
phone string Yes
purpose string No login, bind, reset

Responses

StatusDescriptionSchema
200发送成功dto.SMSSendDetailResponse
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.SMSSendDetailResponse

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

dto.SMSSendResponse

FieldTypeRequiredExampleConstraintsDescription
code string No 123456
expires string No 2026-05-25T12:05:00Z
sent boolean No True

gitee_com_linmes_authms_base_dto.SimpleResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
message string No
timestamp string No