【모바일 테스트】노드 선택 템플릿 상세¶
GET /api/v1/dialing_task/mobile/templates/{template_uuid}
개요¶
단일 모바일 테스트 노드 선택 템플릿을 읽습니다.
호출 전 및 사용 단계¶
저장된 스냅샷을 읽으며 실행 플랫폼에 실시간으로 액세스하지 않습니다. 모바일 테스트 스위치가 꺼져 있어도 읽을 수 있습니다. 목록이 구성되지 않은 경우 []를 반환하며, 페이지네이션하지 않고 정렬을 보장하지 않으며, 수량 상한은 저장 API에서 제어합니다. 템플릿에는 이름과 노드 선택만 포함되고 HTTP/TCP 대상 또는 프로토콜 구성은 포함되지 않으며, 사용 시 nodeSelection을 새 작업에 복사합니다.
selectedNodeMappings는 nodes의 정적 표시 정보만 보완하며, groups이거나 매핑이 누락된 경우 비어 있을 수 있습니다. 읽기에 성공하더라도 해당 ID가 현재 온라인 상태임을 보장하지 않습니다. 편집/삭제에는 현재 워크스페이스의 templateUUID를 사용합니다. 템플릿을 수정해도 저장된 작업은 자동으로 업데이트되지 않습니다.
라우트 파라미터¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| template_uuid | string | Y | 작업 UUID 또는 nodeSelection.ids의 멤버가 아닙니다. 예: dsel_example가져오기 또는 입력 방법: 노드 선택 템플릿 목록에서 현재 워크스페이스의 templateUUID를 가져옵니다. |
요청 헤더¶
| 파라미터명 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
파라미터 추가 설명¶
반환되는 각 템플릿 항목에는 selectedNodeMappings 배열이 포함되며, 요소는 resources.nodes[].mapping을 재사용합니다: nodeId:string, continent/country/province/city/operator:{code,zh,en}|null, network/client_type:string. nodeSelection.ids의 현재 데이터베이스 표시 매핑만 가져오며, ID를 문자열로 변환하고 중복을 제거하며, 찾을 수 없으면 건너뜁니다. 매핑이 없거나 groups 모드이면 []를 반환합니다. 표시 정보는 실시간 사용 가능 여부를 나타내지 않으며, 목록 배치는 매핑을 한 번만 읽습니다. 이 필드는 읽기 전용이며 영구 저장되지 않으므로 저장 시 다시 전송해서는 안 됩니다. 기존의 실시간 리소스 및 선택 유효성 검사는 유지됩니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/dialing_task/mobile/templates/dsel_example' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.templateUUID | string | dsel_ 워크스페이스 내 템플릿 UUID이며 작업 또는 노드 ID가 아닙니다. |
| content.name | string | trim 처리된 템플릿 이름입니다. |
| content.nodeSelection | object | 노드 선택 스냅샷을 저장하며 작업에 복사되고 실시간 참조가 아닙니다. |
| content.nodeSelection.mode | string | nodes/groups. |
| content.nodeSelection.ids | array<string> | 비어 있지 않고 중복이 없는 원본 노드 또는 그룹 ID 배열입니다. 저장 전 중복을 거부하며 원본 ID/순서를 유지하고 region UUID는 전달할 수 없습니다. |
| content.nodeSelection.ids[] | string | 해당 리소스 id입니다. |
| content.nodeSelection.sampleCount | integer | 각 노드의 독립 샘플링 횟수(1..5)입니다. |
| content.selectedNodeMappings | array<object> | nodes에 대한 선택된 정적 매핑만 제공하며 실시간 사용 가능 여부는 조회하지 않습니다. 누락되었거나 groups이면 []입니다. |
| content.selectedNodeMappings[].nodeId | string | 노드 문자열 ID입니다. |
| content.selectedNodeMappings[].network | string | 정적 네트워크 유형입니다. |
| content.selectedNodeMappings[].client_type | string | 정적 클라이언트 유형입니다. |
| content.selectedNodeMappings[].continent | object 또는 null | 정적 지역/통신사 레이블이며 province는 null일 수 있습니다. |
| content.selectedNodeMappings[].continent.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].continent.zh | string | 중국어 이름입니다. |
| content.selectedNodeMappings[].continent.en | string | 영어 이름입니다. |
| content.selectedNodeMappings[].country | object 또는 null | 정적 지역/통신사 레이블이며 province는 null일 수 있습니다. |
| content.selectedNodeMappings[].country.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].country.zh | string | 중국어 이름입니다. |
| content.selectedNodeMappings[].country.en | string | 영어 이름입니다. |
| content.selectedNodeMappings[].province | object 또는 null | 정적 지역/통신사 레이블이며 province는 null일 수 있습니다. |
| content.selectedNodeMappings[].province.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].province.zh | string | 중국어 이름입니다. |
| content.selectedNodeMappings[].province.en | string | 영어 이름입니다. |
| content.selectedNodeMappings[].city | object 또는 null | 정적 지역/통신사 레이블이며 province는 null일 수 있습니다. |
| content.selectedNodeMappings[].city.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].city.zh | string | 중국어 이름입니다. |
| content.selectedNodeMappings[].city.en | string | 영어 이름입니다. |
| content.selectedNodeMappings[].operator | object 또는 null | 정적 지역/통신사 레이블이며 province는 null일 수 있습니다. |
| content.selectedNodeMappings[].operator.code | string | 소스 코드입니다. |
| content.selectedNodeMappings[].operator.zh | string | 중국어 이름입니다. |
| content.selectedNodeMappings[].operator.en | string | 영어 이름입니다. |
| content.declaration | object | 공통 선언입니다. |
{
"code": 200,
"content": {
"templateUUID": "dsel_example",
"name": "生产节点",
"nodeSelection": {
"mode": "nodes",
"ids": [
"NODE-ID"
],
"sampleCount": 1
},
"selectedNodeMappings": [],
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의에서 확인합니다.
| HTTP 상태 | errorCode | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 400 | ft.ParamsValidateError | 식별자, 노드 선택 구조/범위, 이름, 템플릿 수 또는 프로토콜 파라미터가 현재 계약과 일치하지 않음 | 파라미터 유효성 검사 실패: {} | message와 선택적 content.reason/field에 따라 수정하고, 먼저 현재 워크스페이스 목록에서 대상을 다시 가져옵니다. |
| 500 | ft.InternalServerError | 스토리지 읽기, 과거 구성 또는 로컬 정적 매핑 형식 지정 예외 | 내부 오류 | 구체적인 작업/템플릿 또는 필터로 범위를 좁히고, 계속 실패하면 traceId를 보관하여 읽기 단계를 확인합니다. |