【모바일 신서틱 테스트】노드 선택 템플릿 목록¶
GET /api/v1/dialing_task/mobile/templates
개요¶
현재 워크스페이스의 모바일 신서틱 테스트 노드 선택 템플릿 목록을 조회합니다.
호출 전 및 사용 단계¶
저장된 스냅샷을 조회하며 실행 플랫폼에 실시간으로 액세스하지 않습니다. 모바일 신서틱 테스트 스위치가 꺼져 있어도 조회할 수 있습니다. 목록이 구성되지 않은 경우 []를 반환하며, 페이지네이션하지 않고 정렬을 보장하지 않으며, 최대 개수는 저장 API에서 제어합니다. 템플릿에는 이름과 노드 선택만 포함되고 HTTP/TCP 대상 또는 프로토콜 구성은 포함되지 않으며, 사용 시 nodeSelection을 새 작업에 복사합니다.
selectedNodeMappings는 nodes의 정적 표시 정보만 보완하며, groups이거나 매핑이 누락된 경우 비어 있을 수 있습니다. 조회에 성공하더라도 해당 ID가 현재 온라인임을 보장하지 않습니다. 편집/삭제에는 현재 워크스페이스의 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' \
-H 'DF-API-KEY: <DF-API-KEY>'
응답¶
HTTP 200, application/json. 아래 예시는 직접 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content | array<object> | 워크스페이스 템플릿 배열이며, 구성이 없으면 []입니다. |
| 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 | 발생 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 500 | ft.InternalServerError | 저장소 읽기, 이전 구성 또는 로컬 정적 매핑 형식 지정 예외 | 내부 오류 | 구체적인 작업/템플릿 또는 필터로 범위를 좁히고, 계속 실패하면 traceId를 보관하여 읽기 단계를 확인하세요. |