TOTP コードを検証

POST /v1/security/totp/verify

非推奨。 既存の呼び出し元のために提供は続けますが、新規の統合では使用しないでください。

6 桁コードがアカウントの現在のシークレットと一致するかを確認し、状態は変更しません。設定パネルはもう呼び出しません。コードの正しさを必要とする操作（有効化、無効化、バインド解除、設定変更）は書き込みと同時に検証するため、往復が 1 回で済み、検証と書き込みの間で状態がずれることもありません。このリポジトリ外で既に統合している呼び出し元のために残しています。

リクエスト本文

{ "totpCode": "123456" }

レスポンス本文

{ "success": true }

注記

失敗時は { 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 を保ち、汎用の文言を添えます。上流の原文はサーバーログにのみ残ります。