MINARA

禁用 TOTP

POST /v1/security/totp/disable:關閉 TOTP,但不移除設備綁定。

POST /v1/security/totp/disable

關閉 TOTP,但不移除設備綁定。需要新的 TOTP 代碼和新的郵箱驗證碼,防止僅憑被盜的驗證器就關閉雙重驗證。

方法POST
路徑/v1/security/totp/disable
認證設置 GATEWAY_AUTH_TOKEN 時需要 Authorization: Bearer <token>
類別auth

說明

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

本頁目錄