Skip to main content

멀웨어 검사 상태 조회

멀웨어 검사 요청 후 검사 진행 상태 및 결과를 조회합니다.

Notes​

  • Polling: 검사가 진행 중(code: 3)인 경우, 500ms 후 다시 조회해야 합니다.
  • Virus Names: 여러 바이러스가 검출된 경우 쉼표로 구분되어 scanMessage에 반환됩니다.

Method​

GET​

/inspection/malware/{jobId}

Request Path Parameter​

KEYOBJECTDESC
jobIdString검사 요청 시 받은 작업 ID (필수)

Response Body (json)​

KEYOBJECTDESC
codeint검사 결과 코드 (아래 테이블 참조)
msgString결과 메시지
jobIdString작업 ID
logReasonint로그리즌 코드
scanMessageString악성코드 검출 시 악성코드명 (선택적)

Response Code​

CODEDESCDESC_DETAIL
0검사 완료검사가 정상 완료되었습니다. logReason으로 미검출(990001) 또는 검출(990003)을 구분합니다.
1검사 예외파일 크기 초과, 백신 미사용, 중복 요청, 대기열 초과 등으로 검사가 실행되지 않았습니다.
2검사 오류백신 서비스 통신 오류, 엔진 오류, 요청 오류 등 검사 중 오류가 발생했습니다.
3검사 진행중현재 파일에 대해 바이러스 검사를 진행 중입니다.
5접근 차단API 접근제어에 의해 요청이 차단되었습니다.

Log Reason Code​

상태 조회에서 반환되는 결과입니다.

진행 중​

code: 3​

CODEMESSAGEDESC
990017백신 검사 대기 중요청이 접수되어 대기열에서 처리 대기 중입니다.
990002백신 검사 진행 중현재 파일에 대해 바이러스 검사를 진행 중입니다.

성공​

code: 0​

CODEMESSAGEDESC
990001바이러스 미검출바이러스가 검출되지 않았습니다.
990002백신 검사 진행중현재 파일에 대해 바이러스 검사를 진행 중입니다.
990003[차단] 바이러스 검출 (감염 파일 삭제)업로드하신 파일에서 바이러스가 탐지되었습니다.

예외​

code: 1​

CODEMESSAGEDESC
990008[예외] 백신 검사 파일 크기 초과파일 크기가 백신 검사 제한 크기를 초과하여 검사가 수행되지 않았습니다.
990010[예외] 중복 작업 ID 검사 요청기존에 사용된 작업 ID로, 검사 요청을 수행하지 않았습니다. 다른 작업 ID를 사용해 주세요
990011[예외] 백신 검사 미사용백신 검사 기능이 비활성화되어 있습니다.
990015[예외] 백신 검사 대기열 초과서버의 처리 대기열이 가득차 요청을 수락하지 못했습니다. 잠시 후 다시 시도해 주세요

오류​

code: 2​

CODEMESSAGEDESC
990007[오류] 백신 서비스 통신 오류백신 서비스와 통신 과정 중 오류가 발생하여 검사하지 못했습니다.
990013[오류] 백신 서비스 오류백신 엔진의 검사 과정중 오류가 발생하여 검사하지 못했습니다.
990014[오류] 백신 검사 요청 오류백신 서비스로 요청 전 오류가 발생하여 검사하지 못했습니다.
990016[오류] 백신 검사 시간 초과백신 엔진의 검사 시간이 초과되어 결과를 제공할 수 없습니다.

Sample​

REQUEST​

curl -X GET "{{url}}/inspection/malware/8bc422e1-af1b-11f0-bf7b-7117406ac6f5"

RESPONSE - 백신 검사 진행중 (200 OK)​

{
   "code": 3,
   "msg": "현재 파일에 대해 바이러스 검사를 진행 중입니다.",
   "jobId": "8bc422e1-af1b-11f0-bf7b-7117406ac6f5"
}

RESPONSE - 바이러스 미검출 (200 OK)​

{
   "code": 0,
   "msg": "바이러스가 검출되지 않았습니다.",
   "jobId": "8bc422e1-af1b-11f0-bf7b-7117406ac6f5",
   "logReason": 990001
}

RESPONSE - [차단] 바이러스 검출 (감염 파일 삭제) (200 OK)​

{
   "code": 0,
   "msg": "업로드하신 파일에서 바이러스가 탐지되었습니다.",
   "jobId": "f89d9593-af1b-11f0-bf7b-7117406ac6f5",
   "logReason": 990003,
   "scanMessage": "Trojan.Jeki.2"
}

RESPONSE - [예외] 백신 검사 파일 크기 초과 (200 OK)​

{
   "code": 1,
   "msg": "파일 크기가 백신 검사 제한 크기를 초과하여 검사가 수행되지 않았습니다.",
   "jobId": "18ae81f4-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990008
}

RESPONSE - [예외] 백신 검사 미사용 (200 OK)​

{
   "code": 1,
   "msg": "백신 검사 기능이 비활성화되어 있습니다.",
   "jobId": "7f3e9a21-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990011
}

RESPONSE - [예외] 중복 작업 ID 검사 요청 (200 OK)​

{
   "code": 1,
   "msg": "기존에 사용된 작업 ID로, 검사 요청을 수행하지 않았습니다. 다른 작업 ID를 사용해 주세요",
   "jobId": "e3b8c7d2-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990010
}

RESPONSE - [예외] 백신 검사 대기열 초과 (200 OK)​

{
   "code": 1,
   "msg": "서버의 처리 대기열이 가득차 요청을 수락하지 못했습니다. 잠시 후 다시 시도해 주세요",
   "jobId": "c4d7f3e2-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990015
}

RESPONSE - [오류] 백신 서비스 통신 오류 (200 OK)​

{
   "code": 2,
   "msg": "백신 서비스와 통신 과정 중 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "d5c6dd09-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990007
}

RESPONSE - [오류] 백신 서비스 오류 (200 OK)​

{
   "code": 2,
   "msg": "백신 엔진의 검사 과정중 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "a9f2c153-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990013
}

RESPONSE - [오류] 백신 검사 요청 오류 (200 OK)​

{
   "code": 2,
   "msg": "백신 서비스로 요청 전 오류가 발생하여 검사하지 못했습니다.",
   "jobId": "b2d1e764-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990014
}

RESPONSE - [오류] 백신 검사 시간 초과 (200 OK)​

{
   "code": 2,
   "msg": "백신 엔진의 검사 시간이 초과되어 결과를 제공할 수 없습니다.",
   "jobId": "6f5a2b91-af1c-11f0-bf7b-7117406ac6f5",
   "logReason": 990016
}

RESPONSE - Access Denied (200 OK)​

{
   "code": 5,
   "msg": "Sanitization Request Blocked by API Access control.",
   "jobId": "52617927-af1c-11f0-bf7b-7117406ac6f5"
}

Processing Flow​

  • 해당 플로우는 참고용으로 고객에게 제공 X