콘텐츠로 이동

[모바일 신서틱 테스트] 노드 및 노드 그룹 조회



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를 보관하여 읽기 단계를 확인하세요.

문서 평가

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