自分のデータをエクスポート

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