구매한 번호 하나 조회

구매한 번호의 레코드 하나와 저장된 설정을 조회합니다. 이 작업은 inventory 엔드포인트가 반환하는 배열 대신 객체를 반환합니다.

요청

HTTPS를 통해 서버 측 API 인증 정보를 사용하세요. 예제는 환경 변수에서 인증 정보를 읽으며, 실제로 사용할 수 있는 인증 정보는 포함하지 않습니다. JSON 본문의 status.code 값과 HTTP 상태를 모두 확인하세요. 이러한 레거시 핸들러는 애플리케이션 오류가 발생해도 HTTP 오류 상태를 일관되게 설정하지 않습니다.

curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
  "https://api.multitel.net/v3/numberinfo/12025550100"

필수 경로 세그먼트에는 번호의 UUID나 PBX 내선 번호가 아니라 저장된 국제 전화번호를 사용해야 합니다. 이 핸들러는 쿼리 매개변수나 요청 본문을 사용하지 않습니다.

응답

다음은 응답 구조를 보여 주는 예시이며, 계정 데이터나 현재 요금 견적이 아닙니다.

{
  "status": {
    "code": 200,
    "msg": ""
  },
  "response": {
    "number": "12025550100",
    "uuid": "NUMBER_UUID",
    "description": "Main reception",
    "isocode": "US",
    "config": {
      "uri": "sip:reception@example.com",
      "uri2": "",
      "uri3": "",
      "forward_destination": "",
      "sms_uri": "",
      "sms_forward_destination": ""
    },
    "features": {
      "voice": "1",
      "sms": "1",
      "mms": "0"
    },
    "status": {
      "capacity": {
        "assigned_channels": "2",
        "used_channels": "0",
        "overflow": "0",
        "overage_charge": "0.01"
      },
      "origination": {
        "origination_trunk_id": "ORIGINATION_ID",
        "origination_trunk_name": "ORIGINATION_NAME",
        "origination_country_iso": "US",
        "origination_continent_iso": "NA",
        "origination_continent_name": "North America"
      },
      "service_active": "1",
      "force_codec": "",
      "force_dtmf": ""
    },
    "billing": {
      "cnam": "0",
      "overflow": "0",
      "autorenew": "1",
      "persistent": "0",
      "date_created": "2026-01-01 00:00:00"
    },
    "price": {
      "setup_price": "0.00",
      "monthly_price": "1.00",
      "per_minute": "0.01",
      "free_minutes": "0",
      "remaining_minutes": "0",
      "perminute_charges": "0"
    },
    "needs_registration": "0",
    "vrating": "",
    "country_id": "COUNTRY_REFERENCE",
    "area_id": "AREA_REFERENCE",
    "provider_id": "OPAQUE_LEGACY_REFERENCE"
  }
}

반환되는 번호 필드
필드	의미
`number, uuid, description, isocode`	저장된 전화번호, 내부 구조에 의미를 부여하지 않고 취급해야 하는 번호 식별자, 설명 및 국가 코드입니다.
`config`	저장된 음성 통화 수신 대상, 외부 착신 전환, SMS 수신 대상 및 SMS 전달 필드입니다. 이 엔드포인트는 이 필드들을 수정하지 않습니다.
`features`	저장된 음성 통화, SMS 및 MMS 기능 지원 플래그입니다. 저장된 레거시 플래그가 JSON 불리언 값이라는 보장은 없습니다.
`status.capacity`	할당된 채널 수와 사용 중인 채널 수, 오버플로 설정 및 저장된 초과 사용 요금입니다. 이는 저장된 메타데이터이며, 새로 산정한 용량 견적이나 실시간 통화 테스트 결과가 아닙니다.
`status.origination`	저장된 통화 유입 메타데이터입니다. 식별자의 내부 구조에 의미를 부여하지 말고, 내부 이름에서 애플리케이션 로직을 도출하지 마세요.
`status.service_active, force_codec, force_dtmf`	저장된 활성화 및 미디어 설정 필드입니다. 플래그만으로는 인바운드 통신이 성공적으로 전달된다는 것을 입증할 수 없습니다.
`billing`	저장된 CNAM, 오버플로, 갱신, 영속성 및 생성 관련 값입니다. 이 값들을 조회해도 갱신이나 기타 청구 설정은 변경되지 않습니다.
`price`	저장된 초기 설정 요금, 월 요금, 분당 요금 및 제공 통화 시간입니다. 이 핸들러는 통화 단위 필드나 새로 산정한 견적을 제공하지 않습니다. 예시 값에서 통화 단위를 추론하거나 이 값들을 현재 구매 견적으로 사용하지 마세요.

다음 엔드포인트와 비교할 때(inventory) 이 엔드포인트는 needs_registration, vrating, country_id, area_id, provider_id 및 price.perminute_charges도 반환합니다. 이들은 저장된 레거시 값이며, 별도의 신원 승인 응답이 아닙니다. 참조 ID의 내부 구조에 의미를 부여하지 말아야 합니다. 적절한 검색 응답 없이 이 ID를 이용해 검색 URL을 구성하거나 공급자 매핑을 추론하지 마세요.

일치하는 번호 없음

인증된 계정에서 무효 처리되지 않은 일치 레코드를 찾을 수 없으면 JSON 본문의 status.code 값은 404이며 메시지에는 number not found가 포함됩니다. 메시지 끝에 붙는 소스 코드 행 정보에 의존하지 마세요. 다시 시도하기 전에 저장된 번호와 inventory를 확인하세요.

결과 활용

이 작업은 저장된 데이터를 조회합니다. 번호를 구매하거나 신원 확인 서류를 승인하거나 수신 대상을 변경하지 않으며, 통화, 팩스 또는 메시지가 전달된다고 보장하지도 않습니다. 번호를 설정할 때는 활성화한 각 서비스를 개별적으로 테스트하세요.