내보내기 다운로드
GET /fapi/v1/me/exports/{export_id}/download · 환경의 로그인 호스트에서 호출
로그인한 사용자가 요청하고 완료된 내보내기 중 하나의 ZIP 패키지를 첨부 파일로 반환합니다(Content-Type: application/zip, Content-Disposition: attachment; filename="user-export-job_….zip"). 파일을 확인하려면 내보내기의 file.sha256 값과 비교하십시오. 각 다운로드는 첫 바이트가 전송되기 전에 환경의 감사 로그에 기록됩니다. 전송이 중단되면 연결이 닫혀 불완전한 파일이 완전한 것처럼 보이지 않으며, 다시 다운로드하십시오.
요청과 마찬가지로 최근 로그인이 필요합니다. 세션이 최근 5분 이내에 인증되지 않았거나, 사용자가 두 번째 인증 요소를 등록했는데 세션에서 이를 사용하지 않았다면 401 step_up_required를 반환합니다. HEAD는 지원되지 않습니다(405).
요청
헤더:
| 헤더 | 필수 여부 | 설명 |
|---|---|---|
Idp-Client |
예 | SDK 식별자입니다. |
응답
200 OK, 본문은 ZIP 파일입니다.
오류
| 상태 | 코드 | 발생 조건 |
|---|---|---|
| 401 | unauthenticated |
유효한 세션 쿠키가 없습니다. |
| 401 | step_up_required |
로그인한 지 5분이 지났거나 두 번째 인증 요소가 필요합니다. WWW-Authenticate 헤더에 max_age=300(두 번째 인증 요소가 필요한 경우 acr_values 포함)이 포함됩니다. |
| 404 | not_found |
해당 사용자의 내보내기가 없습니다. |
| 409 | conflict |
내보내기가 아직 완료되지 않았거나 파일이 만료되었습니다. |
| 503 | service_unavailable |
사용자 디렉터리를 일시적으로 사용할 수 없습니다. Retry-After 이후에 다시 시도하십시오. |
예제
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, 세션, 조직 멤버십과 초대, 동의 기록, 환경 로그, 개인정보 요청을 다룹니다(패키지에는 사용자 본인의 위 각 종류 데이터가 포함됩니다). KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 확인하십시오. 어떤 필드에도 민감정보(건강, 생체 정보, 종교, 정치적 견해, 성적 指向)를 보내지 마십시오.