저장된 요금제 읽기
사용 가능한 전화번호를 둘러본 후 API 계정에 저장된 가격 행을 조회합니다. 가격 옵션의 uuid 값을 선택한 번호의 price 목록에서 가져와 사용하고, 번호 자체나 접두사 ID 또는 지역 ID는 사용하지 마십시오. 선택한 번호와 가격 옵션을 함께 유지하십시오.
이것은 저장된 가격 정보에 대한 호환성 조회입니다. 가용성이나 가격을 갱신하지 않으며, 번호를 예약하거나 주문을 하거나 향후 구매 금액을 보장하지 않습니다. 주문하기 전에 새로운 번호 검색으로 반환된 가격 옵션을 검토하십시오.
요청
허용된 IP 주소에서 HTTPS를 통해 활성화된 API 계정을 사용하십시오. PRICE_ID 값을 받은 가격 옵션 ID와 정확히 동일하게 설정하십시오. 이 메서드는 경로 인수 하나만 읽으며 본문, 날짜 또는 페이지 매김 매개변수는 읽지 않습니다.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"가격 옵션을 받은 바로 그 계정이 이 조회를 수행해야 합니다. ID를 직접 만들거나, 데이터베이스 행 번호를 사용하거나, 다른 계정의 선택 항목으로 대체하지 마십시오. 이 레거시 메서드는 표시되는 가격 ID만 일치시킵니다.
응답
다음 가상 예시는 선택된 고객 대상 필드만 보여줍니다. 실제 응답은 저장된 행 전체를 반환하며 추가 계정, 공급업체 및 내부 가격 메타데이터를 포함할 수 있습니다. 전체 응답은 서버에 보관하고 애플리케이션에 필요한 고객 대상 값만 노출하십시오.
{
"status": {
"code": 200,
"msg": "",
"results": 1
},
"response": [
{
"visible_uuid": "PRICE_FROM_SEARCH",
"setup_price": "2.00",
"monthly_price": "4.50",
"per_minute": "0.0100",
"free_minutes": "100",
"channels": "2"
}
]
}response 는 행이 하나뿐이더라도 목록입니다. status.results 는 반환된 행 수를 나타냅니다. 데이터베이스 숫자 값은 문자열일 수 있습니다. 이 엔드포인트는 통화 필드를 추가하거나 통화를 변환하지 않습니다. 이 예시에서 통화를 추론하지 말고 계정의 청구 통화를 확인하십시오.
가격 필드
| 필드 | 의미 |
|---|---|
| visible_uuid | 저장된 가격 옵션의 표시 식별자입니다. 조회를 대조할 때는 원래 옵션 ID를 사용하십시오. |
| setup_price | 이 옵션에 대해 저장된 일회성 설치 가격입니다. |
| monthly_price | 저장된 반복 월별 가격입니다. |
| per_minute, free_minutes | 저장된 수신 통화 분당 요금과 포함된 분 수량입니다. 발신 통화나 가능한 모든 추가 요금을 제시하지는 않습니다. |
| channels | 이 옵션에 대해 저장된 채널 수량입니다. 실시간 용량 또는 등록 확인이 아닙니다. |
| yearly_price | 저장된 연간 가격 필드가 추가로 존재할 수 있습니다. 월별 가격이 영이 아닌 값이고 연간 필드가 영이라고 해서 무료 연간 요금제를 의미한다고 추론하지 마십시오. |
일치하는 여러 행 처리
조회는 저장된 행을 두 개 이상 반환할 수 있습니다. 이 메서드는 보장된 정렬 순서, 최신 행 선택 또는 번호/접두사 필터를 제공하지 않습니다. 첫 번째 또는 마지막 행을 묵시적으로 선택하지 마십시오. 반환된 컨텍스트를 원래 선택한 번호 및 가격 옵션과 비교하고, 여전히 모호하거나 오래된 경우에는 이 응답을 주문 견적으로 취급하는 대신 번호 검색을 다시 수행하십시오.
포털의 주문 검토 워크플로는 추가적인 선택 및 유효성 검사를 수행합니다. 이 레거시 조회가 그러한 검사를 구현하거나 포털이 허용하는 모든 식별자를 허용한다고 가정하지 마십시오.
빈 응답과 오류
일치하는 저장된 행이 없으면 현재 핸들러는 JSON 결과를 출력하지 않으며 명시적인 찾을 수 없음 응답도 보내지 않습니다. 빈 본문은 가격이 영이라는 뜻도, 사용 가능한 요금제라는 뜻도, 조회가 성공적으로 확인되었다는 뜻도 아닙니다. HTTP 응답과 JSON 구조를 모두 확인하고, 누락되었거나 구문 분석할 수 없는 가격 데이터로 주문하지 마십시오.
인증, 소스 IP 제한 및 데이터베이스 장애도 사용 가능한 응답을 방해할 수 있습니다. 데이터베이스 예외에 대한 핸들러 전용 오류 봉투는 없습니다. 인증된 조회가 계속 사용할 수 없는 상태이면 선택 항목을 새로 고치거나 지원팀에 문의하십시오.
효과 및 제한
검토된 조회는 읽기 쿼리를 수행하며 차감, 구매, 예약 또는 공급자 가격 갱신을 포함하지 않습니다. 저장된 가격 정보를 읽는 것은 현재 재고, 규제 승인, 계정 구매 권한 또는 최종 청구를 확정하지 않습니다.