Gespreksgegevens van het account ophalen
Lees de gegevens van inkomende of uitgaande gesprekken voor uw API-account. Deze gegevens bevatten vertrouwelijke gespreks- en factureringsinformatie. Verwerk ze uitsluitend in geautoriseerde processen op de server en vermijd onnodige registratie in logboeken of verspreiding.
Dit verouderde eindpunt heeft momenteel een vaste standaardperiode en geen paginering. Gebruik de gespreksgeschiedenis en exportfunctie van het portaal als u een andere rapportageperiode of grote historische exports nodig hebt; parameters voor aangepaste datums zijn bij dit eindpunt niet betrouwbaar.
Verzoeken
Authenticeer via HTTPS met uw ingeschakelde API-account vanaf het daarvoor toegestane bron-IP-adres. Het voorbeeld gebruikt aanmeldgegevens uit omgevingsvariabelen. Voor de ondersteunde verzoeken over de standaardperiode is geen verzoekinhoud nodig.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/cdrs| Pad | Bereik |
|---|---|
| /v3/cdrs | Gegevens van inkomende gesprekken van het account over de standaardperiode. |
| /v3/cdrs/{number} | Gegevens van inkomende gesprekken waarvan het nummer exact overeenkomt met het opgegeven nummer. Gebruik bij voorkeur de volledige cijferreeks uit uw nummerbestand. |
| /v3/cdrs/all/outbound | Gegevens van uitgaande gesprekken van het account over de standaardperiode. De verwerking voor uitgaande gesprekken negeert het eerste padargument; all is hier een tijdelijke aanduiding en geen jokerteken voor inkomende gesprekken. |
Gebruik de richting inbound of outbound exact zoals hierboven weergegeven. De verwerking voor uitgaande gesprekken heeft geen filter per nummer. Een nummer toevoegen aan dat pad beperkt de resultaten voor uitgaande gesprekken niet.
Standaardrapportageperiode
De queryperiode begint om middernacht op de kalenderdatum van de server die 30 dagen vóór vandaag ligt en eindigt om middernacht aan het begin van vandaag. De rest van de huidige dag valt er dus niet onder. Dit is geen voortschrijdende periode van 720 uur die op het huidige tijdstip eindigt.
De huidige implementatie ondersteunt de formuliervelden date_from/date_to niet betrouwbaar: als u aangepaste datums opgeeft, blijven de variabelen voor het partitiejaar oningesteld. Gebruik deze velden niet voor een rapport in productie. Datums in de querystring en pagineringsparameters zijn niet als alternatief geïmplementeerd.
Antwoord
Alleen enkele velden voor inkomende gesprekken worden ter illustratie getoond; dit zijn fictieve gegevens en niet de volledige geretourneerde record.
{
"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 een lijst. De gemeenschappelijke antwoordstructuur kan status.results bevatten als aantal rijen. Resultaatcodes kunnen tekenreeksen zijn. Als er geen records zijn, wordt API-code 404 met het bericht No entries found gebruikt in plaats van een geslaagd antwoord met een lege lijst.
Recordvelden
| Velden | Betekenis |
|---|---|
| number, callerid | Het inkomende nummer en de identificatie van de beller in de veldselectie voor inkomende gesprekken. |
| calling, called, callerid | Identificaties van de bellende en gebelde partij in de veldselectie voor uitgaande gesprekken. Leid uit de belleridentificatie geen geverifieerde identiteit van een abonnee af. |
| disposition, billseconds, billcost | De opgeslagen gespreksuitkomst, de in rekening gebrachte duur en het opgeslagen factureringsbedrag. Waarden kunnen verouderde tekenreeksformaten uit de database gebruiken. |
| callsid | De opgeslagen UUID van het gesprek om bijbehorende gegevens aan elkaar te koppelen. |
| date_created | Een tekenreeks met datum en tijd en het letterlijke achtervoegsel UTC, zonder garantie dat het een tijdstempel volgens ISO8601 is. Geef bij het ontleden expliciet het geretourneerde formaat op. |
| Overige velden | Records van inkomende gesprekken bevatten ook diagnostische gegevens over fouten, kosten, kanalen, kwaliteit en herkomst; records van uitgaande gesprekken bevatten diagnostische gegevens over de regio waar het gesprek wordt afgeleverd. Het volledige antwoord kan infrastructuurinformatie bevatten en moet als vertrouwelijk worden behandeld. |
Het eindpunt voegt geen expliciete sortering of paginering toe. Ga er niet van uit dat de nieuwste resultaten eerst komen, dat de rijvolgorde stabiel is of dat er een cursor voor incrementele synchronisatie beschikbaar is. De geretourneerde factureringsvelden bevatten opgeslagen gespreksgegevens en vormen geen prijsopgave voor een toekomstig gesprek.
Fouten en rapportagebeperkingen
Lees zowel de HTTP-status als status.code/status.msg in JSON. Als er geen records zijn voor het geselecteerde account en de geselecteerde periode, wordt API-code 404 geretourneerd. Authenticatie en beperkingen voor het bron-IP-adres zijn ook van toepassing. Een groot rapport zonder paginering of een onbetrouwbaar verzoek met aangepaste datums kan mislukken; herhaaldelijk de volledige tabel opvragen is geen strategie voor incrementele export.
De beoordeelde verzoekafhandeling bevat leesquery's en schrijft geen bedrag van het account af en start geen gesprekken. Een geretourneerde record bewijst niet dat een persoon heeft opgenomen; interpreteer de opgeslagen gespreksuitkomst en duur in het licht van uw rapportagedoel.