POST `/mfa/sms/send`

Send SMS verification code to the user's phone for SMS MFA authentication. The plaintext code is not returned in production. Reference: OWASP ASVS V2.8.

Multi-Factor Authentication `bearerAuth` application/json

Request Body

Schema: dto.SMSSendRequest

Field	Type	Required	Example	Constraints	Description
`phone`	`string`	Yes
`purpose`	`string`	No			login, bind, reset

Responses

Status	Description	Schema
200	Send Successful	`dto.SMSSendDetailResponse`
400	Invalid Parameters	`gitee_com_linmes_authms_base_dto.SimpleResponse`
401	Unauthenticated	`gitee_com_linmes_authms_base_dto.SimpleResponse`
429	Request Too Frequent	`gitee_com_linmes_authms_base_dto.SimpleResponse`
500	Internal Server Error	`gitee_com_linmes_authms_base_dto.SimpleResponse`

Referenced Schemas

dto.SMSSendDetailResponse

Field	Type	Required
`code`	`integer`	No
`data`	`dto.SMSSendResponse`	No
`message`	`string`	No
`timestamp`	`string`	No

dto.SMSSendResponse

Field	Type	Required	Example	Constraints	Description
`expires`	`string`	No	`2026-05-25T12:05:00Z`
`sent`	`boolean`	No	`True`

gitee_com_linmes_authms_base_dto.SimpleResponse

Field	Type	Required
`code`	`integer`	No
`message`	`string`	No
`timestamp`	`string`	No

Try this API in Scalar → Download OpenAPI spec (JSON) ↓

POST /mfa/sms/send