본문으로 건너뛰기

무해화 파일 다운로드

무해화 처리가 완료된 파일을 다운로드합니다.

성공 시 파일 바이너리 스트림을 반환하며, 실패 시 JSON 형식의 에러 메시지를 반환합니다.

Important Notes​

  • Prerequisite: 반드시 상태 조회 API(GET /v5/cdr/{jobID})의 응답 code가 0(성공) 또는 1(예외/원본반입) 일 때만 호출해야 합니다.
  • Blocked Files: 정책에 의해 차단된 파일(code: 2)은 다운로드할 수 없습니다.
  • Expiration: 서버의 파일 보관 주기가 지난 파일은 자동 삭제되어 다운로드할 수 없습니다(code: -2). 재요청이 필요합니다.

Method​

GET​

/v5/download/{jobID}

Request Path Parameter​

KEYOBJECTDESC
jobIDString다운로드할 작업 ID (필수)

Response​

1. 성공 (File Download)​

  • Content-Type: application/octet-stream
  • Body: Binary Data (File)

2. 실패 (JSON Error Response)​

  • Content-Type: application/json
KEYOBJECTDESC
jobIDString작업 ID
codeint결과 코드 (아래 테이블 참조)
msgString결과 메시지

Response Code (Failure Case)​

CODEDESCDETAIL
5유효하지 않은 요청 거부잘못된 요청이거나 접근 권한이 없는 경우
3무해화 진행 중아직 완료되지 않은 상태에서 다운로드를 요청한 경우
2정책에 의한 파일 차단차단된 파일은 다운로드할 수 없습니다.
-1알 수 없는 오류서버 내부 오류로 다운로드 불가
-2파일 없음보관 주기가 만료되어 삭제되었거나 존재하지 않는 파일

Sample​

REQUEST​

curl -X GET "{{url}}/v5/download/test-job-001" -O

RESPONSE - 성공​

  • 파일 다운로드가 시작됩니다.

RESPONSE - 실패 (Code: 2, 차단된 파일)​

{
    "jobID": "test-job-001",
    "code": 2,
    "msg": "정책에 의한 파일 차단으로 다운로드 불가"
}

RESPONSE - 실패 (Code: 3, 진행 중)​

{
    "jobID": "test-job-001",
    "code": 3,
    "msg": "무해화가 진행중인 경우"
}