소명 요청 제출
소명 요청에 대한 답변을 제출합니다. 게스트 접근이 허용되므로 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 | 문자열 | 소명 요청 GUID | 36자 |
본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| type | O | 문자열 | 소명 유형 | EXPLANATION, AUDITOR_COMMENT, MANAGER_COMMENT 중 하나 |
| token | X | 문자열 | 게스트 접근 토큰 | 세션 인증 대신 사용 가능 |
| status | O | 문자열 | 소명 상태 | |
| result | O | 32비트 정수 | 소명 결과 코드 | |
| content | O | 문자열 | 소명 내용 |
정상 응답
{}
오류 응답
권한이 없는 경우
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"
}