재고 번호가 있는 국가 목록 조회

여기에서 지역 전화번호 검색을 시작하세요. 목록에는 현재 재고 번호가 있는 국가만 포함됩니다. 이 조회로 예약되는 것은 없습니다.

• 다음 값인 isocode를 getareas, getstates (US 및 CA만 해당) 또는 other에 전달하세요.
• next_function이 항상 가리키는 경로는 v3/getareas/{isocode}입니다. 미국과 캐나다의 경우, getstates를 먼저 호출하여 주 또는 도 단위로 범위를 좁힐 수 있습니다.
• is_mobile 및 sms_coverage는 국가 단위의 플래그이며, 모든 번호에 대해 해당 기능을 보장하지는 않습니다. 미국의 경우, is_mobile 값은 0입니다. 단, 계정에서 미국 휴대전화 번호 사용이 활성화된 경우는 예외입니다.
• 주문을 통해서만 번호를 제공하는 국가는 목록에 표시되지 않습니다. 목록에 없는 국가에 대해서도 getareas 또는 other를 직접 호출할 수 있습니다.
• 특정 순서가 필요하면 목록을 직접 정렬하세요.

조건에 맞는 국가가 없으면 response 값은 null이며, status.code 값은 200입니다.

요청

필수 사항: HTTP Basic 인증 또는 Bearer 토큰(인증 및 API 응답 참조). 인증에 실패하면 조회를 실행하기 전에 HTTP 401로 응답합니다.

본문이 없는 GET 요청입니다. 유일한 매개변수는 선택 사항인 pid이며, 쿼리 문자열로 전달합니다.

curl --user "$API_USER:$API_PASSWORD" 'https://api.multitel.net/v3/getcountries'

응답

표준 응답 래퍼를 사용합니다. 성공 시 status.code는 200, status.msg는 'Results: N', status.results는 N이며, response는 순서가 보장되지 않는 국가 목록입니다. 필드: countrycode('+'를 제외한 국가 전화 코드); name(국가 이름); description(name과 동일한 값); isocode(ISO 3166-1 alpha-2 코드); is_mobile(0 또는 1인 국가 단위 카탈로그 플래그이며, US의 경우 계정에서 US 휴대전화 번호 사용이 활성화되어 있지 않으면 항상 0); sms_coverage(0 또는 1인 국가 단위 카탈로그 플래그); latitude 및 longitude(국가 좌표); next_function('v3/getareas/{isocode}'). 국가는 표시 가능한 상태이고 해당 국가의 번호 접두부 중 하나 이상에 대해 어느 재고 공급원에서든 현재 재고가 있는 경우에만 목록에 표시됩니다. 제공 범위 전체가 주문 전용인 국가(재고 없음)는 목록에 표시되지 않습니다. 이 재고 확인 범위는 getareas에서 적용하는 필터보다 넓으므로, 목록에 있는 국가라도 해당 호출에서 간혹 'No areas found'가 반환될 수 있습니다. 조건에 맞는 국가가 없으면 status.code는 200, status.msg는 'Results: 0'이며, status.results 필드는 없고 response는 null입니다.

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

{
  "status": {
    "code": 200,
    "msg": "Results: 2",
    "results": 2
  },
  "response": [
    {
      "countrycode": "1",
      "name": "United States",
      "description": "United States",
      "isocode": "US",
      "is_mobile": 0,
      "sms_coverage": 1,
      "latitude": "38.0000",
      "longitude": "-97.0000",
      "next_function": "v3/getareas/US"
    },
    {
      "countrycode": "44",
      "name": "United Kingdom",
      "description": "United Kingdom",
      "isocode": "GB",
      "is_mobile": 1,
      "sms_coverage": 0,
      "latitude": "54.0000",
      "longitude": "-2.0000",
      "next_function": "v3/getareas/GB"
    }
  ]
}

오류

• 401: 인증 정보가 없거나 인증에 실패했습니다. HTTP 상태 401로 전송됩니다(인증 및 API 응답 참조).

가용성 및 부수 효과

• 조회만 수행합니다. 어떤 것도 예약하거나 주문하거나 변경하지 않습니다.
• 결과는 요청 시점의 재고를 반영하며, 호출 사이에 달라질 수 있습니다.