할당 테이블에 포함되는지 확인
북미 번호가 MultiTEL의 할당 테이블에 있는 접두부와 일치하는지 확인하고, 해당 도시, 주 및 국가 정보를 가져옵니다. 이는 접두부 테이블 조회입니다. 가입자가 활성 상태인지, 번호가 배정되었는지, 해당 번호가 사용자의 계정에 속하는지, 또는 주문할 수 있는지를 확인해 주지는 않습니다.
요청
활성화된 API 계정과 허용된 출발지 IP 주소를 사용하세요. 예제에서는 환경 변수에 저장된 HTTP Basic 인증 정보와 가상의 번호를 사용합니다. 요청 본문은 필요하지 않습니다.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/nanpacheck/120255501231로 시작하는 열한 자리 북미 번호를 사용하는 것이 좋습니다. 핸들러는 숫자가 아닌 문자를 제거하고, 열 자리 입력의 맨 앞에 1을 추가합니다. 그 외의 자릿수는 거부됩니다. 이 정규화 과정은 북미 번호 체계의 모든 규칙을 검증하지 않으므로, 테이블에서 일치하는 항목을 찾았다고 해서 번호가 완전히 검증된 것은 아닙니다.
응답
필드 값은 설명을 위한 예시일 뿐이며, 실제 운영 중인 할당 테이블의 조회 결과가 아닙니다.
{
"status": {
"code": 200,
"msg": "12025550123"
},
"response": {
"number": "12025550123",
"npanxx": "1202555",
"city": "Example City",
"state": "DC",
"country": "US"
}
}| 필드 | 의미 |
|---|---|
| number | 숫자만 남도록 정규화된 입력값입니다. |
| npanxx | 저장된 접두부 중 일치하는 값입니다. 핸들러는 국가 번호·지역 번호·국번으로 구성된 일곱 자리 접두부를 우선 사용하며, 일치 항목이 없으면 국가 번호·지역 번호로 구성된 네 자리 접두부로 조회할 수 있습니다. 따라서 이 필드가 항상 국번 전체를 식별한다고 가정해서는 안 됩니다. |
| city, state, country | 일치하는 할당 접두부의 메타데이터입니다. 이 필드들은 가입자의 현재 실제 위치나 번호 이동 후 현재 이용 중인 통신사를 식별하지 않습니다. |
오류
HTTP 200만으로 판단하지 말고 JSON의 status.code 값을 확인하세요. API 코드 404와 메시지 Not part of NANPA는 서비스에서 사용하는 테이블에 일치하는 접두부가 없다는 뜻이며, 전 세계 번호 관리 기관을 기준으로 내린 확정적인 판정은 아닙니다. API 코드 500은 자릿수가 올바르지 않거나 번호가 누락된 경우에 사용됩니다.
비용 및 다음 단계
검토한 핸들러는 로컬 할당 테이블을 조회하며, 계정 잔액 차감이나 외부 조회를 수행하는 로직은 포함하지 않습니다. 이 핸들러는 조회 요금을 부과하지 않습니다. 주문 가능한 번호 재고를 찾으려면 이용 가능한 번호 검색을 사용하세요. 이름 조회, 라우팅 조회 또는 번호 주문은 각각 별개의 작업이며, 해당 계정의 요금이 별도로 적용됩니다.