CDR 무해화 상태 조회

접수된 무해화 요청의 진행 상태를 조회합니다.
작업 ID(jobID)를 키로 무해화 진행 상태를 조회합니다.

Important Notes

• Polling Frequency: 상태 조회 주기는 200ms를 권장합니다. 너무 빈번한 요청(예: 루프 내 즉시 호출)은 DDoS 공격으로 간주되어 차단될 수 있습니다.
• Flow: 상태 코드(code)가 0 또는 1일 때만 파일 다운로드 API(GET /v5/download/{jobID})를 호출해야 합니다.
• Response Format: 모든 응답은 200 OK HTTP 상태 코드를 가지며, 실제 결과는 JSON 바디의 code 필드로 구분합니다.

---

Method

GET

/v5/cdr/{jobID}

---

Request Path Parameter

KEY	OBJECT	DESC
jobID	String	상태를 조회할 작업 ID (필수)

---

Response Body (json)

KEY	OBJECT	DESC
jobID	String	작업 ID
code	int	상태 코드 (아래 테이블 참조)
msg	String	상태 메시지
logReason	int	상세 로그 사유 코드

---

Response Code

CODE	DESC	DETAIL
0	파일 재구성 완료 (무해화 성공)	안전한 파일이 생성되었으므로 다운로드 가능합니다.
1	정책에 의한 무해화 생략 (원본반입)	정책에 따라 원본 파일이 반입되었습니다. 다운로드 가능합니다.
2	파일 차단	위협 요소 발견 또는 차단 정책에 의해 파일이 제거되었습니다. 다운로드 불가합니다.
3	무해화 작업 진행 중	아직 처리가 완료되지 않았습니다. 잠시 후 다시 조회하세요.
5	유효하지 않은 요청 거부	잘못된 요청이거나 접근 권한이 없는 경우입니다.
-1	서버 내부 에러	알 수 없는 오류가 발생했습니다.
-3	존재하지 않는 작업 ID	잘못된 ID이거나 보관 기간이 만료된 작업입니다.

---

Sample

REQUEST

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

RESPONSE - 성공 (Code: 0)

{
  "jobID": "test-job-001",
  "code": 0,
  "msg": "파일 재구성 완료",
  "logReason": 200000
}

RESPONSE - 예외 (Code: 1)

{
    "jobID": "test-job-001",
    "code": 1,
    "msg": "[예외] 비밀번호 보호 문서 파일 원본 반입",
    "logReason": 230243
}

RESPONSE - 차단 (Code: 2)

{
    "jobID": "test-job-001",
    "code": 2,
    "msg": "[차단] 확장자 위변조 파일 차단",
    "logReason": 220355
}

RESPONSE - 진행 중 (Code: 3)

{
  "jobID": "test-job-001",
  "code": 3,
  "msg": "무해화 작업 진행 중",
  "logReason": 100001
}

RESPONSE - 작업 ID 없음 (Code: -3)

{
  "jobID": "test-job-001",
  "code": -3,
  "msg": "JobId does not exist",
}

---

Processing Flow

• 여기서 부터는 외부에 공개하지 않아야하는, 개발 정보 입니다.

---