콘텐츠로 이동

【모바일 신서틱 테스트】선택 지점 템플릿 삭제



POST /api/v1/dialing_task/mobile/templates/{template_uuid}/delete

개요

현재 워크스페이스의 선택 지점 템플릿 하나를 삭제합니다.

호출 전 및 사용 단계

템플릿 스냅샷만 삭제하며, 신서틱 테스트, 원격 노드 또는 저장된 선택 지점은 삭제하지 않습니다. 모바일 신서틱 테스트 스위치가 꺼져 있어도 삭제할 수 있으며, 약관 재동의는 필요하지 않습니다. 대상 템플릿이 실제로 존재해야 하며, API는 먼저 get으로 이름을 읽은 후 삭제합니다. 존재하지 않는 경우 멱등적으로 성공 처리하여 무시하는 방식이 아니며, 동시 삭제 시 파라미터 오류가 반환될 수 있습니다.

성공 후 작업의 기존 nodeSelection은 원래 스냅샷을 유지하며, 신규 생성 흐름에서는 더 이상 해당 templateUUID를 사용하지 않습니다. 타임아웃 발생 시 템플릿이 여전히 존재하는지 먼저 확인한 후 재시도 여부를 결정합니다.

경로 파라미터

파라미터 이름 타입 필수 설명
template_uuid string Y 삭제할 템플릿 UUID이며 작업/노드 ID가 아닙니다.
예시: dsel_example
획득 또는 입력 방법: 현재 워크스페이스의 템플릿 목록에서 templateUUID를 가져옵니다.

요청 헤더

파라미터 이름 타입 필수 설명
DF-API-KEY string Y 워크스페이스의 OpenAPI 인증 자격 증명입니다.
예시: <DF-API-KEY>
획득 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다.

요청 예시

curl --request POST 'https://openapi.guance.com/api/v1/dialing_task/mobile/templates/dsel_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 트리거 조건 메시지 또는 응답 설명 처리 방법
400 ft.ParamsValidateError 식별자, 선택 지점 구조/범위, 이름, 템플릿 수 또는 프로토콜 파라미터가 현재 계약과 일치하지 않음 파라미터 검증 실패: {} message와 선택적 content.reason/field에 따라 수정하며, 먼저 현재 워크스페이스 목록에서 대상을 다시 가져옵니다.
409 ft.MobileDialingOperationBusy 워크스페이스 뮤텍스 잠금 대기 시간 초과, 이번 작업 미실행 현재 워크스페이스에 다른 작업이 진행 중이어서 이번 작업이 실행되지 않았습니다. 잠시 후 다시 시도하세요. operationExecuted=false/retryable=true인 경우 백오프 후 재시도하며, 동시에 덮어쓰지 않습니다.
401 ft.WKSPNotExistOrReleased 대기 후 워크스페이스가 존재하지 않거나 해제됨 워크스페이스가 존재하지 않거나 해제되었습니다. 재시도를 중지하고 유효한 워크스페이스를 확인합니다.
403 ft.WorkspaceIsLocked 대기 후 워크스페이스가 잠김 워크스페이스가 잠겨 있어 작업할 수 없습니다. 잠금 해제 및 작업 가능 상태를 확인합니다.
406 ft.NotFoundWorkspace 삭제 잠금 시 워크스페이스가 존재하지 않음 지정된 워크스페이스를 찾을 수 없습니다. 워크스페이스가 유효한지 확인합니다.
500 ft.InternalServerError 스토리지 읽기, 이전 구성 또는 로컬 정적 매핑 포맷 예외 내부 오류 특정 작업/템플릿 또는 필터로 범위를 좁히고, 지속적으로 실패하는 경우 traceId를 보관하여 읽기 단계를 확인합니다.

문서 평가

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