무해화 파일 다운로드

무해화 처리가 완료된 파일을 다운로드합니다.
성공 시 파일 바이너리 스트림을 반환하며, 실패 시 JSON 형식의 에러 메시지를 반환합니다.

정보

Important Notes

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

1. API 개요

1.1 API 목록

처리가 완료된 파일(무해화되었거나, 정책 예외로 원본 반입된 경우)을 제공합니다.

Method	API	설명
GET	`/v5/download/{jobID}`	CDR 파일 다운로드를 요청합니다.

Base URL

http://{IP 또는 도메인}:{PORT}

항목	내용
기본 포트	`8060` (환경에 따라 80 포트로 구성될 수 있습니다)
인코딩	`UTF-8`

경고

중요

GET /v5/cdr 상태 조회(또는 동기 무해화 응답) 후 code 값이 0(성공) 혹은 1(예외) 인 경우에만 /v5/download 를 호출합니다.
차단된 파일에 대해서는 다운로드를 제공하지 않습니다.

결과 code의 상세 의미는 무해화 결과 응답을 참조합니다.

2. 파일 다운로드

2.1 API 정보

GET /v5/download/{jobID}

Request Path Parameter

Field	Type	Required	Description
`jobID`	String	Y	무해화 요청 작업에 대한 ID. 요청 시 채번한 값 또는 요청 응답으로 반환된 값을 사용합니다. 최대 36자.

2.2 성공 응답 (파일 다운로드)

처리가 완료된 파일을 제공합니다. (무해화 처리되었거나, 정책 예외로 원본 반입된 경우)

항목	값
HTTP Status	`200 OK`
Content-Type	`application/octet-stream`
Body	Binary Data (파일 본체)
Encoding	UTF-8

code: 1(정책 예외)인 경우 무해화하지 않은 원본 파일이 반환됩니다.

2.3 실패 응답 (JSON)

다운로드가 불가능한 경우에만 발생하는 코드입니다. 정책에 의해 차단되었거나, 보관 기간 만료로 파일이 제거된 경우 등이 해당합니다.

항목	값
HTTP Status	`200 OK`
Content-Type	`application/json`

Field	Type	Description
`jobID`	String	무해화 요청 작업에 대한 ID
`code`	Integer	다운로드 요청에 대한 결과
`msg`	String	`code`에 대한 Description 메시지

code

code	Description
5	유효하지 않은 요청 거부
3	무해화가 진행중인 경우
2	정책에 의한 파일 차단으로 다운로드 불가
-1	알 수 없는 오류가 발생 (다운로드 불가능한 상태)
-2	다운로드 할 파일이 없는 경우 (서버에 파일 보관 주기를 지난 경우 제거됨. 새롭게 무해화 요청 필요)

2.4 Sample

REQUEST

curl -X GET "http://{IP}:8060/v5/download/test-job-001" -O -J

RESPONSE — 성공

파일 바이너리가 반환됩니다. (Content-Type: application/octet-stream)

RESPONSE — 차단된 파일 (code 2)

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

RESPONSE — 진행 중 (code 3)

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

RESPONSE — 파일 없음 (code -2)

{
  "jobID": "test-job-001",
  "code": -2,
  "msg": "다운로드 할 파일이 없는 경우"
}

1. API 개요​

1.1 API 목록​

2. 파일 다운로드​

2.1 API 정보​

2.2 성공 응답 (파일 다운로드)​

2.3 실패 응답 (JSON)​

2.4 Sample​