自分のデータをエクスポート
POST /fapi/v1/me/exports · 環境のサインインホストから呼び出します
サインイン中のユーザー自身のデータのエクスポートを開始します(GDPR 第15条および第20条)。パッケージはバックグラウンドで準備されます。準備が完了すると、リクエストと同じ言語でユーザーにメールが届きます。ファイルは 7 日間、エクスポートをダウンロード からダウンロードできます。
パッケージは ZIP ファイルで、データの種類ごとに 1 つの JSON ファイルが含まれます。プロフィール、メールアドレスと電話番号、連携済みのアイデンティティ、認証手段(シークレットは除く)、IP アドレスを含むセッション、組織のメンバーシップ、OAuth の付与、同意、サインインイベントです。パスワードのハッシュ、TOTP シード、リカバリーコード、トークン、app_metadata は決して含まれません。
最近のサインインが必要です。セッションが過去 5 分以内に検証されていない場合、またはユーザーが第二要素を持っていてセッションでそれを使用していない場合、応答は 401 step_up_required となり、何も開始されません。ユーザーのエクスポートが準備中の場合は、そのエクスポートが返され、新しいエクスポートは開始されません。ユーザーが 24 時間以内に要求できるエクスポートは最大 2 件です。
リクエスト
ヘッダー:
| ヘッダー | 必須 | 説明 |
|---|---|---|
Idp-Client |
はい | SDK の識別子です。 |
Origin |
はい | 正確に https://<サインインホスト> である必要があります。 |
本文:
{}
レスポンス
202 Accepted:
{"id": "job_01jbx4k6v8m2c9w5s7r3t1q0zy", "status": "queued", "file": null, "failure_reason": null,
"created_at": "2026-11-03T09:30:00Z", "started_at": null, "completed_at": null, "expires_at": null}
エラー
| ステータス | コード | 条件 |
|---|---|---|
| 401 | unauthenticated |
有効なセッション Cookie がありません。 |
| 401 | step_up_required |
サインインから 5 分以上経過している、または第二要素が必要です。WWW-Authenticate ヘッダーには max_age=300(第二要素が必要な場合は acr_values も)が含まれます。 |
| 403 | origin_not_allowed |
Origin がないか、誤っています。 |
| 429 | export_rate_limited |
過去 24 時間に 2 件のエクスポートが既に要求されています。Retry-After の後に再試行してください。 |
| 429 | rate_limited |
環境内で準備中のエクスポートが多すぎます。Retry-After の後に再試行してください。 |
| 503 | service_unavailable |
ユーザーディレクトリが一時的に利用できません。Retry-After の後に再試行してください。 |
例
curl -X POST https://example.keenauth.app/fapi/v1/me/exports \
-H "Idp-Client: my-app/1.0.0 (node/22.0.0)" \
-H "Origin: https://example.keenauth.app" \
-H "Content-Type: application/json" \
-d '{}' \
-b cookies.txt
個人データ
このエンドポイントは個人データを扱います:プライバシーに関するリクエスト(ユーザー自身のエクスポート記録)。KeenAuth API における個人データ では、保存される内容、保存期間、削除方法を説明しています。いずれのフィールドにも特別な種類の個人データ(健康、生体情報、宗教、政治的意見、性的指向)を送信しないでください。