개발자

GET/v3/get_document_countries

등록 대상 국가 목록 조회

현재 전화번호 등록 카탈로그에서 제공하는 국가 ISO 코드와 국가명을 확인합니다.

이 페이지의 내용
  1. 등록 대상 국가 선택
  2. 국가가 목록에 없는 경우
  3. 요청
  4. 응답
  5. 오류
  6. 이용 가능 여부 및 부수 효과

등록 대상 국가 선택

전화번호 유형이나 등록 요건을 요청하기 전에 이 응답에서 국가 ISO 코드를 복사하세요. 전화번호 서비스의 해당 국가를 사용하세요. 고객의 국적이나 주소에 해당하는 국가를 그대로 사용하지 마세요.

국가가 목록에 없는 경우

국가가 목록에 없다고 해서 서류가 필요하지 않거나 MultiTEL이 해당 국가의 전화번호를 제공할 수 없다는 뜻은 아닙니다. 등록 대상 선택과 전화번호 검색은 별도로 진행하고, 필요한 국가를 선택할 수 없으면 지원팀에 문의하세요.

요청

활성화된 API 계정의 인증 정보를 사용하여 HTTPS로 접속하세요. 기본 인증과 활성화된 API 계정의 베어러 토큰을 지원하며, 계정 제한이 적용됩니다.

GET을 사용하고, 문서에 명시된 매개변수가 있으면 URL 경로에 지정하세요.

curl --fail-with-body --silent --show-error \
  --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/get_document_countries"

응답

HTTP 상태뿐 아니라 JSON 본문의 status.code도 확인하세요. response는 대문자로 된 iso 및 name 문자열을 포함하며 국가명순으로 정렬된 배열입니다. 이 등록 카탈로그는 전화번호 재고 검색 및 주소에 사용하는 일반 국가 목록과 다릅니다. 모든 국가 또는 상위 시스템 결과에서 조회 가능한 모든 페이지가 반환되었음을 보장하지 않습니다.

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

{
  "status": {
    "code": 200,
    "msg": "",
    "results": 1
  },
  "response": [
    {
      "iso": "US",
      "name": "United States"
    }
  ]
}

오류

  • 500: Unable to load available registration countries: 등록 대상 국가 조회에서 데이터를 제공하지 않았습니다. 나중에 다시 시도하세요. 정상적으로 조회된 빈 카탈로그로 처리하지 마세요.

이용 가능 여부 및 부수 효과

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