MINARA

TOTP デバイスのバインドを解除

POST /v1/security/totp/unbind:認証アプリのバインドを取り消し不能な形で削除します。

POST /v1/security/totp/unbind

認証アプリのバインドを取り消し不能な形で削除します。再有効化には新たなスキャンと検証サイクルが必要です。無効化と同じく、TOTP とメールによる二要素が必要です。

メソッドPOST
パス/v1/security/totp/unbind
認証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 を保ち、汎用の文言を添えます。上流の原文はサーバーログにのみ残ります。

目次