[모바일 신서틱 테스트] 노드 및 노드 그룹 조회¶
GET /api/v1/dialing_task/mobile/resources
개요¶
모바일 신서틱 테스트에 사용할 수 있는 실시간 노드 및 정적 표시 매핑을 조회합니다.
호출 전 및 사용 단계¶
type=mobile을 전달하거나 이 워크스페이스에 이미 mobile taskUUID가 있으면 후자를 우선합니다. 작업을 수정하지 않으며 신서틱 테스트도 실행하지 않습니다. 현재 공개 호출은 실시간 노드만 요청하고 업스트림 노드 그룹은 요청하지 않으므로 groups는 일반적으로 []로 고정됩니다. 활성화할 수 있는 include_groups Query는 없으며, 내부 SDK 파라미터를 추측할 수 없습니다. groups 모드는 기존 템플릿/확인된 그룹 ID와 호환되며, 저장 시 현재 구성원을 다시 확인합니다.
nodes는 실시간 목록과 로컬 정적 매핑의 ID 교집합이며, 지역/통신사/네트워크 유형으로 다시 필터링하지 않습니다. 매핑이 없거나 교집합이 없으면 [] 및 nodeMapping=null/해당 요약을 반환하며, 플랫폼에 절대 노드가 없다는 의미는 아닙니다. 업스트림 실패 시에도 오류를 반환하며, 노드가 없는 것처럼 위장하는 방식으로 다운그레이드하지 않습니다. 리소스 목록 조회 성공이 다음 작업 전송 시에도 사용 가능함을 보장하지는 않습니다. nodes 쓰기는 ID 구조만 검증하며, groups는 그룹과 구성원을 별도로 확인합니다. 기존 id/area/location/isp/clientType은 그대로 유지되며, mapping은 중국어/영어 표시를 통일하는 데 사용됩니다.
요청 헤더¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| DF-API-KEY | string | Y | 워크스페이스의 OpenAPI 인증 자격 증명입니다. 예시: <DF-API-KEY>가져오기 또는 입력 방법: 대상 워크스페이스의 API Key 관리에서 해당 작업 권한이 있는 OpenAPI Key를 가져옵니다. |
Query 요청 파라미터¶
| 파라미터 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| taskUUID | string | 선택 사항입니다. 제공되면 type보다 우선하며, 존재 여부와 실제 유형을 확인합니다. 원격 ID가 아닙니다. 예시: dial_example가져오기 또는 입력 방법: 이 워크스페이스 작업 목록에서 type=mobile인 uuid를 가져옵니다. |
|
| type | string | 선택 사항입니다. type/taskUUID 중 최소 하나를 유효하게 선택해야 하며, taskUUID가 없으면 mobile이어야 합니다. 선택 가능한 값: ['mobile'] 예시: mobile가져오기 또는 입력 방법: 새 모바일 작업을 생성할 때는 type=mobile을 선택하고, 기존 대상이 있으면 taskUUID를 사용할 수도 있습니다. |
파라미터 추가 설명¶
nodes는 vivo 실시간 목록과 데이터베이스 정적 매핑을 문자열 ID로 연결한 평탄화된 교집합입니다. 기존 id/area/location/isp/clientType은 그대로 유지되며, mapping에는 nodeId, continent/country/province/city/operator의 code/zh/en 및 network/client_type이 포함되고, province는 null일 수 있습니다. nodeMapping은 version/sha256 또는 null을 반환합니다. 매핑/일치가 없으면 nodes는 비어 있으며, 업스트림 실패 시에도 오류를 반환하고 groups 계약은 유지됩니다.
요청 예시¶
curl --get 'https://openapi.guance.com/api/v1/dialing_task/mobile/resources' \
-H 'DF-API-KEY: <DF-API-KEY>' \
--data-urlencode type=mobile
응답¶
HTTP 200, application/json입니다. 아래 예시는 바로 읽을 수 있는 주요 필드를 보여줍니다.
| 필드 | 유형 | 설명 |
|---|---|---|
| content.nodes | array<object> | 실시간 노드와 로컬 정적 매핑을 문자열 ID로 연결한 교집합이며, 매핑/일치가 없으면 []입니다. |
| content.nodes[].id | string 또는 integer | 업스트림 원본 노드 ID이며, nodeSelection.ids에 기록할 때는 문자열로 변환해야 합니다. |
| content.nodes[].area | JSON | 업스트림의 기존 영역 필드를 그대로 유지합니다. |
| content.nodes[].location | JSON | 업스트림의 기존 위치 필드를 그대로 유지합니다. |
| content.nodes[].isp | JSON | 업스트림의 기존 통신사 필드를 그대로 유지합니다. |
| content.nodes[].clientType | JSON | 업스트림의 기존 클라이언트 유형을 그대로 유지합니다. |
| content.nodes[].mapping | object | 정적 매핑에서 가져온 표시 정보입니다. |
| content.nodes[].mapping.nodeId | string | 노드 문자열 ID입니다. |
| content.nodes[].mapping.network | string | 정적 네트워크 유형입니다. |
| content.nodes[].mapping.client_type | string | 정적 클라이언트 유형입니다. |
| content.nodes[].mapping.continent | object 또는 null | 정적 지역/통신사 레이블이며, province는 null일 수 있습니다. |
| content.nodes[].mapping.continent.code | string | 출처 코드입니다. |
| content.nodes[].mapping.continent.zh | string | 중국어 이름입니다. |
| content.nodes[].mapping.continent.en | string | 영어 이름입니다. |
| content.nodes[].mapping.country | object 또는 null | 정적 지역/통신사 레이블이며, province는 null일 수 있습니다. |
| content.nodes[].mapping.country.code | string | 출처 코드입니다. |
| content.nodes[].mapping.country.zh | string | 중국어 이름입니다. |
| content.nodes[].mapping.country.en | string | 영어 이름입니다. |
| content.nodes[].mapping.province | object 또는 null | 정적 지역/통신사 레이블이며, province는 null일 수 있습니다. |
| content.nodes[].mapping.province.code | string | 출처 코드입니다. |
| content.nodes[].mapping.province.zh | string | 중국어 이름입니다. |
| content.nodes[].mapping.province.en | string | 영어 이름입니다. |
| content.nodes[].mapping.city | object 또는 null | 정적 지역/통신사 레이블이며, province는 null일 수 있습니다. |
| content.nodes[].mapping.city.code | string | 출처 코드입니다. |
| content.nodes[].mapping.city.zh | string | 중국어 이름입니다. |
| content.nodes[].mapping.city.en | string | 영어 이름입니다. |
| content.nodes[].mapping.operator | object 또는 null | 정적 지역/통신사 레이블이며, province는 null일 수 있습니다. |
| content.nodes[].mapping.operator.code | string | 출처 코드입니다. |
| content.nodes[].mapping.operator.zh | string | 중국어 이름입니다. |
| content.nodes[].mapping.operator.en | string | 영어 이름입니다. |
| content.groups | array<object> | 호환 그룹 배열입니다. 현재 이 공개 호출은 기본적으로 업스트림 그룹을 요청하지 않아 []를 반환하며, 이를 근거로 과거 그룹이 존재하지 않는다고 판단할 수는 없습니다. |
| content.groups[].id | string 또는 integer | 호환 그룹 ID이며, 현재 항목을 생성하지 않습니다. |
| content.groups[].clusterGroupId | string 또는 integer | 기존 그룹 ID와 호환됩니다. |
| content.groups[].name | string | 그룹 이름입니다. |
| content.groups[].description | string | 그룹 설명입니다. |
| content.groups[].clientType | JSON | 그룹 클라이언트 유형입니다. |
| content.groups[].children | array | 호환 그룹 구성원이며, 현재 공개 호출에서는 생성되지 않습니다. |
| content.groups[].children[] | string 또는 integer 또는 object | 업스트림 그룹 구성원 형태이며, 실제 리소스 프로토콜에 따라 처리합니다. |
| content.groups[].children[].id | string 또는 integer | 객체 구성원 ID이며, 생략할 수 있습니다. |
| content.maxSampleCount | integer | 5로 고정되며, 각 노드의 독립 샘플링 상한입니다. |
| content.nodeMapping | object 또는 null | 정적 매핑 버전/요약이며, 사용 가능한 매핑이 없으면 null입니다. |
| content.nodeMapping.version | integer | 매핑 구조 버전이며, 현재 2입니다. |
| content.nodeMapping.sha256 | string | 매핑 콘텐츠 요약이며, 자격 증명 또는 작업 ID가 아닙니다. |
| content.declaration | object | 외부 공통 선언입니다. |
{
"code": 200,
"content": {
"nodes": [
{
"id": "NODE-ID",
"area": "示例区域",
"location": "示例位置",
"isp": "示例运营商",
"clientType": "mobile",
"mapping": {
"nodeId": "NODE-ID",
"network": "mobile",
"client_type": "mobile",
"continent": {
"code": "asia",
"zh": "亚洲",
"en": "Asia"
},
"country": {
"code": "cn",
"zh": "中国",
"en": "China"
},
"province": null,
"city": {
"code": "example",
"zh": "示例城市",
"en": "Example city"
},
"operator": {
"code": "example",
"zh": "示例运营商",
"en": "Example ISP"
}
}
}
],
"groups": [],
"maxSampleCount": 5,
"nodeMapping": {
"version": 2,
"sha256": "SHA256-EXAMPLE"
},
"declaration": {}
},
"errorCode": "",
"message": "",
"success": true,
"traceId": "TRACE-EXAMPLE"
}
오류 응답¶
인증, 속도 제한 및 공통 요청 오류는 공통 오류 정의를 참조하세요.
| HTTP 상태 | errorCode | 트리거 조건 | 메시지 또는 응답 설명 | 처리 방법 |
|---|---|---|---|---|
| 406 | ft.ParameterValidationFailed | 요청 필드가 누락되었거나 필드 값이 선언된 검증 조건을 위반함 | 파라미터 파싱 실패 | 파라미터 위치, 필드 이름, 유형 및 값을 확인하세요. |
| 400 | ft.ParamsValidateError | 식별자, 선택 지점 구조/범위, 이름, 템플릿 수 또는 프로토콜 파라미터가 현재 계약과 일치하지 않음 | 파라미터 검증 실패: {} | message 및 선택적 content.reason/field에 따라 수정하고, 먼저 이 워크스페이스 목록에서 대상을 다시 가져오세요. |
| 400 | ft.InvalidAction | 모바일 신서틱 테스트가 현재 활성화되지 않았거나 허용되지 않는 작업/트랜잭션 상태가 있음 | 유효하지 않은 작업 | 관리자가 모바일 신서틱 테스트 기능을 확인해야 합니다. 템플릿 읽기/삭제는 스위치가 꺼져 있다고 해서 자동으로 금지되지 않습니다. |
| 400 | ft.DialingServerError | 모바일 서비스 호출 실패, 리소스 반환 형태/바인딩 정보 불일치 | 신서틱 테스트 서비스 인터페이스 호출 실패 | reason, outcomeUnknown을 확인하고 traceId와 함께 검토하세요. 정적 매핑 누락으로 업스트림 실패를 감추면 안 됩니다. |
| 404 | ft.NotFoundDialTask | taskUUID가 이 워크스페이스의 삭제되지 않은 작업에 속하지 않음 | 지정된 클라우드 신서틱 테스트를 찾을 수 없음 | 이 워크스페이스 목록에서 mobile UUID를 가져오세요. 일반 작업은 존재하더라도 사용할 수 없습니다. |
| 500 | ft.InternalServerError | 스토리지 읽기, 이전 구성 또는 로컬 정적 매핑 포맷 예외 | 내부 오류 | 특정 작업/템플릿 또는 필터로 범위를 좁히고, 계속 실패하면 traceId를 보관하여 읽기 단계를 확인하세요. |