Zum Hauptinhalt springen
Fasst die Anzahl der Anfragen und die tatsächlich abgezogenen Kontingente des aktuellen Kontos nach Datum und API zusammen, geeignet für Monatsberichte, Trenddiagramme und Kostenanalysen. Verwenden Sie bei der Fehlersuche für einzelne Einträge die Liste der Aufrufprotokolle, und verwenden Sie für vollständige Offline-Details den Aufrufmengenexport. Der Abfragezeitraum für Aufrufprotokolle und Abrechnungsübersichten beträgt die letzten 60 Tage; Anfrage- und Antworttexte werden separat für die letzten 30 Tage aufbewahrt. Der Ablauf der Texte ändert nicht die tatsächliche Gebühr, Nutzung oder aggregierte Statistik dieses Eintrags.

Vorbereitung

  1. Melden Sie sich bei der AceDataCloud-Plattform an.
  2. Erstellen Sie in der Account-Token-Konsole ein Konto-Token und speichern Sie es sofort.
  3. Um den Bereich einzugrenzen, beziehen Sie die entsprechenden IDs aus der Dienstantragsliste, der API-Anmeldedatenliste oder der API-Liste.
Die vollständige Token-Beschreibung finden Sie unter Kontotokens verwalten. Diese Schnittstelle verwendet ein Account Token und keine geschäftlichen Credentials.

Schnittstellenübersicht

Abfrageparameter

start_time / end_time können weiterhin als Kompatibilitätsaliase für alte Clients verwendet werden; neue Integrationen verwenden einheitlich created_at_from / created_at_to. Die Datumsform von created_at_to schließt diesen Kalendertag ein, d. h. Mitternacht des Folgetags wird als Grenze verwendet.

Anfragebeispiele

Tägliche/API-Aggregationen für den aktuellen Monat in Pekinger Zeit abfragen und die Modelldimension einschließen:
Die Nutzung einer bestimmten Application für eine Woche abfragen:
Python-Beispiel:

Antwortbeispiel

Antwortfelder

Die Kontingenteinheit hängt von service.unit der jeweiligen Application ab. Wenn die Abfrage Dienste mit unterschiedlichen Einheiten enthält, führen Sie die Statistiken zunächst getrennt nach service_id oder application_id aus, um direkte Vergleiche oder Additionen zu vermeiden. Wenn die Endzeit nicht größer als die Startzeit ist, gibt die Schnittstelle eine vollständige leere Struktur zurück: items=[], total=0, apis={}, requests=0, models=[].

Fehler- und Leistungsempfehlungen

  • Aktivieren Sie standardmäßig nicht include_models; aktivieren Sie es nur, wenn der Bericht tatsächlich eine Aufschlüsselung nach Modellen benötigt.
  • Bei großflächigen Abfragen priorisieren Sie die getrennte Abfrage nach service_id oder application_id; dies vermeidet sowohl gemischte Einheiten als auch niedrigere Abfragekosten.
  • Tage ohne Aufrufe werden nicht automatisch mit Null aufgefüllt; ergänzen Sie die Datumsachse vor dem Zeichnen auf Clientseite.

Nächste Schritte