現在のサインイントランザクションをキャンセル

POST /fapi/v1/transactions/current:cancel · 環境のサインインホストから呼び出します

現在のトランザクションをキャンセルします。トランザクションは failed 状態に移行し、トランザクション Cookie は削除されます。

リクエスト

ヘッダー:

ヘッダー 必須 説明
Idp-Client はい SDK 識別子。
Origin はい https://<sign-in host> と完全に一致する必要があります。
Idp-Csrf-Token はい トランザクションオブジェクトの csrf_token。

本文はありません。

レスポンス

キャンセルされたトランザクションを含む 200 OK を返します。

DPoP バインドのヘッドレストランザクション

DPoP ヘッダーを付けて開始したトランザクションの場合は、Idp-Csrf-Token の代わりに、同じキーから新しい証明(htm は POST、htu はこの URL)を送信してください。

エラー

ステータス コード 発生条件
403 origin_not_allowed Origin または Idp-Csrf-Token がないか、不正です。
409 transaction_state_conflict トランザクションはもうキャンセルできません。
410 transaction_expired トランザクションは終了しています。
401 invalid_dpop_proof DPoP 証明が無効、または再利用されています。

例

curl -X POST https://example.keenauth.app/fapi/v1/transactions/current:cancel \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -H "Origin: https://example.keenauth.app" \
  -H "Idp-Csrf-Token: $CSRF_TOKEN" \
  -b cookies.txt