【모바일 신서틱 테스트】선택 지점 템플릿 삭제¶
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를 보관하여 읽기 단계를 확인합니다. |