티켓 메모 추가
지정한 티켓에 메모를 추가합니다. 등록된 메모는 티켓 메모 목록 조회 API로 확인할 수 있습니다.
필요 권한
사용자 이상의 계정으로 이용할 수 있습니다.
HTTP 요청
POST /api/sonar/tickets/:ticket_guid/comments
cURL 예시
curl -H "Authorization: Bearer <API_KEY>" \
-d 'format=MARKDOWN' \
-d 'content=* 방화벽에서 IP 차단 완료' \
-X POST \
https://HOSTNAME/api/sonar/tickets/638cfeb2-e259-46af-961a-1eeb65ea35f0/comments
요청 매개변수
경로 매개변수
| 키 | 타입 | 설명 | 비고 |
|---|---|---|---|
| ticket_guid | 문자열 | 티켓 GUID | 36자 |
요청 본문 매개변수
| 키 | 필수 | 타입 | 설명 | 비고 |
|---|---|---|---|---|
| guid | X | 문자열 | 메모 GUID | 36자. 미지정 시 무작위 생성 |
| format | O | 문자열 | 내용 형식 | PLAIN, JSON, MARKDOWN 중 하나 |
| content | O | 문자열 | 메모 내용 |
정상 응답
{}
오류 응답
guid가 GUID 형식이 아닌 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-param-type",
"error_msg": "guid should be guid type."
}
유효하지 않은 형식을 지정한 경우
HTTP 상태 코드 400 응답
{
"error_code": "invalid-argument",
"error_msg": "format should be one of PLAIN, MARKDOWN, JSON."
}
티켓이 존재하지 않는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "ticket not found: 638cfeb2-e259-46af-961a-1eeb65ea35f0"
}
권한이 없는 경우
HTTP 상태 코드 500 응답
{
"error_code": "illegal-state",
"error_msg": "no-permission"
}