답글 삭제¶
DELETE /api/v1/issue/reply/{reply_uuid}/delete
개요¶
현재 워크스페이스의 일반 답글 1건을 삭제하고, 연관된 첨부 파일과 후속 알림을 처리합니다.
호출 전 및 사용 단계¶
답글 목록에서 답글 uuid를 가져온 뒤 확인하고 DELETE를 전송합니다. 요청 본문은 필요하지 않습니다. 성공하면 답글 기록이 삭제로 표시되고, 연관된 첨부 파일은 삭제 절차에 따라 정리됩니다. 이 API는 워크스페이스와 답글 기록 상태를 기준으로 대상을 찾으며, 실제 작업 권한은 API 권한으로 제어됩니다. 답글 수정과 달리 creator가 현재 호출자와 같아야 한다는 조건은 추가로 요구되지 않습니다. 중복 삭제는 일반적으로 리소스가 존재하지 않는다는 응답을 반환하므로, 먼저 현재 상태를 확인해야 합니다. 삭제 알림은 Issue에 연결된 채널의 알림 정책 및 일정에 따라 비동기로 전송되며, 일반 채널 구독자, 담당자, 이번 @ 대상은 삭제 알림 수신자에 직접 포함되지 않습니다. 성공 응답이 알림 전송 완료를 의미하지는 않습니다. 쓰기와 후속 알림, 첨부 파일 처리는 단계별로 수행되므로, 실패하거나 타임아웃된 경우에는 리소스가 이미 생성 또는 업데이트되었는지 먼저 조회한 뒤 재시도 여부를 결정하여 중복 기록과 알림을 방지합니다.
경로 파라미터¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| reply_uuid | string | Y | 단일 답글 UUID이며, Issue UUID를 사용하지 마세요. 예시: repim_example가져오기 또는 입력 방법: 답글 목록의 content.data[].uuid 또는 답글 생성의 content.uuid에서 가져옵니다. |
요청 헤더¶
| 파라미터 이름 | 타입 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
파라미터 추가 설명¶
답글 삭제는 Issue 삭제와 다릅니다. 예외가 반환되면 먼저 답글이 여전히 존재하는지 조회한 뒤 재시도 여부를 결정합니다.
요청 예시¶
curl --request DELETE 'https://openapi.guance.com/api/v1/issue/reply/repim_example/delete' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여 줍니다.
| 필드 | 타입 | 설명 |
|---|---|---|
| content | boolean | 삭제 절차가 성공하면 true를 반환합니다. |
{
"code": 200,
"content": true,
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참고하세요.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 404 | ft.ObjectNotExists | 지정한 리소스가 현재 워크스페이스에 없거나 조회 조건에 부합하지 않음 | 지정한 객체가 존재하지 않음 | 동일 워크스페이스의 리소스 UUID를 다시 가져오고, 이미 삭제되었는지 확인합니다. |
| 500 | ft.InternalServerError | 등급 또는 구성 저장, 감사 또는 기타 내부 처리 실패 | 내부 오류 | 먼저 현재 등급 또는 구성을 조회하여 결과를 확인한 뒤 재시도 여부를 결정하고, 지속적으로 실패하면 traceId를 제공합니다. |