전화 교환국의 모바일 재고 확인

지원되는 프리픽스 선택

디스커버리에서 현재 개별 모바일 프리픽스를 사용하세요. 이 엔드포인트는 NANPA 교환국을 대상으로 합니다: NPA는 지역 코드를, NXX는 교환국을 식별합니다. 지역 코드만 있는 프리픽스는 범위가 너무 넓습니다. 그룹화된 표시 ID를 보내거나, 다른 국가의 프리픽스에 자릿수가 충분하다는 이유로 해당 국가에 대한 지원을 추론하지 마세요.

카운트를 힌트로 사용

읽을 값은 response.count이고, response.npa 및 response.nxx 항목이 교환국을 식별합니다. 이것은 커버리지 서비스의 스냅샷이며 귀하 계정에 보유된 재고가 아닙니다. 주문하기 전에 실제 번호, 적용되는 견적 및 등록 요건을 확인하세요. 카운트가 성공하더라도 구매가 승인되는 것은 결코 아닙니다.

재고 없음과 조회 실패 구분

카운트가 영인 성공 응답은 API 오류와 다릅니다. status.code 및 status.msg 항목과 HTTP 상태를 확인하세요. 시간 초과나 조회 실패는 가용성 알 수 없음으로 취급하고 나중에 백오프와 함께 재시도하세요.

요청

활성화된 API 계정 자격 증명을 HTTPS로 사용하세요. Basic 인증 및 활성화된 API 계정 베어러 토큰이 지원됩니다. 계정 제한이 적용됩니다.

GET 메서드로 URL 경로에 프리픽스 식별자를 지정합니다. 문서화된 쿼리 또는 본문 매개변수는 없습니다.

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

경로 매개변수
이름	유형	필수	설명
`prefix_id`	string	예	디스커버리 응답에서 개별 프리픽스 ID를 복사하세요. 지역 코드만 있는 프리픽스나 그룹화된 요약 ID가 아니라 지역 코드(NPA)와 교환국(NXX)을 포함하는 지원되는 NANPA 모바일 프리픽스를 사용하세요. 식별자는 불투명한 값으로 취급하세요.

응답

JSON 본문에서 status.code 항목과 HTTP 상태를 함께 확인하세요. 성공한 response 객체에는 status.code 200 및 status.msg Results 값이 있습니다. response 객체는 목록이 아닙니다. count 값은 정수 재고 스냅샷이며 npa 및 nxx 값은 세 글자 문자열입니다. status.results 필드는 이 연관 객체에 존재하지 않습니다. 카운트가 0이면 커버리지 조회에서 일치하는 교환국을 찾지 못했거나 재고가 없는 것으로 반환되었다는 뜻입니다. 모든 공급자나 다른 디스커버리 경로에 번호가 없다는 것을 증명하지 않습니다.

응답 형태의 예시이며 실제 계정 데이터나 현재 견적이 아닙니다.

{
  "status": {
    "code": 200,
    "msg": "Results"
  },
  "response": {
    "count": 42,
    "npa": "212",
    "nxx": "555"
  }
}

오류

404: 공급자 비활성화됨: 이 서비스에서는 모바일 재고 커버리지를 사용할 수 없습니다.
404: 잘못된 프리픽스 ID: 디스커버리에서 현재 개별 프리픽스 ID를 가져오세요.
404: 잘못된 프리픽스: 저장된 프리픽스에 NPA/NXX 조회에 필요한 자릿수가 부족합니다.
500: 재고 커버리지 실패: 업스트림 조회가 성공적인 커버리지 결과를 반환하지 않았습니다. 나중에 백오프와 함께 재시도하세요. 실패는 재고 없음을 뜻하는 카운트가 아닙니다.

가용성 및 부작용

이 작업은 재고를 확인하며 주문을 하거나 번호를 예약하거나 구매 금액을 차감하지 않습니다.
재고는 즉시 변경될 수 있습니다. 커버리지 카운트는 계정별 구매 가능성이나 다음 번호 검색 응답과 같은 길이를 약속하도록 조정되지 않습니다.
조회는 커버리지 서비스에 연결되며 시간이 걸릴 수 있습니다. 모든 프리픽스를 반복적으로 폴링하거나 시간 초과/오류를 성공적인 재고 없음으로 취급하지 마세요.