
# 現在のサインイントランザクションを取得

`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`) も含まれます。詳しくは [サインインステップを実行](/docs/api/fapi/transactions/run-step) を参照してください。ホストされたページは
`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` の証明が無効または再利用されている。 |

## 例

```bash
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 における個人データ](/docs/policies/personal-data) では、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも特別な種類の個人データ(健康、生体データ、宗教、政治的意見、性的指向)を送信しないでください。
