개발자

GET/v3/get_document_number_types/{country}

등록 번호 유형 목록 조회

특정 국가의 등록 카탈로그에 현재 포함된 번호 유형 이름을 조회합니다.

이 페이지의 내용
  1. 반환된 이름으로 유형 선택
  2. 그룹 수는 번호 재고가 아닙니다
  3. 요청
  4. 응답
  5. 오류
  6. 이용 가능 여부 및 부수 효과

반환된 이름으로 유형 선택

다음에서 국가를 선택하세요: get_document_countries. 반환된 유형 이름을 다음에 전달하세요: get_requirements. 유형 카탈로그 ID는 접두사 ID, 번호 ID 또는 증빙 범주 ID가 아닙니다.

그룹 수는 번호 재고가 아닙니다

available_groups는 이 카탈로그 조회에서 반환된 그룹 레코드 수를 나타냅니다. 구매 가능한 전화번호 수를 세거나 재고를 예약하지 않으며, 카탈로그가 상위 데이터 소스의 모든 페이지를 조회했음을 보장하지도 않습니다. 해당 번호 재고를 검색하고 견적을 별도로 검토하세요.

요청

활성화된 API 계정의 인증 정보를 HTTPS로 전송하세요. Basic 인증과 활성화된 API 계정의 bearer 토큰을 지원하며, 계정 제한이 적용됩니다.

GET 요청에서는 문서에 명시된 매개변수를 URL 경로에 넣으세요.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_number_types/$COUNTRY_ISO"
경로 매개변수
이름자료형필수 여부설명
countrystring예등록 대상 국가 카탈로그에 있는 두 글자 국가 ISO 코드입니다. 앞뒤 공백이 제거되고 대문자로 변환됩니다.

응답

JSON 본문의 status.code와 HTTP 상태를 모두 확인하세요. response는 id, name, available_groups를 포함하는 배열입니다. name 값을 number_type 값으로 사용하여 get_requirements를 호출하세요. 그 대신 id를 보내지 마세요. available_groups는 해당 유형에 대해 반환된 그룹 레코드 수이며, 전화번호 재고 수나 페이지로 나뉜 전체 결과의 총수가 아닙니다. 반환된 그룹이 없는 유형은 생략됩니다. 우선 정렬 순서는 Local, Mobile, National, Toll Free, Shared Cost, Global이며, 그 뒤에 다른 카탈로그 이름이 이어집니다.

응답 구조를 보여 주는 예시이며, 실제 계정 데이터나 현재 견적이 아닙니다.

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "id": "NUMBER_TYPE_ID_FROM_RESPONSE",
      "name": "Local",
      "available_groups": 3
    }
  ]
}

오류

  • 400: country is required: 등록 대상 국가의 ISO 코드를 제공하세요.
  • 400: Invalid country ISO or no available DID registration country found: 현재 등록 카탈로그에서 국가를 선택하세요. 이 오류가 서류 제출이 필요 없음을 의미하지는 않습니다.

이용 가능 여부 및 부수 효과

  • 이 카탈로그/요건 조회는 신원 정보를 생성하거나, 증빙을 업로드하거나, 번호를 등록하거나, 주문을 접수하지 않습니다.
  • 카탈로그 응답이 성공했다고 해서 제출한 서류가 승인되었거나 선택한 번호를 활성화할 수 있음이 확인된 것은 아닙니다.