Diese Funktion ermöglicht es Vertriebspartnern und Nutzern den Abruf von CDRs für eine bestimmte Kundennummer. Die Funktion überprüft den Nutzernamen und das Passwort des Vertriebspartners / Nutzers und ob die Kundennummer wirklich mit dem Account von diesem Vertriebspartner / Nutzer verbunden ist. Falls erfolgreich, gibt die Funktion ein JSON-kodiertes Array aus.
URL
/cdrs/getcalls/$PROFILE_ID/$START_DATE[/$END_DATE][/$FORMAT]?username=$USERNAME&password=$PASSWORD
- PROFILE_ID: Profil-ID des Vertriebspartners/Kunden/Benutzers (Kundennummer)
- START_DATE: Anfangsdatum, ab dem Sie Daten abfragen möchten (muss kleiner als END_DATE sein)
- END_DATE: Datum, bis zu dem Sie Daten abfragen möchten (optional, falls nicht eingestellt, wird das aktuelle Datum ausgewählt)
- FORMAT: kann auf json und für den Download der Ergebnisse als CSV-Datei auf csv eingestellt werden
- USERNAME: Benutzername des Vertriebspartners/Benutzers
- PASSWORD: Passwort des Vertriebspartners/Benutzers
Fehler
Die Funktion kann nicht ausgeführt werden, wenn eines dieser Kriterien ungültig ist:
- Benutzername und Passwort des Vertriebspartners/Nutzers müssen übereinstimmen
- der von PROFILE_ID definierte Benutzer muss mit dem Vertriebspartner-/Nutzerkonto in Beziehung stehen
- START_DATE muss kleiner sein als END_DATE
- Der Intervall zwischen START_DATE und END_DATE darf 3 Monate nicht überschreiten
Einen Wert ausgeben
Diese Funktion gibt ein multidimensionales JSON-kodiertes Array aus
array( [INDEX] => array( ['type'] => TYPE, ['data'] => DATA ) )
INDEX = numerischer Index [0, 1, …]
TYPE = ein beliebiger der folgenden Werte:
- CALLIN
- CALLOUT
- DEV
- FAX
- HARDWARE
- PAY
- SERVICE
- SETUP
- SMS
- TRAVEL
DATA = Array mit diesen Indizes:
- source = wer hat den Anruf getätigt, wenn type=CALL, sonst der Benutzername
- destination = welche Nummer wurde gewählt wenn type=CALL, sonst der Produktname
- destination_name = welches Land wurde angewählt wenn type=CALL, sonst eine Produktbeschreibung
- call_start = Beginn des Anrufs wenn type=CALL, sonst das Datum der Rechnungsstellung
- call_end = Ende des Anrufs, wenn type=CALL, sonst das Datum der Rechnungsstellung
- quantity = berechnete Menge
- price = Preis in Euro/Cent pro Menge
- invoice = Rechnungs-/Berichtsnummer
Beispiel in csv-Format:
CALLOUT,+35220333320,35220333000,"Luxembourg","2021-06-29,08:30:15",61,'20,2,7.00,N/A
CALLIN,+35220333000,35220333320,"2021-06-29 10:40:00",0,,0,0.00,N/A
Beispiel in json-Format:
[{"type":"CALLIN","data":{"source":"+35220333000","destination":"35220333320","destination_name":null,"call_start":"2021-06-29
08:13:50","duration":"0","pbxextension":"","quantity":0,"price":"0.00","invoice":"N\/A"}},{"type":"CALLOUT","data":{"source":"+35220333320","destination":"35220333000","destination_name":"Luxembourg","call_start":"2021-06-29
08:24:31","duration":"61","pbxextension":"20","quantity":2,"price":"7.00","invoice":"N\/A"}}]