Zum Hauptinhalt springen
Laden Sie die API-Aufrufdetails des aktuellen Kontos direkt als CSV herunter, geeignet für Finanzabstimmungen, Offline-Analysen oder das Speichern großer Mengen von Datensätzen. Wenn Sie nur wenige Details auf der Seite anzeigen möchten, verwenden Sie zuerst die Liste der Aufrufprotokolle. Der Abfragebereich für Aufrufprotokolle und Abrechnungszusammenfassungen umfasst die letzten 60 Tage; Anforderungs- und Antworttexte werden separat für die letzten 30 Tage aufbewahrt. Das Ablaufen des Textes ändert weder die tatsächliche Belastung, Nutzung noch aggregierte Statistiken dieses Datensatzes.

Vorbereitung

  1. Melden Sie sich bei der AceDataCloud-Plattform an.
  2. Erstellen Sie in der Account-Token-Konsole ein Kontotoken und speichern Sie es sofort in einem Passwortmanager oder Secret Manager.
  3. Rufen Sie bei Bedarf die Filter-ID aus der Liste der Dienstanträge, der Liste der API-Anmeldedaten oder der API-Liste ab.
Eine vollständige Beschreibung der Tokens finden Sie unter Kontotokens verwalten. Kontotokens und Credentials zum Aufrufen von Geschäfts-APIs können nicht gemischt verwendet werden.

Schnittstellenübersicht

Diese Schnittstelle gibt CSV synchron als Stream zurück, erstellt keine Exportaufgabe und gibt weder JSON noch einen Download-Link zurück. Nur wenn weder Start- noch Endzeit angegeben ist, werden standardmäßig Datensätze vom Beginn des aktuellen Kalendermonats bis zum aktuellen Zeitpunkt exportiert; wenn nur eine Seite der Grenze angegeben ist, wird die andere Seite nicht automatisch mit der Monatsgrenze ergänzt.

Abfrageparameter

Der Exportbereich ist immer auf Datensätze beschränkt, die für das aktuelle Konto als Zahlungspflichtiger und/oder tatsächlicher Aufrufer sichtbar sind; kontoübergreifende Exporte werden nicht unterstützt.

Anfragebeispiele

CSV des aktuellen Monats direkt speichern:
Nach Application, Zeit und Statuscode exportieren:
Python-Stream speichern und Vollständigkeit prüfen:

CSV-Spalten

Die Reihenfolge der CSV-Kopfzeile ist fest:
Die Einheit des Guthabens wird durch service.unit der entsprechenden Application bestimmt.

Prüfen, ob der Export vollständig ist

Bei einem einzelnen Export werden maximal 1.000.000 Datensätze ausgegeben. Nachdem der Server begonnen hat, CSV zurückzugeben, kann ein Fehler während der Übertragung nicht mehr in einen anderen HTTP-Status geändert werden, daher muss der Client die letzte Zeile prüfen:
  • # truncated:: Das Zeilenlimit wurde erreicht; exportieren Sie segmentiert in kleineren Zeitfenstern.
  • # error:: Der Stream-Lesevorgang wurde unterbrochen; verkleinern Sie den Bereich und exportieren Sie erneut.
Wenn ein Abstimmungsprogramm einen beliebigen Marker erkennt, muss es die Datei als unvollständig behandeln und darf sie nicht stillschweigend verbuchen.

Fehler und Wiederholungen

Nächste Schritte