소명 요청 제출

소명 요청에 대한 답변을 제출합니다. 게스트 접근이 허용되므로 token 매개변수를 사용하여 세션 인증 없이 호출할 수 있습니다.

HTTP 요청

POST /api/sonar/explanation-requests/:request_guid
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
     -d type=EXPLANATION \
     -d status=SUBMITTED \
     -d result=1 \
     --data-urlencode content="해당 행위는 업무 목적으로 수행한 정상 접근입니다." \
     -X POST \
     https://HOSTNAME/api/sonar/explanation-requests/49272877-75f2-4c2f-9301-d21c4f9a106d
요청 매개변수
경로 매개변수
타입설명비고
request_guid문자열소명 요청 GUID36자
본문 매개변수
필수타입설명비고
typeO문자열소명 유형EXPLANATION, AUDITOR_COMMENT, MANAGER_COMMENT 중 하나
tokenX문자열게스트 접근 토큰세션 인증 대신 사용 가능
statusO문자열소명 상태
resultO32비트 정수소명 결과 코드
contentO문자열소명 내용

정상 응답

{}

오류 응답

권한이 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "no-permission"
}
임직원 정보가 없는 경우

HTTP 상태 코드 500 응답

{
  "error_code": "illegal-state",
  "error_msg": "not-employee"
}
소명 제출이 불가능한 경우

HTTP 상태 코드 500 응답. 소명 가능 여부 조회 API를 통해 사유를 확인할 수 있습니다.

{
  "error_code": "illegal-state",
  "error_msg": "already-submitted"
}