API Logs

Gdy coś idzie nie tak między wtyczką a operatorem Mirakl, ta strona jest pierwszym miejscem, gdzie patrzeć. Każde wywołanie API wtyczki jest logowane z odpowiedzią operatora, statusem HTTP, czasem wykonania i pełnymi payloadami. Jeśli oferta zostaje odrzucona, potwierdzenie wysyłki nie dochodzi, albo import produktów nigdy się nie kończy — odpowiedź zwykle jest w jednym z tych wierszy.

Gdzie to znaleźć

Na Dashboard otwórz kartę Quick Start i kliknij kafelek API Logs. Otworzy to stronę API Logs.

Co widzisz

Kolumny:

Kolumna	Znaczenie
Type	Który endpoint Mirakla został wywołany (np. OF24 — Create/Update Offers, OR11 — Orders List).
Method	Metoda HTTP (GET, POST itp.).
URL	Pełny URL requestu.
Status	Kod statusu HTTP zwrócony przez operatora.
Duration (ms)	Ile trwało wywołanie.
Success	Yes / No — czy wywołanie zwróciło status nie-błędu.
Date	Kiedy wywołanie zostało wykonane.

Akcja per wiersz View Detail otwiera stronę pokazującą pełny request body i pełny response body — surowy payload wymieniany z operatorem.

Filtry

Pasek boczny ma:

• Request Type — filtruj po konkretnym endpoincie Mirakl. Lista rozwijana zawiera nazwane endpointy jak 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 — pokaż tylko udane (lub tylko nieudane) wywołania.
• Connection — zawęź do jednego połączenia Mirakl.

Kiedy używać tej strony

Nieudana synchronizacja ofert: filtruj Request Type → OF24 i Success → No, żeby zobaczyć każde nieudane wypchnięcie oferty. Response body wyjaśnia dokładnie, co operator odrzucił.

Zacięty import zamówień: filtruj Request Type → OR11, żeby zweryfikować, że wtyczka faktycznie dociera do endpointu zamówień operatora, i sprawdź odpowiedź.

Skargi na wydajność: sortuj po Duration malejąco, żeby znaleźć wolne wywołania — typowo ciężkie importy albo ograniczenia po stronie operatora.

Weryfikacja nowego połączenia: pierwsze wywołania PM11, H11 i OF61 po Connect Mirakl powinny wszystkie pokazywać Success → Yes. Jeśli któreś nie powiodło się, ustawienia połączenia lub klucz API są błędne.

Retencja

Wiersze API log są przechowywane przez czas ustawiony w API Log Retention (days) w Mirakl → Settings → Sync Settings. Starsze wiersze są usuwane przez zaplanowany task API log cleanup (domyślnie co 24 godziny).

Wskazówki i pułapki

Wskazówka

Kolumna Date to czas wywołania, nie czas odpowiedzi. Gdy szukasz konkretnego niepowodzenia, znajdź wiersz po znaczniku czasu najbliższym momentowi zauważenia problemu, potem otwórz View Detail, żeby zobaczyć pełną odpowiedź operatora.

Uwaga

API logs zawierają pełne payloady request i response — w tym klucze API operatora w nagłówkach (wartość częściowo redagowana) oraz dane klientów w response zamówień. Nie wklejaj ich do publicznych zgłoszeń bez wcześniejszego redagowania.

Notatka

Udane wywołania też są logowane — nie tylko niepowodzenia. Filtr Success → Yes jest przydatny do potwierdzenia “czy to faktycznie się wykonało?”, gdy feature wydaje się nic nie robić.

Powiązane

• Sync logs — zdarzenia wyższego poziomu w wtyczce (mniej szczegółowe niż API logs)
• Troubleshooting — wzorce typowych błędów i rozwiązania
• API throttling — limity operatora widoczne w czasach API log
• Settings — ustaw API Log Retention (days)