現在のサインイントランザクションを取得
GET /fapi/v1/transactions/current · 環境のサインインホストから呼び出し
__Host-idp_ltx Cookie が指すトランザクションを、その状態と次に実行できるステップを含めて返します。
リロード後にサインインページを再開するために使用します。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子、<package>/<version> (<runtime>/<version>)。 |
トランザクションの Cookie は、ブラウザによって自動的に送信されます。
レスポンス
200 OK でトランザクションオブジェクト(schema_version, state, next_steps, csrf_token, expires_at)を返します。すべてのレスポンスには
Cache-Control: no-store が含まれます。
既存のアカウントに企業接続のリンクをユーザーに求めるトランザクションには、account_link
(connection_name, organization_name) も含まれます。詳しくは サインインステップを実行 を参照してください。ホストされたページは
resume=1 を使ってこれに到達し、新しいトランザクションを作成する代わりにそれを続行します。企業サインイン後にまだ第二の要素(second_factor_pending)または登録(enrollment_pending)が必要な場合も同様です。
DPoP にバインドされたヘッドレストランザクション
DPoP ヘッダーで開始されたトランザクションについては、同じキーから新しい証明を送信してください(htm GET, htu この URL)。サーバーは、そのキーにバインドされた、有効期限内の最新のトランザクションを返します。認可コードはここでは返されません。
エラー
| ステータス | コード | 発生条件 |
|---|---|---|
| 400 | malformed_request |
Idp-Client がありません。 |
| 410 | transaction_expired |
Cookie がない、Cookie が無効、またはトランザクションが終了している。 |
| 401 | invalid_dpop_proof |
DPoP の証明が無効または再利用されている。 |
例
curl https://example.keenauth.app/fapi/v1/transactions/current \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-b cookies.txt
個人データ
このエンドポイントは個人データを扱います:エンドユーザーのプロフィール。KeenAuth API における個人データ では、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも特別な種類の個人データ(健康、生体データ、宗教、政治的意見、性的指向)を送信しないでください。