Consultar un plan de precios guardado
Consulte las filas de precios guardadas para su cuenta de API después de explorar los números de teléfono disponibles. Utilice el uuid de la opción de precios que figura en la lista price del número seleccionado, no el propio número, el ID del prefijo ni el ID del área. Mantenga juntos el número seleccionado y la opción de precios.
Esta consulta de precios guardados se ofrece por compatibilidad. No actualiza la disponibilidad ni los precios, no reserva un número, no realiza un pedido ni garantiza el importe de una compra futura. Revise la opción de precios devuelta en una nueva búsqueda de números antes de realizar un pedido.
Solicitud
Utilice su cuenta de API habilitada mediante HTTPS desde una dirección IP permitida. Establezca PRICE_ID con el ID exacto de la opción de precios que recibió. El método lee un único argumento de ruta y no lee ningún cuerpo ni parámetros de fecha o paginación.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/getpriceinfo/$PRICE_ID"La consulta debe realizarla la misma cuenta que obtuvo la opción de precios. No construya un ID, no utilice un número de fila de la base de datos ni lo sustituya por la selección de otra cuenta. El método heredado busca coincidencias únicamente con el ID visible del precio.
Respuesta
El siguiente ejemplo ficticio muestra únicamente algunos campos destinados al cliente. Las respuestas reales devuelven filas guardadas completas y pueden incluir metadatos adicionales de la cuenta, del proveedor y de precios internos. Mantenga la respuesta completa en su servidor y exponga únicamente los valores destinados al cliente que necesite su aplicación.
{
"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 es una lista, incluso cuando solo contiene una fila. status.results indica el número de filas devueltas. Los valores numéricos de la base de datos pueden ser cadenas de texto. El endpoint no añade un campo de moneda ni convierte monedas; confirme la moneda de facturación de la cuenta en lugar de deducirla de este ejemplo.
Campos de precios
| Campo | Significado |
|---|---|
| visible_uuid | El identificador visible de la opción de precios guardada. Utilice el ID original de la opción para relacionar la consulta con ella. |
| setup_price | Precio de alta de pago único guardado para esta opción. |
| monthly_price | Precio mensual recurrente guardado. |
| per_minute, free_minutes | Tarifa por minuto de las llamadas entrantes y cantidad de minutos incluidos, ambas guardadas. Estos valores no constituyen una cotización de las llamadas salientes ni de todos los posibles recargos. |
| channels | Cantidad de canales guardada para esta opción; no es una comprobación en tiempo real de la capacidad ni del registro. |
| yearly_price | Puede haber un campo adicional de precio anual guardado. No deduzca que un precio mensual distinto de cero y un campo anual con valor cero representan un plan anual gratuito. |
Gestionar varias filas coincidentes
Una consulta puede devolver más de una fila guardada. El método no garantiza un orden, no selecciona la fila más reciente ni ofrece un filtro por número o prefijo. No elija la primera o la última fila sin advertirlo. Compare el contexto devuelto con el número y la opción de precios seleccionados originalmente; si sigue siendo ambiguo o está desactualizado, vuelva a realizar la búsqueda de números en lugar de tratar esta respuesta como una cotización para un pedido.
El flujo de revisión de pedidos del portal realiza comprobaciones adicionales de selección y validez. No dé por hecho que esta consulta heredada implementa esas comprobaciones o acepta todos los identificadores que acepta el portal.
Respuestas vacías y errores
Si no coincide ninguna fila guardada, el controlador actual no emite ningún resultado JSON ni una respuesta explícita de recurso no encontrado. Un cuerpo vacío no representa un precio de cero, un plan disponible ni una consulta confirmada como correcta. Compruebe tanto la respuesta HTTP como la estructura JSON; no realice pedidos si faltan los datos de precios o no se pueden analizar.
La autenticación, las restricciones de IP de origen y los fallos de la base de datos también pueden impedir que se obtenga una respuesta utilizable. No hay una estructura de respuesta de error específica del controlador para las excepciones de la base de datos. Actualice su selección o póngase en contacto con el servicio de asistencia si una consulta autenticada sigue sin estar disponible.
Efectos y límites
La consulta revisada realiza una operación de lectura y no efectúa cargos, compras, reservas ni actualizaciones de los precios del proveedor. Consultar los precios guardados no confirma las existencias actuales, la aprobación regulatoria, el permiso de compra de la cuenta ni la facturación final.