Aktivitätsprotokoll

Das Aktivitätsprotokoll zeigt deine neuesten API-Requests in Echtzeit. Nutze es, um einzelne Requests zu debuggen, Response-Codes zu prüfen und deine Integration zu verifizieren.

Was du siehst

Das Protokoll zeigt Requests der letzten Stunde, mit den neuesten ganz oben. Jeder Eintrag enthält:

Feld	Beschreibung
Zeitstempel	Wann der Request gesendet wurde
Methode	An das Ziel gesendete HTTP-Methode (GET, POST etc.)
Route	Welcher FourA-Endpoint genutzt wurde (single, proxy oder browser)
Domain	Aus der Request-URL extrahierte Ziel-Domain
Status	Vom Ziel zurückgegebener HTTP-Statuscode
App-Status	In der Response-Body zurückgegebener Status auf App-Ebene
Ergebnis	Request-Klassifizierung (success, client_error, rate_limit etc.)
Dauer	Gesamte Response-Zeit in Millisekunden
Bytes In	Größe des Request-Payloads
Bytes Out	Größe des Response-Payloads
Schlüsselname	Welcher API-Key verwendet wurde
Client-IP	IP-Adresse, die den Request gesendet hat

Filtern

Drei Steuerelemente grenzen das Protokoll ein.

Nach API-Key

Nutze das API-Key-Dropdown, um Requests eines bestimmten Schlüssels anzuzeigen. Nur Schlüssel in deinem Zugriffsbereich erscheinen im Dropdown.

Nach Produkt

Filtere mit dem Selektor single / proxy / browser auf einen Endpoint. Nützlich, wenn du reine Browser-Fehler getrennt von Single-Requests debuggen willst.

Nach Limit

Das Aktivitätsprotokoll zeigt standardmäßig 50 Einträge. Nutze den Limit-Selektor, um die Anzahl der angezeigten Einträge zu ändern:

Limit	Notizen
10	Schnellansicht
50	Standard
100	Erweiterte Ansicht
200	Maximum

Alle Einträge stammen aus der letzten Stunde. Für historische Daten nutze den Bereich Metriken, der Daten über Tage und Wochen aggregiert.

Request öffnen

Klicke auf eine Zeile, um einen Detaildialog mit der vollständigen Vorschau des Request- und Response-Payloads zu öffnen. Der Dialog zeigt:

Meta-Grid: Zeitstempel, Key, HTTP-Status, App-Status, Ergebnis, Dauer und die X-Foura-Request-Id des Requests.
Request: Formatiertes (pretty-printed) JSON des exakt gesendeten Bodys mit einem Kopieren-Button.
Response: Meta-Leiste plus Body-Vorschau, mit entsprechenden Badges für abgeschnittene (truncated) oder binäre Inhalte.

Payloads werden 24 Stunden lang aufbewahrt, begrenzt auf die letzten 200 pro API-Key. Bei älteren Zeilen wird nur die Zeile ohne Detaildialog angezeigt.

Meldungen im Body-Bereich

Der Body-Bereich nutzt unterschiedliche Platzhaltertexte, je nachdem, was passiert ist:

Meldung	Bedeutung
`(no body — the request failed: <error>)`	Der Request schlug fehl, bevor das Ziel einen Body zurückgegeben hat
`(no body captured)`	Payload ist abgelaufen oder wurde nicht gespeichert
`(empty body — the server returned 0 bytes)`	Das Ziel hat eine tatsächlich leere Response zurückgegeben

Im Playground öffnen

Der Detaildialog enthält einen Button Im Playground öffnen. Klicke darauf, um sowohl den archivierten Request als auch die archivierte Response in das Formular des Playgrounds zu laden. Von dort aus kannst du Parameter anpassen und den Request erneut gegen die Live-API ausführen oder einfach das Ergebnis prüfen, ohne den Request erneut zu senden.

Der Button ist für nicht wiederholbare Payloads (zu große Request-Stubs und Nicht-API-Routen) deaktiviert, mit einem Hinweis zur Erklärung.

Nutzung der Request-ID

Jede API-Response enthält einen X-Foura-Request-Id-Header. Protokolliere ihn auf deiner Seite, um ihn bei Bedarf in ein Support-Ticket einzufügen und direkt auf den exakten Request im Aktivitätsprotokoll zu verweisen. Die ID ist dieselbe wie im Dialog und entspricht der von der API zurückgegebenen X-Foura-Request-Id. Details findest du in der Referenz zu den API-Endpoints.