
# エクスポートをダウンロード

`GET /fapi/v1/me/exports/{export_id}/download` · 環境のサインインホストから呼び出します

サインイン中のユーザーが完了させたエクスポートの 1 つについて、ZIP パッケージを添付ファイルとして返します（`Content-Type: application/zip`、`Content-Disposition: attachment; filename="user-export-job_….zip"`）。ファイルを確認するには、エクスポートの `file.sha256` と比較してください。各ダウンロードは、最初のバイトを送信する前に環境の監査ログに記録されます。転送が途中で切れた場合は接続が閉じられるため、不完全なファイルが完全なものに見えることはありません。その場合は再度ダウンロードしてください。

リクエストと同様に、直近のサインインが必要です。セッションが直近 5 分以内に検証されていない場合、またはユーザーに第 2 要素があるのにセッションがそれを使用していない場合は、`401 step_up_required` を返します。`HEAD` はサポートされていません（`405`）。

## リクエスト

ヘッダー:

| ヘッダー | 必須 | 説明 |
| --- | --- | --- |
| `Idp-Client` | はい | SDK の識別子。 |

## レスポンス

`200 OK`。ボディとして ZIP ファイルを返します。

## エラー

| ステータス | コード | 発生条件 |
| --- | --- | --- |
| 401 | `unauthenticated` | 有効なセッション Cookie がありません。 |
| 401 | `step_up_required` | サインインから 5 分以上経過しているか、第 2 要素が必要です。`WWW-Authenticate` ヘッダーには `max_age=300`（第 2 要素が必要な場合は `acr_values` も）が含まれます。 |
| 404 | `not_found` | そのユーザーのエクスポートは存在しません。 |
| 409 | `conflict` | エクスポートがまだ完了していないか、ファイルの有効期限が切れています。 |
| 503 | `service_unavailable` | ユーザーディレクトリが一時的に利用できません。`Retry-After` の後に再試行してください。 |

## 例

```bash
curl -OJ https://example.keenauth.app/fapi/v1/me/exports/job_01jbx4k6v8m2c9w5s7r3t1q0zy/download \
  -H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
  -b cookies.txt
```

## 個人データ

このエンドポイントは個人データを扱います: エンドユーザーのプロフィール、認証情報、連携 ID、セッション、組織メンバーシップと招待、同意の記録、環境ログ、プライバシーリクエスト（パッケージには、これらeach種類のユーザー自身のデータが含まれます）。[KeenAuth API における個人データ](/docs/policies/personal-data) で、保存される内容、保存期間、削除方法を説明しています。いかなるフィールドにも、特別カテゴリの個人データ（健康、生体データ、宗教、政治的意見、性的指向）を送信しないでください。
