Zum Hauptinhalt springen
Abfrage der detaillierten Geschäfts-API-Aufrufe des aktuellen Kontos der letzten 60 Tage, geeignet zur Überprüfung von Abbuchungen, zur Lokalisierung fehlgeschlagener Anfragen sowie zur Fehlerbehebung nach Service, Application, API oder Credential.
Auf dieser Seite werden die Aufrufprotokolle des eigenen Kontos abgefragt. Wenn Sie nur die öffentlichen Aufrufstatistiken einer bestimmten API auf der gesamten Plattform anzeigen möchten, verwenden Sie bitte die API-Aufrufstatistiken.

Datenaufbewahrungsbereich

Aufrufaufzeichnungen und Abrechnungszusammenfassungen werden für die letzten 60 Tage aufbewahrt; Anfrage- und Antworttexte werden für die letzten 30 Tage aufbewahrt. Aufzeichnungen von 30–60 Tagen können weiterhin nach Trace, Status, Zeit, Modell, Nutzung und tatsächlicher Abbuchung sowie anderen Zusammenfassungen abgefragt werden, aber metadata.request und metadata.response in den Details werden nicht mehr zurückgegeben. Die für Modellzusammenfassungen und Statistiken gültiger Ergebnisse erforderlichen Zusammenfassungen werden bis zum Ablauf der Texte aufbewahrt. Wenn Texte langfristig aufbewahrt werden müssen, speichern Sie sie bitte beim Aufruf selbst.

Vorbereitungen

1. Konto-Token erstellen

Diese Schnittstelle gehört zur Plattformverwaltungs-API und erfordert die Verwendung eines Account Token (Konto-Token):
  1. Melden Sie sich bei der AceDataCloud-Plattform an.
  2. Öffnen Sie die Account-Token-Konsole.
  3. Klicken Sie auf „Erstellen“ und speichern Sie den Token sofort im Passwortmanager oder Secret Manager.
Eine vollständige Beschreibung finden Sie unter Verwalten von AceDataCloud-Plattform-Konto-Token. Konto-Token werden für platform.acedata.cloud/api/v1/** verwendet; für den Aufruf von Geschäfts-Schnittstellen unter api.acedata.cloud/** werden API-Credentials verwendet, und beide können nicht miteinander vermischt werden.
Schreiben Sie den Token nicht in Frontend-Code, Protokolle oder öffentliche Repositories; falls er offengelegt wird, löschen Sie ihn bitte sofort in der Konsole und erstellen Sie ihn erneut.

2. Filter-IDs vorbereiten (optional)

Ohne Filterbedingungen werden die Aufzeichnungen angezeigt, die das aktuelle Konto anzeigen darf. Wenn Sie den Bereich eingrenzen müssen: Normale Benutzer müssen user_id nicht übergeben; wenn es explizit übergeben wird, muss es mit dem aktuellen Konto übereinstimmen, andernfalls wird 403 zurückgegeben. Administratoren können diesen Parameter zur kontoübergreifenden Filterung verwenden.

Schnittstellenübersicht

Abfragebereich

Abfrageparameter

Wenn die Anfragezeit früher als die letzten 60 Tage liegt, gibt die Schnittstelle einen 400-Feldvalidierungsfehler zurück und weist darauf hin, dass vollständige Aufrufdetails nur 60 Tage aufbewahrt werden.

Anfragebeispiele

Abfrage der letzten 100 Aufzeichnungen:
Nach Zeit, Application und Fehlerstatus filtern:
Python-Paginierungsbeispiel:

Antwortbeispiel

Wichtige Felder

Die Kontingenteinheit wird durch service.unit der entsprechenden Application bestimmt und sollte nicht standardmäßig als US-Dollar betrachtet werden.

Fehler und Wiederholungsversuche

Für dieselbe Gruppe von Abfrageparametern darf höchstens eine Anfrage gleichzeitig in Bearbeitung sein. Verwenden Sie für umfangreiche Abfragen bevorzugt Zeitfenster von einem Tag oder weniger und überlagern Sie nicht identische Anfragen in festen Intervallen.

Nächste Schritte