사용 가능한 모바일 번호 찾기

모바일 재고가 활성화되어 있는지 확인

이 검색은 고객 계정에 모바일 번호 재고가 활성화된 후에만 사용하세요. 계정의 디스커버리 워크플로를 통해 현재의 개별 모바일 프리픽스를 얻으세요. 지원되는 경로는 해당 프리픽스에 대한 무선 재고를 요청합니다. 일치하는 유선 라우팅 메타데이터 레코드에 의존하지 않습니다. 계정이나 프리픽스가 활성화되어 있는지 확실하지 않으면 지원팀에 문의하세요.

현재의 레거시 경로는 부적격한 요청을 모두 확실하게 거부하지는 않습니다. 모바일 재고가 활성화되지 않은 계정도 일반 재고를 받을 수 있으며, 이 경우에도 응답에는 여전히 info.is_mobile: 1 항목이 표시됩니다. 수신자 부담 프리픽스도 동일한 라벨이 붙은 수신자 부담 재고 분기에 도달할 수 있습니다. 이 라벨만으로 모바일 서비스를 식별하지 말고, 일반 프리픽스나 수신자 부담 프리픽스를 이 엔드포인트로 보내지 마세요. 계정에서 확인된 모바일 카탈로그와 활성화된 워크플로를 사용하세요.

각 번호를 해당 번호의 가격 선택과 함께 유지

각 후보에 대해 number, info.uuid 및 같은 항목의 price 목록을 함께 유지하세요. 응답에는 프리픽스/지역/국가 메타데이터, 계약 조건 및 등록 제한도 포함됩니다. 후보는 첫 번째 가격 옵션의 월 요금을 기준으로 오름차순 정렬되며, 가격이 같은 경우 안정적인 순서는 보장되지 않습니다. 반환된 번호 ID를 지역 ID나 프리픽스 ID로 대체하거나 다른 후보의 가격 ID와 짝지어 사용하지 마세요.

전체 응답에는 추가 메타데이터와 가격 필드가 포함될 수 있습니다. 반환된 features, 채널 값 및 restrictions 항목은 후보를 설명할 뿐이며, 통화, SMS, MMS 또는 팩스를 이미 사용할 수 있다는 보장은 아닙니다. 계정 권한, 등록 및 선택한 서비스 요금제는 여전히 적용됩니다. 예시의 플레이스홀더를 유효한 ID나 가격으로 취급하지 마세요.

작은 양수 수량 사용

수량 1로 시작하세요. 일반 공급자 요청은 양수가 아닌 수량을 1로 정규화하고 업스트림 값을 300으로 제한하지만, 이후의 결과 처리에서는 여전히 원래 입력을 사용합니다. 따라서 수량에 영을 지정하면 업스트림 재고를 요청하면서도 후보를 하나도 반환하지 않을 수 있습니다. 다른 레거시 분기는 요청된 결과 수를 일관되게 적용하지 않습니다. 단일한 보편적 최댓값에 의존하거나 음수, 소수 또는 숫자가 아닌 값을 보내지 마세요. 이 경로에 대해 지원되는 공개 검색 필터나 가격 ID 본문 매개변수는 문서화되어 있지 않습니다.

재고 없음과 조회 실패 구분

404 응답은 재고 없음, 비활성화된 서비스, 공급업체 조회 실패 또는 잘못된 카탈로그 레코드를 나타낼 수 있습니다. 타임아웃이나 공급자 장애는 확인된 재고 없음이 아니라 가용성 불명으로 취급하세요. 적절한 경우 선택을 새로 고치고 백오프를 적용하여 재시도하세요. 모든 교환국 프리픽스를 반복적으로 폴링하지 마세요. 별도의 모바일 재고 수 엔드포인트는 스냅샷 힌트일 뿐이며 이 계정의 후보 목록 길이와 일치하지 않을 수 있습니다.

구매 전 재확인

검색은 재고를 예약하지 않습니다. 검토된 분기는 이미 구매된 번호를 제외하려고 시도하지만, 로컬 예약 조회가 실패하면 그러한 후보가 결과에 남아 있을 수 있습니다. 가용성, 소유권, 승인된 가격 및 등록은 구매 워크플로에서 확인해야 합니다. 보호된 구매 요청에는 새로운 선택을 사용하고, 구매 결과가 불확실한 경우 재시도하기 전에 계정 재고를 대조하세요. 후보가 반환되었다는 이유만으로 구매하지 마세요.

요청

허용된 소스 IP 주소에서 HTTPS를 통해 활성화된 API 계정을 사용하세요. 고객 계정에 모바일 재고도 활성화되어 있어야 하며, API 인증만으로는 활성화되지 않습니다.

GET 요청의 URL 경로에 현재의 개별 프리픽스 식별자와 양의 정수 수량을 지정합니다. 수량을 생략하면 기본값은 1입니다. 예시에서는 1을 사용하세요. 이 경로는 보편적인 결과 제한을 일관되게 검증하거나 적용하지 않습니다.

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

응답

HTTP 상태와 함께 JSON 본문의 status.code 및 status.msg 를 확인하세요. 성공하면 response 는 번호 후보 목록이고, status.msg 는 Results: 뒤에 반환된 개수가 이어지는 값이며, status.results 는 직렬화된 목록의 길이입니다. 후보 가격은 계정별로 다릅니다. 설명용 축약 예시는 실제 재고나 요금 견적 대신 플레이스홀더를 사용합니다. 번호에는 더하기 기호 없이 국가 코드가 포함되며, 식별자는 불투명한 문자열입니다.

설명용 응답 형태이며, 실제 계정 데이터나 현재 견적이 아닙니다.

{
  "status": {
    "code": 200,
    "msg": "Results: 1",
    "results": 1
  },
  "response": [
    {
      "number": "12025550123",
      "info": {
        "uuid": "NUMBER_ID",
        "prefix_uuid": "PREFIX_ID",
        "country_iso": "US",
        "is_mobile": 1
      },
      "price": [
        {
          "uuid": "PRICE_ID",
          "monthly_price": "ACCOUNT_MONTHLY_PRICE",
          "setup_price": "ACCOUNT_SETUP_PRICE",
          "per_minute": "ACCOUNT_INCOMING_RATE",
          "channels": "PLAN_CHANNELS"
        }
      ],
      "features": [
        "voice",
        "sms",
        "mms",
        "t38"
      ]
    }
  ]
}

오류

• 404: 잘못된 프리픽스 ID, 국가 또는 지역: 개별 모바일 프리픽스 선택을 새로 고치세요.
• 404: 번호를 찾을 수 없음: 사용 가능한 재고 없음, 비활성화된 서비스, 공급자 조회 실패, 지원되지 않는 선택 또는 계정 제한을 의미할 수 있습니다. 권위 있는 재고 수가 영이라는 증거는 아닙니다.

가용성 및 부작용

• 검색은 번호를 임대하거나 예약하지 않으며, 검토된 경로는 구매 금액을 차감하지 않습니다. 재고 공급자에 접속하므로 시간이 걸릴 수 있습니다.
• 검색이 성공하면 계정 관련 번호 및 가격 캐시 항목과 쿼리 로그가 기록됩니다. 검색을 반복하는 것은 예약, 가격 고정 또는 구매가 아닙니다.
• 반환된 가격, 조건, 제한 및 기능은 선택한 계정과 번호에 대해 검토해야 합니다. 기능 라벨은 활성화, 메시징 승인 또는 테스트된 서비스 기능을 입증하지 않습니다.