Anrufdatensätze des Kontos lesen

Anrufdatensätze des Kontos abrufen

Lesen Sie Datensätze eingehender oder ausgehender Anrufe für Ihr API-Konto. Diese Datensätze enthalten vertrauliche Anruf- und Abrechnungsinformationen. Verarbeiten Sie sie ausschließlich in autorisierten serverseitigen Abläufen und vermeiden Sie unnötiges Protokollieren oder Weitergeben.

Dieser ältere Endpunkt verwendet derzeit einen festen Standardzeitraum und bietet keine Seitennavigation. Nutzen Sie die Anrufverlaufs- und Exportfunktion des Portals, wenn Sie einen anderen Berichtszeitraum oder umfangreiche Exporte historischer Daten benötigen; benutzerdefinierte Datumsparameter funktionieren bei diesem Endpunkt nicht zuverlässig.

Anfragen

Authentifizieren Sie sich über HTTPS mit Ihrem freigeschalteten API-Konto von dessen zulässiger Quell-IP-Adresse aus. Im Beispiel stehen die Zugangsdaten in Umgebungsvariablen. Für die unterstützten Anfragen zum Standardzeitraum ist kein Anfragetext erforderlich.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  https://api.multitel.net/v3/cdrs

Anfragepfade für Anrufdatensätze
Pfad	Umfang
/v3/cdrs	Datensätze eingehender Anrufe des Kontos im Standardzeitraum.
/v3/cdrs/{number}	Datensätze eingehender Anrufe, deren Rufnummer genau mit der angegebenen Rufnummer übereinstimmt. Verwenden Sie vorzugsweise die vollständige Ziffernfolge aus Ihrem Rufnummernbestand.
/v3/cdrs/all/outbound	Datensätze ausgehender Anrufe des Kontos im Standardzeitraum. Der Zweig für ausgehende Anrufe ignoriert das erste Pfadargument; all ist hier ein Platzhalter und kein Platzhalter für beliebige eingehende Rufnummern.

Verwenden Sie für die Richtung genau die oben gezeigte Angabe inbound oder outbound. Der Zweig für ausgehende Anrufe bietet keinen Filter nach einzelner Rufnummer. Das Hinzufügen einer Rufnummer zu diesem Pfad schränkt die Ergebnisse für ausgehende Anrufe nicht ein.

Standardberichtszeitraum

Die Abfrage beginnt um Mitternacht des Kalendertags, der nach dem Kalender des Servers 30 Tage vor dem heutigen Tag liegt, und endet um Mitternacht zu Beginn des heutigen Tages. Der restliche heutige Tag ist daher nicht enthalten. Es handelt sich nicht um einen gleitenden Zeitraum von 720 Stunden, der zum aktuellen Zeitpunkt endet.

Die aktuelle Implementierung unterstützt die Formularfelder date_from/date_to nicht zuverlässig: Bei der Angabe benutzerdefinierter Datumswerte bleiben ihre Variablen für die Partitionsjahre ungesetzt. Verwenden Sie diese Felder nicht für Berichte im Produktivbetrieb. Datumsangaben in der Abfragezeichenfolge und Parameter zur Seitennavigation sind nicht als Alternativen implementiert.

Antwort

Nur ausgewählte Felder eingehender Anrufe zur Veranschaulichung; dies sind fiktive Daten und kein vollständiger zurückgegebener Datensatz.

{
  "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 ist eine Liste. Die gemeinsame Antwortstruktur kann status.results als Zeilenanzahl enthalten. Ergebniscodes können Zeichenfolgen sein. Wenn keine Datensätze vorhanden sind, wird der API-Code 404 mit der Meldung No entries found zurückgegeben, statt einer erfolgreichen Antwort mit einer leeren Liste.

Datensatzfelder

Wichtigste zurückgegebene Felder
Felder	Bedeutung
number, callerid	Angerufene Rufnummer und Anruferkennung in der Feldauswahl für eingehende Anrufe.
calling, called, callerid	Kennungen des anrufenden und des angerufenen Anschlusses in der Feldauswahl für ausgehende Anrufe. Leiten Sie aus der Anruferkennung keine verifizierte Teilnehmeridentität ab.
disposition, billseconds, billcost	Gespeicherter Anrufstatus, abgerechnete Dauer und gespeicherter Abrechnungsbetrag. Die Werte können ältere Zeichenfolgenformate der Datenbank verwenden.
callsid	Die gespeicherte UUID des Anrufs zur Zuordnung zusammengehöriger Daten.
date_created	Eine Datums- und Uhrzeitzeichenfolge mit dem wörtlichen Suffix UTC; ein Zeitstempel im Format ISO8601 ist nicht garantiert. Analysieren Sie das zurückgegebene Format ausdrücklich anhand seiner konkreten Struktur.
Weitere Felder	Datensätze eingehender Anrufe enthalten außerdem Diagnosedaten zu Fehlern, Kosten, Kanal, Qualität und Herkunft; Datensätze ausgehender Anrufe enthalten Diagnosedaten zur Terminierungsregion. Die vollständige Antwort kann Informationen zur Infrastruktur enthalten und sollte vertraulich behandelt werden.

Der Endpunkt legt keine ausdrückliche Sortierung fest und bietet keine Seitennavigation. Gehen Sie weder von einer Sortierung mit den neuesten Ergebnissen zuerst noch von einer stabilen Zeilenreihenfolge oder einem Cursor für die inkrementelle Synchronisierung aus. Die zurückgegebenen Abrechnungsfelder sind gespeicherte Anrufdaten und kein Preisangebot für einen künftigen Anruf.

Fehler und Einschränkungen bei Berichten

Prüfen Sie sowohl den HTTP-Status als auch in JSON die Angaben status.code/status.msg. Sind für das ausgewählte Konto im ausgewählten Zeitraum keine Einträge vorhanden, wird der API-Code 404 zurückgegeben. Auch die Authentifizierung und die Beschränkungen für Quell-IP-Adressen gelten. Ein umfangreicher Bericht ohne Seitenaufteilung oder eine unzuverlässige Anfrage mit benutzerdefinierten Datumsangaben kann fehlschlagen; das wiederholte Abfragen der gesamten Tabelle ist keine Strategie für inkrementelle Exporte.

Die geprüfte Verarbeitungsroutine enthält Leseabfragen und weder eine Kontobelastung noch das Einleiten von Anrufen. Ein zurückgegebener Datensatz beweist nicht, dass eine Person den Anruf angenommen hat; werten Sie den gespeicherten Anrufstatus und die Dauer entsprechend Ihrem Berichtszweck aus.