카탈로그에 등록된 국가 목록 조회(레거시 형식)

이 레거시 엔드포인트는 {"code", "data"} 형식의 본문을 반환합니다. 표준 status/response 응답 래퍼는 사용하지 않습니다. 특수 번호 카탈로그에 연결된 국가 중 표시 대상인 국가를 나열하며, 재고는 확인하지 않습니다.

새로 연동을 구현하는 경우:

• 다음 엔드포인트를 사용하세요: GET /v3/getcountries. 번호 재고가 있는 국가를 찾을 수 있습니다.
• 다음 엔드포인트를 사용하세요: GET /v3/other/{isocode}. 해당 국가에서 실제로 제공하는 특수 번호 유형을 확인할 수 있습니다. 이 목록에 있는 국가라도 해당 엔드포인트에서는 빈 카탈로그가 반환될 수 있습니다.

요청

필수: HTTP Basic 인증 또는 Bearer 토큰('인증 및 API 응답' 참조). 인증에 실패하면 조회가 실행되기 전에 표준 응답 래퍼로 HTTP 401을 반환합니다.

GET 요청을 사용하며, 매개변수와 본문은 없습니다.

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

응답

표준 응답 래퍼를 사용하지 않는 레거시 본문: {code: 200, data: [...]}. status 객체와 msg, results 필드는 없습니다. data에는 국가 목록이 포함되며, 순서는 보장되지 않습니다. 필드: countrycode('+'를 제외한 국가 전화 코드), name, description(name과 같은 값), isocode, latitude, longitude. is_mobile, sms_coverage, next_function 필드는 없습니다. 표시 대상이면서 특수 번호 카탈로그에 연결된 국가가 목록에 포함됩니다. 재고는 확인하지 않으므로 목록에 있는 국가라도 현재 이용 가능한 번호가 없을 수 있습니다. 조건에 맞는 국가가 없으면 data는 null입니다.

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

{
  "code": 200,
  "data": [
    {
      "countrycode": "33",
      "name": "France",
      "description": "France",
      "isocode": "FR",
      "latitude": "46.0000",
      "longitude": "2.0000"
    }
  ]
}

오류

• 401: 인증 정보가 없거나 인증에 실패했습니다. HTTP status 401과 함께 표준 status/response 응답 래퍼로 반환되며, 레거시 본문으로는 반환되지 않습니다.

제공 여부 및 부수 효과

• 조회만 수행합니다. 예약, 주문 또는 어떠한 변경도 수행하지 않습니다.