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"}}]