Recuperare i registri delle chiamate dell’account
Consulta i registri delle chiamate in entrata o in uscita del tuo account API. Questi registri contengono informazioni riservate sulle chiamate e sulla fatturazione. Mantienili all’interno di flussi di lavoro autorizzati lato server ed evita registrazioni nei log o condivisioni non necessarie.
Questo endpoint preesistente utilizza attualmente un intervallo di date predefinito fisso e non offre paginazione. Usa il flusso di cronologia ed esportazione delle chiamate del portale quando ti serve un periodo di reportistica diverso o devi esportare grandi quantità di dati storici; i parametri di data personalizzati di questo endpoint non sono affidabili.
Richieste
Autenticati tramite HTTPS usando il tuo account API abilitato dall’indirizzo IP di origine consentito per tale account. L’esempio usa credenziali memorizzate in variabili d’ambiente. Le richieste supportate per l’intervallo predefinito non richiedono un corpo.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Percorso | Ambito |
|---|---|
| /v3/cdrs | Registri delle chiamate in entrata dell’account nell’intervallo di date predefinito. |
| /v3/cdrs/{number} | Registri delle chiamate in entrata il cui numero corrisponde esattamente al numero fornito. Usa preferibilmente tutte le cifre del numero così come compare nel tuo inventario. |
| /v3/cdrs/all/outbound | Registri delle chiamate in uscita dell’account nell’intervallo di date predefinito. Il ramo per le chiamate in uscita ignora il primo argomento del percorso; qui all è un segnaposto, non un carattere jolly per le chiamate in entrata. |
Usa esattamente la direzione inbound o outbound indicata sopra. Il ramo per le chiamate in uscita non implementa un filtro per numero. Aggiungere un numero a quel percorso non restringe i risultati delle chiamate in uscita.
Intervallo di reportistica predefinito
La query inizia alla mezzanotte della data del calendario del server che precede di 30 giorni la data odierna e termina alla mezzanotte di inizio giornata odierna. Non include quindi il resto della giornata corrente. Non si tratta di un intervallo mobile di 720 ore che termina all’ora attuale.
L’implementazione attuale non supporta in modo affidabile i campi del modulo date_from/date_to: se vengono fornite date personalizzate, le variabili relative all’anno della partizione rimangono non impostate. Non usare questi campi per un report in produzione. Non sono implementati, come alternative, né date nella stringa di query né parametri di paginazione.
Risposta
Sono mostrati a scopo illustrativo solo alcuni campi delle chiamate in entrata; i dati sono fittizi e non rappresentano il record completo restituito.
{
"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 è un elenco. L’involucro comune della risposta può includere status.results come conteggio delle righe. I codici di risultato possono essere stringhe. Un risultato senza record usa il codice API 404 con il messaggio No entries found, anziché un elenco vuoto restituito con esito positivo.
Campi dei record
| Campi | Significato |
|---|---|
| number, callerid | Numero di ricezione e identificativo del chiamante nella proiezione delle chiamate in entrata. |
| calling, called, callerid | Identificativi del chiamante e del chiamato nella proiezione delle chiamate in uscita. Non dedurre dall’identificativo del chiamante che l’identità dell’abbonato sia verificata. |
| disposition, billseconds, billcost | Esito della chiamata memorizzato, durata fatturata e importo di fatturazione memorizzato. I valori possono usare formati di stringa del database preesistente. |
| callsid | L’identificatore UUID memorizzato della chiamata, usato per la correlazione. |
| date_created | Una stringa di data e ora con il suffisso letterale UTC, senza garanzia che sia una marca temporale ISO8601. Analizza esplicitamente il formato restituito. |
| Altri campi | I registri delle chiamate in entrata includono anche dati diagnostici su errori, costi, canali, qualità e origine; quelli delle chiamate in uscita includono dati diagnostici sulla regione di terminazione. La risposta completa può includere informazioni sull’infrastruttura e deve essere trattata come riservata. |
L’endpoint non aggiunge alcun ordinamento esplicito né paginazione. Non presumere che i risultati siano ordinati dal più recente, che l’ordine delle righe sia stabile o che sia disponibile un cursore di sincronizzazione incrementale. I campi di fatturazione restituiti provengono dai registri delle chiamate memorizzati e non costituiscono un preventivo per una chiamata futura.
Errori e limiti della reportistica
Leggi sia lo stato HTTP sia status.code/status.msg nel JSON. L’assenza di voci nell’account e nell’intervallo selezionati restituisce il codice API 404. Si applicano anche l’autenticazione e le restrizioni sull’IP di origine. Un report di grandi dimensioni senza paginazione o una richiesta con date personalizzate non affidabile possono non riuscire; interrogare ripetutamente l’intera tabella non è una strategia di esportazione incrementale.
Il gestore esaminato contiene query di lettura e non esegue addebiti sull’account né avvia chiamate. Un record restituito non dimostra che una persona abbia risposto; interpreta l’esito e la durata memorizzati in base alle esigenze della tua reportistica.