API-Protokolle

Wenn etwas zwischen Plugin und Mirakl-Betreiber schiefgeht, ist diese Seite die erste Anlaufstelle. Jeder API-Aufruf des Plugins wird mit der Antwort des Betreibers, dem HTTP-Status, der Dauer und den vollständigen Payload-Bodies protokolliert. Wenn ein Angebot abgelehnt wird, eine Versandbestätigung scheitert oder ein Produktimport nie abschließt, liegt die Antwort meist in einer dieser Zeilen.

Wo zu finden

Öffnen Sie im Dashboard die Karte Quick Start und klicken Sie die Kachel API Logs. Dies öffnet die Seite API Logs.

Was angezeigt wird

Spalten:

Spalte	Bedeutung
Type	Welcher Mirakl-Endpunkt aufgerufen wurde (z. B. OF24 — Create/Update Offers, OR11 — Orders List).
Method	HTTP-Methode (GET, POST usw.).
URL	Die vollständige Request-URL.
Status	HTTP-Statuscode des Betreibers.
Duration (ms)	Wie lange der Aufruf dauerte.
Success	Ja / Nein — ob der Aufruf einen Nicht-Fehler-Status zurückgab.
Date	Wann der Aufruf gemacht wurde.

Per-Zeile-Aktion View Detail öffnet eine Seite mit dem vollständigen Request- und Response-Body — das mit dem Betreiber ausgetauschte Roh-Payload.

Filter

Die Seitenleiste hat:

• Request Type — nach spezifischem Mirakl-Endpunkt filtern. Das Dropdown listet benannte Endpunkte wie OF24 — Create/Update Offers, OF02 — Offers Import Status, OF61 — Offer States, STO01 — Stock Import, P41 — Products Import, P42 — Products Import Status, PM11 — Product Attributes, H11 — Hierarchies (Categories), OR11 — Orders List.
• Success — nur erfolgreiche (oder nur fehlgeschlagene) Aufrufe anzeigen.
• Connection — auf eine Mirakl-Verbindung eingrenzen.

Wann diese Seite verwenden

Fehlgeschlagene Angebotssynchronisation: filtern nach Request Type → OF24 und Success → Nein, um jedes fehlgeschlagene Angebots-Push zu sehen. Der Response-Body erklärt genau, was der Betreiber abgelehnt hat.

Hängender Bestellungsimport: filtern nach Request Type → OR11, um zu prüfen, ob das Plugin tatsächlich den Bestellungen-Endpunkt des Betreibers erreicht, und die Antwort prüfen.

Performance-Beschwerden: nach Duration absteigend sortieren, um langsame Aufrufe zu finden — typischerweise schwere Importe oder Betreiber-seitiges Limit.

Neue Verbindung verifizieren: die ersten PM11-, H11- und OF61-Aufrufe nach Connect Mirakl sollten alle Success → Ja zeigen. Wenn einer fehlschlug, sind die Verbindungseinstellungen oder der API-Schlüssel falsch.

Aufbewahrung

API-Log-Zeilen werden für die unter API-Protokoll-Aufbewahrung (Tage) in Mirakl → Einstellungen → Sync-Einstellungen eingestellte Dauer aufbewahrt. Ältere Zeilen werden vom geplanten Task API-Protokoll-Aufräumung gelöscht (Standard: alle 24 Stunden).

Tipps & Fallstricke

Tipp

Die Spalte Date ist die Aufrufzeit, nicht die Antwortzeit. Wenn Sie einem bestimmten Fehler nachgehen, finden Sie die Zeile mit dem Zeitstempel, der dem Bemerken des Problems am nächsten ist, und öffnen dann View Detail für die vollständige Betreiber-Antwort.

Achtung

API-Logs enthalten vollständige Request- und Response-Payloads — einschließlich Betreiber-API-Schlüsseln in Headern (Wert teilweise geschwärzt) und Kundendaten in Order-Responses. Fügen Sie diese nicht ohne Schwärzung in öffentliche Fehlerberichte ein.

Hinweis

Auch erfolgreiche Aufrufe werden protokolliert — nicht nur Fehler. Der Filter Success → Ja ist nützlich, um zu bestätigen “ist das tatsächlich gelaufen?”, wenn ein Feature scheinbar nichts tut.

Verwandt

• Sync logs — höhere Plugin-Ebenen-Ereignisse (weniger detailliert als API-Logs)
• Troubleshooting — häufige Fehlermuster und Lösungen
• API throttling — Betreiber-Limits sichtbar in API-Log-Dauern
• Einstellungen — API-Protokoll-Aufbewahrung (Tage) setzen