啟用 TOTP

POST /v1/security/totp/enable

用戶提交新的六位代碼證明已配置驗證器後，激活 TOTP。這是啟用嚮導的第 3 步。

說明

失敗時返回 { error, status, message }，其中 error 是穩定的機器碼。第二因素被拒會映射到一組固定值：invalid_totp、totp_required、invalid_email_code、email_code_required、verification_locked（電子郵件驗證碼錯誤次數過多，message 會給出等待時長）、totp_state_conflict（帳戶已處於請求的狀態）、totp_not_provisioned（尚未產生密鑰）、rate_limited。請求體不合法時返回 400，error 按端點分別為 totp_code_required、totp_and_email_required 或 settings_payload_invalid。網關無法歸類的失敗保留該端點自身的 <action>_failed，並配一條通用文案；上游原文只寫入伺服器日誌。