저장된 소유자가 API 인증 정보에 해당하는 계정과 일치하는 구매 번호 레코드를 조회합니다. 레코드가 존재한다는 사실과 실제 통화 테스트가 성공했다는 사실은 별개입니다.
요청
HTTPS를 통해 서버 측 API 인증 정보를 사용하세요. 예제는 환경 변수에서 인증 정보를 읽으며, 실제로 사용할 수 있는 인증 정보는 포함하지 않습니다. JSON 본문의 status.code 값과 HTTP 상태를 모두 확인하세요. 이러한 레거시 핸들러는 애플리케이션 오류가 발생해도 HTTP 오류 상태를 일관되게 설정하지 않습니다.
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/inventory"저장된 전화번호 하나로 필터링하려면 다음과 같이 선택적 경로 형식을 사용하세요:
curl --user "$MULTITEL_API_USER:$MULTITEL_API_PASSWORD" \
"https://api.multitel.net/v3/inventory/12025550100"저장된 국제 전화번호를 국가 코드를 포함한 숫자로 입력하세요. 그 대신 PBX 내선 번호, 번호 UUID, 지역 ID 또는 접두사 ID를 전달하지 마세요. 입력한 번호는 기존 레코드를 선택하는 데 사용되며, 번호를 구매하거나 설정하지 않습니다.
응답
응답의 response 멤버는 단일 번호 경로 형식을 사용하는 경우를 포함하여 성공 시 항상 배열입니다. status.results 값은 배열의 길이입니다.
이는 응답 구조를 보여 주는 예시이며, 계정 데이터나 현재 가격 견적이 아닙니다.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"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"
}
}
]
}| 필드 | 의미 |
|---|---|
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 | 저장된 개통 요금, 월 요금, 분당 요금 및 제공 통화 시간입니다. 이 핸들러는 통화 단위 필드나 새로 산정한 견적을 제공하지 않습니다. 예시 값으로 통화 단위를 추정하거나 이 값을 현재 구매 견적으로 사용하지 마세요. |
필터링 및 페이지 나누기
이 핸들러에는 페이지 나누기, 페이지 크기 제한 또는 명시적인 정렬 순서가 없습니다. 쿼리로 선택된 레코드 중 무효 처리되지 않은 모든 레코드를 반환합니다. 서비스가 활성화된 번호만 선택하는 필터나 보관된 번호를 별도로 조회하는 기능은 구현되어 있지 않습니다. 반환되는 레코드의 순서가 일정하다고 가정하지 마세요.
일치하는 번호가 없는 경우
계정에 조건과 일치하면서 무효 처리되지 않은 레코드가 없으면 JSON 본문의 status.code 값은 404이며, 메시지에는 no numbers found 문구가 포함됩니다. 성공 응답으로 빈 배열을 반환하지 않습니다. 메시지에는 소스 참조 접미사가 포함되며, 클라이언트는 이를 고정된 식별자로 간주하여 파싱해서는 안 됩니다.
다음 단계
단일 번호에 대한 추가 레거시 등록 필드와 번호 참조 필드가 필요하면 numberinfo를 사용하세요. 별도의 설정 작업을 통해 경로를 변경하기 전에 음성 및 메시지 수신 대상을 확인하세요.