メインコンテンツまでスキップ

무해화 엔진 콜벡 요청

무해화 엔진(SDSanAgent)이 무해화 처리 완료 후 결과를 받아 후처리 하는 API이다.


Method

POST

cdrApiService/callback/sanitize/{tenant}

Request Path Parameter

KEYOBJECTDESC
tenantString테넌트 구분자

Request Body (json)

KEYOBJECTDESC
modeString처리 모드(NET 고정)
originalRequestStringString원본 요청 문자열
taskIdString엔진의 작업ID
resultCdrCallbackDto실제 무해화 처리 결과 데이터

result Object (CdrCallbackDto)

KEYOBJECTDESC
codeint처리 결과 코드 (0: 성공, 1: 예외, -1: 차단)
fileIdString최상위 파일 ID
parentIdString부모 파일 ID
childIdString현재 처리 파일 ID
filePathString무해화 결과 파일 경로
logReasonint로그 사유 코드
msgString처리 메시지
resultObject엔진 상태 정보
objectsObject검출된 위협 정보 맵
modulesArray사용된 모듈 정보
debugArray디버그 모듈 정보
errorsObject에러 정보 (선택적)

Response Body (json)

KEYOBJECTDESC
(빈 응답)String처리 완료 시 빈 문자열 반환

Exception Response Body (json)

KEYOBJECTDESC
msgString오류 메시지

Exception Code

HTTP STATUSCODEMESSAGEDESC
400-Invalid empty value found필수 파라미터 누락 또는 null 값
500-Internal Server Error콜백 처리 중 내부 서버 오류

Sample

REQUEST

{
"mode": "file",
"originalRequestString": "original_request_data",
"taskId": "TASK_12345678-1234-1234-1234-123456789012",
"result": {
"code": 0,
"fileId": "80fa0dd5-5e24-11f0-aec5-9f1802aa6861",
"parentId": "6870b62e-c0ca-4b04-94dc-a014ba64c5d1",
"childId": "6870b62e-45bb-4ac9-8e4e-e1e5073f0795",
"errors": {
"msg": "success"
},
"result": {
"status": {
"cdr": {
"currentQueue": 4,
"maxQueue": 4,
"queueStatus": "4 / 4"
},
"endTime": "2025-07-11 15:58:56.183",
"queueTime": "2025-07-11 15:58:54.828",
"startTime": "2025-07-11 15:58:54.868"
}
},
"objects": {
"hyperLink": [
{
"name": "Mauris id ex erat. ",
"data": null,
"type": "FieldHyperlink"
}
]
},
"modules": [
{
"module": "SDDOCXSanitizer.dll",
"version": "6.2025.211.1"
}
],
"debug": [
{
"module": "SDSanAgentService.exe",
"version": "6.2025.211.1"
},
{
"module": "SDSanTaskEx.exe",
"version": "6.25.226.1"
},
{
"module": "SDMergeService.exe",
"version": "1.0.2022.1229"
},
{
"module": "SDArchiveService.exe",
"version": "1.0.2023.411"
},
{
"module": "SDMPMNx.dll",
"version": "6.2025.211.1"
},
{
"module": "RefAspose.dll",
"version": "2.2024.422.70"
},
{
"module": "RefAsposeModule.dll",
"version": "6.2024.422.1"
}
],
"logReason": 200000,
"msg": "success",
"filePath": "E:/SDTmp/SD_OUT/80fa0dd5-5e24-11f0-aec5-9f1802aa6861/6870b62e-c0ca-4b04-94dc-a014ba64c5d1/Unz/SDTmp62e850/docx_1MB_1.docx"
}
}

RESPONSE - Success

""

RESPONSE - Exception

{
"msg": "Invalid empty value found : (childId is null)"
}