Obtener los registros de llamadas de la cuenta
Consulte los registros de llamadas entrantes o salientes de su cuenta de API. Estos registros contienen información privada sobre llamadas y facturación. Manténgalos en flujos de trabajo autorizados del lado del servidor y evite registrarlos en logs o compartirlos innecesariamente.
Este punto de acceso heredado tiene actualmente un período de fechas predeterminado fijo y no ofrece paginación. Utilice el flujo de trabajo de historial de llamadas y exportación del portal cuando necesite un período de informe diferente o exportaciones históricas de gran volumen; los parámetros de fechas personalizadas de este punto de acceso no son fiables.
Solicitudes
Autentíquese a través de HTTPS con su cuenta de API habilitada, desde su dirección IP de origen permitida. El ejemplo utiliza credenciales almacenadas en variables de entorno. Las solicitudes admitidas para el período predeterminado no necesitan cuerpo.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Ruta | Alcance |
|---|---|
| /v3/cdrs | Registros de llamadas entrantes de la cuenta en el período de fechas predeterminado. |
| /v3/cdrs/{number} | Registros de llamadas entrantes cuyo número coincide exactamente con el número proporcionado. Utilice preferentemente todos los dígitos tal como figuran en su inventario. |
| /v3/cdrs/all/outbound | Registros de llamadas salientes de la cuenta en el período de fechas predeterminado. La rama de llamadas salientes ignora el primer argumento de la ruta; all es aquí un marcador de posición, no un comodín para llamadas entrantes. |
Utilice exactamente el sentido inbound o outbound indicado arriba. La rama de llamadas salientes no implementa un filtro por número. Añadir un número a esa ruta no restringe los resultados de llamadas salientes.
Período predeterminado de los informes
La consulta comienza a medianoche de la fecha del calendario del servidor correspondiente a 30 días antes de hoy y termina a medianoche al inicio de hoy. Por lo tanto, no incluye el resto del día actual. No se trata de un período móvil de 720 horas que termine en el momento actual.
La implementación actual no admite de forma fiable los campos de formulario date_from/date_to: al proporcionar fechas personalizadas, las variables que indican el año de las particiones quedan sin definir. No utilice esos campos para un informe en producción. Tampoco se han implementado como alternativas las fechas en la cadena de consulta ni los parámetros de paginación.
Respuesta
Solo se muestran algunos campos de llamadas entrantes a modo de ejemplo; los datos son ficticios y no representan el registro completo devuelto.
{
"status": {
"code": "200",
"msg": "",
"results": 1
},
"response": [
{
"number": "12025550123",
"callerid": "12025550124",
"disposition": "ANSWERED",
"billseconds": "60",
"billcost": "0.0100",
"callsid": "11111111111111111111111111111111",
"date_created": "2026-10-01 12:00:00 UTC"
}
]
}response es una lista. La estructura común que envuelve la respuesta puede incluir status.results como recuento de filas. Los códigos de resultado pueden ser cadenas de texto. Un resultado sin registros utiliza el código 404 de la API con el mensaje No entries found, en lugar de devolver una lista vacía como respuesta satisfactoria.
Campos del registro
| Campos | Significado |
|---|---|
| number, callerid | Número de destino de la llamada entrante e identificador de quien llama en la proyección de llamadas entrantes. |
| calling, called, callerid | Identificadores de origen y destino en la proyección de llamadas salientes. No deduzca una identidad verificada del abonado a partir del identificador de llamada. |
| disposition, billseconds, billcost | Resultado almacenado de la llamada, duración facturada e importe de facturación almacenado. Los valores pueden utilizar formatos de cadenas de texto heredados de la base de datos. |
| callsid | El UUID almacenado de la llamada, utilizado para correlacionar registros. |
| date_created | Una cadena de fecha y hora con el sufijo literal UTC, sin garantía de que sea una marca de tiempo ISO8601. Analice explícitamente el formato devuelto. |
| Otros campos | Los registros de llamadas entrantes también incluyen datos de diagnóstico sobre fallos, costes, canales, calidad y origen; los registros de llamadas salientes incluyen datos de diagnóstico sobre la región de terminación. La respuesta completa puede incluir información de infraestructura y debe tratarse como privada. |
El punto de acceso no añade una ordenación explícita ni paginación. No dé por hecho que los resultados más recientes aparecen primero, que el orden de las filas es estable ni que existe un cursor de sincronización incremental. Los campos de facturación devueltos corresponden a registros de llamadas almacenados, no a un presupuesto para una llamada futura.
Errores y limitaciones de los informes
Consulte tanto el estado HTTP como los campos status.code/status.msg del JSON. Si no hay registros en la cuenta y el período seleccionados, se devuelve el código 404 de la API. También se aplican la autenticación y las restricciones de IP de origen. Un informe de gran tamaño sin paginación o una solicitud con fechas personalizadas que no funcione de forma fiable pueden fallar; consultar repetidamente toda la tabla no constituye una estrategia de exportación incremental.
El controlador revisado contiene consultas de lectura y no realiza cargos en la cuenta ni inicia llamadas. Un registro devuelto no demuestra que una persona haya contestado; interprete el resultado y la duración almacenados según las necesidades de su informe.