發送電子郵件驗證碼
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:短時間內多次請求後上游拒絕寄送,稍後再試。上游在超過每小時的單一地址上限後還會靜默丟棄郵件,回應欄位無法與真實寄送區分,介面上的重寄倒數是唯一的緩解手段。