Obțineți înregistrările apelurilor din cont
Citiți înregistrările apelurilor de intrare sau de ieșire pentru contul dumneavoastră API. Aceste înregistrări conțin informații confidențiale despre apeluri și facturare. Păstrați-le în fluxuri de lucru autorizate pe server și evitați înregistrarea lor în jurnale sau partajarea lor fără necesitate.
Acest punct de acces vechi are în prezent un interval de date implicit fix și nu oferă paginare. Folosiți fluxul de lucru al portalului pentru istoricul apelurilor și export atunci când aveți nevoie de o altă perioadă de raportare sau de exporturi istorice de mari dimensiuni; parametrii pentru date personalizate ai acestui punct de acces nu sunt fiabili.
Cereri
Autentificați-vă prin HTTPS, folosind contul dumneavoastră API activat, de la adresa IP sursă permisă pentru acesta. Exemplul folosește date de autentificare în variabile de mediu. Cererile acceptate pentru intervalul implicit nu necesită un corp.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Cale | Domeniu de aplicare |
|---|---|
| /v3/cdrs | Înregistrările apelurilor de intrare ale contului din intervalul de date implicit. |
| /v3/cdrs/{number} | Înregistrările apelurilor de intrare al căror număr corespunde exact numărului furnizat. Folosiți de preferință toate cifrele numărului, așa cum apar în inventarul dumneavoastră. |
| /v3/cdrs/all/outbound | Înregistrările apelurilor de ieșire ale contului din intervalul de date implicit. Ramura pentru apelurile de ieșire ignoră primul argument al căii; all este aici un substituent, nu un caracter wildcard pentru apelurile de intrare. |
Folosiți exact direcția inbound sau outbound indicată mai sus. Ramura pentru apelurile de ieșire nu implementează un filtru pe număr. Adăugarea unui număr în acea cale nu restrânge rezultatele pentru apelurile de ieșire.
Intervalul implicit de raportare
Interogarea începe la miezul nopții din data calendaristică a serverului de acum 30 de zile și se încheie la miezul nopții de la începutul zilei de astăzi. Prin urmare, nu include restul zilei curente. Acesta nu este un interval mobil de 720 de ore care se încheie la momentul curent.
Implementarea actuală nu acceptă în mod fiabil câmpurile de formular date_from/date_to: furnizarea unor date personalizate lasă neinițializate variabilele sale pentru anii partițiilor. Nu folosiți aceste câmpuri pentru un raport în producție. Datele din șirul de interogare și parametrii de paginare nu sunt implementați ca alternative.
Răspuns
Sunt prezentate doar câteva câmpuri pentru apelurile de intrare, cu rol ilustrativ; acestea sunt date fictive, nu înregistrarea completă returnată.
{
"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 este o listă. Structura comună care încadrează răspunsul poate include status.results ca număr de rânduri. Codurile rezultatelor pot fi șiruri de caractere. Un rezultat fără înregistrări folosește codul API 404 cu mesajul No entries found, în locul unei liste goale returnate cu succes.
Câmpurile înregistrărilor
| Câmpuri | Semnificație |
|---|---|
| number, callerid | Numărul de intrare și identificatorul apelantului pentru proiecția apelurilor de intrare. |
| calling, called, callerid | Identificatorii apelantului și ai destinatarului pentru proiecția apelurilor de ieșire. Nu deduceți o identitate verificată a abonatului din identificatorul apelantului. |
| disposition, billseconds, billcost | Starea finală stocată a apelului, durata facturată și suma de facturare stocată. Valorile pot folosi formate vechi de șiruri de caractere din baza de date. |
| callsid | Identificatorul UUID stocat al apelului, folosit pentru corelare. |
| date_created | Un șir de caractere cu data și ora, având sufixul literal UTC, fără garanția că este o marcă temporală ISO8601. Analizați explicit formatul returnat. |
| Alte câmpuri | Înregistrările apelurilor de intrare includ și informații de diagnostic despre eșecuri, costuri, canale, calitate și origine; înregistrările apelurilor de ieșire includ informații de diagnostic despre regiunea de terminare. Răspunsul complet poate include informații despre infrastructură și trebuie tratat ca fiind confidențial. |
Punctul de acces nu adaugă o ordonare explicită sau paginare. Nu presupuneți că rezultatele încep cu cele mai recente, că ordinea rândurilor este stabilă sau că există un cursor pentru sincronizare incrementală. Câmpurile de facturare returnate reprezintă înregistrări stocate ale apelurilor, nu o ofertă de preț pentru un apel viitor.
Erori și limite de raportare
Citiți atât starea HTTP, cât și status.code/status.msg din JSON. Lipsa înregistrărilor pentru contul și intervalul selectate returnează codul API 404. Se aplică și autentificarea și restricțiile privind adresa IP sursă. Un raport mare fără paginare sau o cerere cu date personalizate, care nu funcționează fiabil, poate eșua; interogarea repetată a întregului tabel nu este o strategie de export incremental.
Rutina de tratare revizuită conține interogări de citire și nu debitează contul și nu inițiază apeluri. O înregistrare returnată nu dovedește că a răspuns o persoană; interpretați starea finală și durata stocate în funcție de scopul raportării dumneavoastră.