POST `/mfa/email/send`

Send a verification code to the user's email for Email MFA authentication. In production, the plaintext verification code is not returned. Reference: OWASP ASVS V2.8.

Multi-Factor Authentication `bearerAuth` application/json

Request Body

Schema: dto.EmailSendRequest

Field	Type	Required	Example	Constraints	Description
`email`	`string`	Yes
`purpose`	`string`	No

Responses

Status	Description	Schema
200	Sent successfully	`dto.EmailSendDetailResponse`
400	Invalid parameter	`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.EmailSendData

Field	Type	Required	Example	Constraints	Description
`expires`	`string`	No
`sent`	`boolean`	No

dto.EmailSendDetailResponse

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

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/email/send