내 데이터 내보내기
POST /fapi/v1/me/exports · 환경의 로그인 호스트에서 호출
로그인한 사용자 본인의 데이터 내보내기를 시작합니다(GDPR 제15조 및 제20조). 패키지는 백그라운드에서 준비되며, 준비가 완료되면 사용자는 요청에 사용한 언어로 된 이메일을 받습니다. 파일은 7일 동안 내보내기 다운로드를 통해 내려받을 수 있습니다.
패키지는 데이터 종류별로 JSON 파일이 하나씩 담긴 ZIP 파일입니다. 프로필, 이메일 주소와 전화번호, 연결된 ID, 인증기(비밀 정보 제외), IP 주소가 포함된 세션, 조직 구성원 정보, OAuth 권한 부여, 동의, 로그인 이벤트가 포함됩니다. 비밀번호 해시, TOTP 시드, 복구 코드, 토큰, app_metadata는 절대 포함되지 않습니다.
최근 로그인이 필요합니다. 세션이 최근 5분 이내에 검증되지 않았거나, 사용자에게 두 번째 인증 요소가 있는데 세션이 이를 사용하지 않았다면 401 step_up_required 응답이 반환되며 내보내기는 시작되지 않습니다. 해당 사용자의 내보내기가 아직 준비 중이면 그 내보내기가 반환되며 새로 시작되지 않습니다. 사용자는 24시간 동안 최대 2건의 내보내기를 요청할 수 있습니다.
요청
헤더:
| 헤더 | 필수 | 설명 |
|---|---|---|
Idp-Client |
예 | SDK 식별자입니다. |
Origin |
예 | 정확히 https://<sign-in host>이어야 합니다. |
본문:
{}
응답
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 |
유효한 세션 쿠키가 없습니다. |
| 401 | step_up_required |
로그인이 5분보다 오래되었거나 두 번째 인증 요소가 필요합니다. WWW-Authenticate 헤더에 max_age=300(두 번째 인증 요소가 필요한 경우 acr_values 포함)이 담깁니다. |
| 403 | origin_not_allowed |
Origin이 없거나 잘못되었습니다. |
| 429 | export_rate_limited |
최근 24시간 동안 이미 두 건의 내보내기를 요청했습니다. 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의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 확인할 수 있습니다. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.