发送邮箱验证码
POST /v1/security/email-code:触发上游 `POST /auth/email/code`,让用户取得新的验证码。
POST /v1/security/email-code
触发上游 POST /auth/email/code,让用户取得新的验证码。禁用或解绑 TOTP 的流程会将验证器代码与此邮箱验证码配合使用;未绑定验证器的账户提现时,此验证码是唯一的第二因子。emailType 为必填,取值须为 enableAuthApp、disableAuthApp、unlinkGoogle、withdrawal 之一:上游按用途分别存储验证码,用错用途生成的验证码永远无法通过校验。收件地址取自已登录账户,绝不采用请求中携带的地址。
| 方法 | POST |
| 路径 | /v1/security/email-code |
| 认证 | 设置 GATEWAY_AUTH_TOKEN 时需要 Authorization: Bearer <token> |
| 类别 | auth |
请求体
{ "emailType": "disableAuthApp" }响应体
{ "success": true }说明
400 email_type_invalid:用途缺失或不在允许范围内。409 account_email_unavailable:账户没有可投递的邮箱地址。429 captcha_required:短时间内请求多次后上游拒绝发送,稍等后重试。上游在超过每小时的单地址上限后还会静默丢弃邮件,响应字段无法与真实发送区分,界面上的重发倒计时是唯一的缓解手段。