콘텐츠로 이동

답글 삭제



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를 제공합니다.

문서 평가

이 페이지가 도움이 되었나요?