Aktivitätsprotokoll
Das Activity Log zeigt deine neuesten API-Requests in Echtzeit. Nutze es, um einzelne Requests zu debuggen, Response Codes zu prüfen und sicherzustellen, dass deine Integration funktioniert.
Was du siehst
Das Log zeigt Requests der letzten Stunde an, wobei die neuesten oben stehen. Neun Spalten bilden die gesamte Zeile:
| Spalte | Was sie zeigt |
|---|---|
| Time | Wann der Request gemacht wurde |
| Key | Welcher API Key verwendet wurde |
| Request | Der Call selbst: ein farbiger Produktpunkt (single, proxy oder browser), die HTTP-Methode und die Ziel-Domain. Sortiert nach Domain. |
| Status | Zwei Werte in einer Zelle, getrennt durch einen Schrägstrich: der HTTP-Status deines Calls an FourA, dann der vom Ziel zurückgegebene Status. Ein Strich bedeutet, dass das Ziel nie geantwortet hat. |
| Outcome | Request-Klassifizierung (Success, Client Error, Rate Limited und so weiter) |
| Duration | Gesamte Response-Zeit in Millisekunden |
| Bytes | Transfer in beide Richtungen in einer Zelle: Pfeil nach unten für die Request-Payload, Pfeil nach oben für die Response |
| Credits | Verbrauchte Credits für den Call (siehe Response Headers) |
| Client IP | Die Adresse, die den Request gemacht hat |
Klicke auf einen beliebigen Spaltenkopf, um die Tabelle nach dieser Spalte zu sortieren. Die Richtung wechselt zwischen absteigend, aufsteigend und aus. Ein Klick mit Strg oder Cmd setzt auf den Standard zurück (neueste zuerst).
Filtern
Drei Steuerelemente grenzen das Log ein.
Nach API Key
Nutze das API-Key-Dropdown, um Requests von einem Key anzuzeigen. Nur Keys in deinem Zugriffsbereich erscheinen im Dropdown.
Nach Produkt
Filtere auf einen Endpoint mit dem single / proxy / browser Selektor. Nützlich, wenn du reine Browser-Fehler getrennt von Single-Requests debuggen willst.
Nach Limit
Das Activity Log zeigt standardmäßig 50 Einträge an. Nutze den Limit-Selektor, um die Anzahl der angezeigten Einträge zu ändern:
| Limit | Notizen |
|---|---|
| 10 | Schneller Scan |
| 50 | Standard |
| 100 | Erweiterte Ansicht |
| 200 | Maximum |
Alle Einträge sind aus der letzten Stunde. Für historische Daten nutze den Metrics Bereich, der Daten über Tage und Wochen aggregiert.
Einen Request öffnen
Klicke auf eine beliebige Zeile, um ein Detail-Panel mit der vollständigen Vorschau der Request- und Response-Payload zu öffnen. Das Panel öffnet sich in einem Meta-Grid, das aus der Zeile selbst erstellt wird, sodass es nützlich bleibt, auch wenn die gespeicherte Payload abgelaufen ist: Timestamp, Key, HTTP-Status, App-Status, Outcome, Duration, Credits, Proxy und die X-FourA-Request-Id des Requests.
Unter dem Grid wird jeweils ein Bereich angezeigt, der per Tab ausgewählt wird:
| Tab | Was er zeigt |
|---|---|
| Request | Pretty-printed JSON des exakt gesendeten Bodys |
| Response Headers | Die vom Ziel zurückgegebenen Headers, mit einer Zählung auf dem Tab |
| Response Body | Die gespeicherte Body-Vorschau, mit Truncated- und Binary-Badges, wo zutreffend |
| Andere Felder | Alles andere, was die Engine neben Status, Timings, Proxy und Headers zurückgegeben hat. Ausgeblendet, wenn es nichts Zusätzliches gibt. |
Ein Copy-Button kopiert den jeweils geöffneten Bereich. Payloads werden 24 Stunden lang aufbewahrt, begrenzt auf die letzten 200 pro API Key. Ältere Zeilen zeigen nur die Zeile an, ohne Payload.
Body-Bereich-Nachrichten
Der Body-Bereich verwendet je nach Ereignis unterschiedliche Platzhaltertexte:
| Nachricht | Bedeutung |
|---|---|
(no body — the request failed: <error>) |
Der Request schlug fehl, bevor das Ziel einen Body zurückgab |
(no body captured for this request) |
Payload abgelaufen oder nicht gespeichert |
(empty body — the server returned 0 bytes) |
Das Ziel gab eine echte leere Response zurück |
Im Playground öffnen
Der Detaildialog hat einen Open in Playground-Button. Klicke darauf, um sowohl den archivierten Request als auch die archivierte Response in das Playground-Formular zu laden. Von dort aus kannst du Parameter anpassen und gegen die Live-API erneut abspielen oder einfach die Rückgabe untersuchen, ohne den Request neu auszuführen.
Der Button ist für nicht wiederholbare Payloads (übergroße Request-Stubs und Nicht-API-Routen) deaktiviert, mit einem Hinweis, der den Grund erklärt.
Nutzung der Request-ID
Jede API-Response enthält einen X-Foura-Request-Id-Header. Protokolliere ihn auf deiner Seite. Du kannst ihn in ein Support-Ticket einfügen, um auf den genauen Request im Activity Log zu verweisen. Die ID ist dieselbe wie in diesem Dialog und entspricht der von der API zurückgegebenen X-Foura-Request-Id. Weitere Details findest du unter Response Headers.
Verwandte Themen
- Metrics and Analytics: Aggregierte Leistungsdaten über längere Zeiträume
- Playground: Requests aus Activity erneut abspielen
- Response Headers: Woher die Request-ID und die Credits stammen
- API Endpoints: Request- und Response-Formate
- Troubleshooting: Häufige Probleme und Lösungen