Haal oproeprekords vir die rekening op
Lees inkomende of uitgaande oproeprekords vir jou API-rekening. Hierdie rekords bevat vertroulike oproep- en faktureringsinligting. Hou dit binne gemagtigde werkvloeie aan die bedienerkant en vermy onnodige aantekening in logboeke of deling.
Hierdie verouderde eindpunt het tans 'n vaste verstekdatumtydperk en geen paginering nie. Gebruik die portaal se werkvloei vir oproepgeskiedenis en uitvoer wanneer jy 'n ander verslagdoeningstydperk of groot uitvoere van historiese data benodig; pasgemaakte datumparameters in hierdie eindpunt is nie betroubaar nie.
Versoeke
Verifieer jou identiteit oor HTTPS met jou geaktiveerde API-rekening vanaf die toegelate bron-IP-adres daarvan. Die voorbeeld gebruik aanmeldbesonderhede in omgewingsveranderlikes. Geen versoekliggaam is nodig vir die ondersteunde versoeke vir die verstektydperk nie.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Pad | Omvang |
|---|---|
| /v3/cdrs | Inkomende oproeprekords vir die rekening binne die verstekdatumtydperk. |
| /v3/cdrs/{number} | Inkomende oproeprekords waarvan die nommer presies met die verskafte nommer ooreenstem. Gebruik verkieslik al die syfers soos dit in jou nommerinventaris voorkom. |
| /v3/cdrs/all/outbound | Uitgaande oproeprekords vir die rekening binne die verstekdatumtydperk. Die uitgaande vertakking ignoreer die eerste padargument; all is hier 'n plekhouer, nie 'n jokerteken vir inkomende oproepe nie. |
Gebruik die presiese rigting inbound of outbound soos hierbo getoon. Die uitgaande vertakking implementeer nie 'n filter per nommer nie. Deur 'n nommer by daardie pad te voeg, word die uitgaande resultate nie beperk nie.
Verstektydperk vir verslagdoening
Die navraag begin om middernag op die bediener se kalenderdatum 30 dae voor vandag en eindig om middernag aan die begin van vandag. Dit sluit dus nie die res van die huidige dag in nie. Dit is nie 'n bewegende tydperk van 720 uur wat op die huidige tydstip eindig nie.
Die huidige implementering ondersteun nie die vormvelde date_from/date_to betroubaar nie: wanneer pasgemaakte datums verskaf word, bly die veranderlikes vir die partisiejare ongestel. Moenie daardie velde vir 'n verslag in die produksieomgewing gebruik nie. Datums in die navraagstring en pagineringsparameters is nie as alternatiewe geïmplementeer nie.
Antwoord
Slegs geselekteerde inkomende velde word ter illustrasie getoon; dit is fiktiewe data en nie die volledige teruggestuurde rekord nie.
{
"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 is 'n lys. Die gedeelde antwoordomhulsel kan status.results as die aantal rye insluit. Resultaatkodes kan stringe wees. Wanneer daar geen rekords is nie, gebruik die resultaat API-kode 404 met 'n No entries found-boodskap in plaas van 'n suksesvolle leë lys.
Rekordvelde
| Velde | Betekenis |
|---|---|
| number, callerid | Inkomende nommer en belleridentifiseerder vir die inkomende veldseleksie. |
| calling, called, callerid | Identifiseerders van die bellende en gebelde partye vir die uitgaande veldseleksie. Moenie uit die belleridentifikasie aflei dat die intekenaar se identiteit geverifieer is nie. |
| disposition, billseconds, billcost | Gestoorde oproepuitkoms, gefaktureerde tydsduur en gestoorde faktuurbedrag. Waardes kan verouderde stringformate uit die databasis gebruik. |
| callsid | Die gestoorde UUID van die oproep om verwante data met mekaar te verbind. |
| date_created | 'n Datum- en tydstring met 'n letterlike UTC-agtervoegsel, eerder as 'n gewaarborgde ISO8601-tydstempel. Ontleed die teruggestuurde formaat uitdruklik. |
| Ander velde | Inkomende rekords bevat ook diagnostiese besonderhede oor mislukkings, koste, kanale, gehalte en oorsprong; uitgaande rekords bevat diagnostiese besonderhede oor die streek waar die oproep termineer. Die volledige antwoord kan infrastruktuurinligting bevat en moet as vertroulik hanteer word. |
Die eindpunt voeg geen uitdruklike sortering of paginering by nie. Moenie aanvaar dat die nuutste resultate eerste verskyn, dat die ryvolgorde stabiel is of dat daar 'n wyser vir inkrementele sinchronisasie is nie. Die teruggestuurde faktureringsvelde is gestoorde oproeprekords, nie 'n kwotasie vir 'n toekomstige oproep nie.
Foute en verslagdoeningsbeperkings
Lees sowel die HTTP-status as JSON se status.code/status.msg. As daar geen inskrywings vir die gekose rekening of tydperk is nie, word API-kode 404 teruggestuur. Identiteitsverifikasie en beperkings op bron-IP-adresse geld ook. 'n Groot verslag sonder paginering of 'n onbetroubare versoek met pasgemaakte datums kan misluk; herhaalde navrae oor die hele tabel is nie 'n strategie vir inkrementele uitvoer nie.
Die nagegane hanteerder bevat leesnavrae en geen debitering van die rekening of inisiëring van oproepe nie. 'n Teruggestuurde rekord bewys nie dat 'n persoon geantwoord het nie; interpreteer die gestoorde oproepuitkoms en tydsduur volgens jou verslagdoeningsbehoefte.