사용자 데이터 내보내기 다운로드
GET /v1/jobs/user-exports/{job_id}/download · 권한 users:export
완료된 사용자 데이터 내보내기의 패키지에 대한 일회성 링크를 제공합니다. 링크가 발급되기 전에 모든 호출은 관리 감사 로그에 user_export.downloaded 기록을 남깁니다.
요청
| 매개변수 | 위치 | 필수 | 설명 |
|---|---|---|---|
job_id |
path | 예 | 작업 ID, job_ 접두사로 시작합니다. |
include_ip: true로 생성된 작업은 다운로드하는 자격 증명에 audit-events:read_ip 권한도 필요합니다.
응답
본문이 비어 있는 302 Found를 반환합니다. Location은 같은 호스트의 상대 링크이며 형식은 /downloads/user-exports/{environment_id}/{job_id}/{token}입니다. 응답에는 Cache-Control: no-store와 Referrer-Policy: no-referrer가 포함됩니다.
- 링크는 15분 동안 유효하며 한 번만 사용할 수 있습니다. 첫 번째 요청에서 전송이 중단되더라도 토큰은 사용된 것으로 처리됩니다. 새 링크가 필요하면 이 작업을 다시 호출하십시오.
- 링크에는 자격 증명이 필요하지 않으며 토큰이 유일한 자격 증명입니다.
Location을 비공개로 유지하고 로그에 남기지 마십시오. - 파일은 환경의 키로 저장 시 암호화되므로 저장소 사전 서명 URL은 사용되지 않습니다. KeenAuth가 파일을 복호화하여 스트리밍합니다.
링크에 GET 요청을 보내면 Content-Type: application/zip, Content-Length, Content-Disposition: attachment; filename="user-export-job_….zip"이 포함된 200 OK를 반환합니다. 링크 미리보기가 토큰을 소비하지 않도록 HEAD 요청은 405로 거부됩니다. 파일의 SHA-256을 작업의 file.sha256과 비교하십시오. Content-Length 바이트가 도착하기 전에 연결이 끊어지면 패키지가 불완전한 것이므로 폐기하고 새 링크를 요청하십시오. 잘못되었거나 이미 사용되었거나 만료된 링크는 404 not_found를 반환합니다.
오류
모든 오류는 안정적인 code가 포함된 application/problem+json 본문으로 반환됩니다.
| HTTP | code |
발생 조건 |
|---|---|---|
| 401 | unauthenticated |
API 키가 없거나 유효하지 않거나 폐기되었습니다. |
| 403 | insufficient_permissions |
키에 users:export 권한이 없거나, 작업이 include_ip로 생성되었는데 키에 audit-events:read_ip 권한이 없습니다(required_permissions에 두 권한이 모두 표시됩니다). |
| 404 | not_found |
작업이 없거나, 다른 환경에 속하거나, ID 형식이 잘못되었습니다. 링크의 경우 토큰이 잘못되었거나, 이미 사용되었거나, 만료되었습니다. |
| 409 | conflict |
작업이 아직 완료되지 않았거나 파일이 만료되었습니다. |
| 429 | rate_limited |
요청 한도를 초과했습니다. Retry-After를 준수하십시오. 링크 자체는 IP 주소당 분당 10회 요청을 허용합니다. |
| 503 | service_unavailable |
종속 서비스를 일시적으로 사용할 수 없습니다. 나중에 다시 시도하십시오. |
예시
curl -L -o user-export.zip \
https://api.eu.keenauth.com/v1/jobs/user-exports/job_01j9xk3m7q8r2s4t6v8w0y2z4e/download \
-H "Authorization: Bearer $KEENAUTH_SECRET_KEY"
CLI는 링크를 직접 따라가며, 패키지를 파일에 기록하고(표준 출력에는 절대 기록하지 않음), 기존 파일을 덮어쓰지 않으며, 기록한 내용의 크기와 SHA-256을 출력합니다.
keenauth jobs user-exports download job_01j9xk3m7q8r2s4t6v8w0y2z4e --file user-export.zip
개인정보
이 엔드포인트는 개인정보를 포함합니다: 엔드 사용자 프로필. KeenAuth API의 개인정보에서 저장되는 항목, 보관 기간, 삭제 방법을 설명합니다. 어떤 필드에도 특수 범주의 개인정보(건강, 생체 정보, 종교, 정치적 견해, 성적 지향)를 보내지 마십시오.