Integracja z Allegro API: OAuth, limity zapytań i obsługa błędów

Autoryzacja i cykl życia tokenu

Allegro używa OAuth 2.0. Dla aplikacji działających w imieniu sprzedawcy właściwym przepływem jest Authorization Code (z PKCE), a nie Client Credentials — ten drugi daje dostęp wyłącznie do danych publicznych.

Token dostępowy jest krótkotrwały, refresh token długotrwały. Odświeżaj token z zapasem (np. 2 minuty przed wygaśnięciem) i traktuj każdą odpowiedź 401 jako sygnał do jednorazowej próby odświeżenia i powtórzenia żądania.

Kody błędów i właściwa reakcja

• 401 — token wygasł lub został unieważniony: odśwież i powtórz raz
• 403 — brak uprawnień w zakresie (scope): nie ponawiaj, poproś o ponowne połączenie konta
• 429 — przekroczony limit: odczekaj czas z nagłówka Retry-After, nie ponawiaj natychmiast
• 5xx — problem po stronie API: retry z wykładniczym backoffem i limitem prób
• 4xx pozostałe — błąd danych: zapisz do logu błędów i pomiń rekord, nie przerywaj całego zadania

Import, który da się wznowić

Zadanie synchronizacji powinno zapisywać kursor (offset lub token strony) po każdej udanej stronie wyników. Przerwany import wznawiasz od ostatniego kursora zamiast zaczynać od zera.

Osobno warto liczyć rekordy przetworzone i nieudane. Job, który zakończył się z 40 błędami na 12 000 ofert, jest sukcesem — pod warunkiem, że masz listę tych 40 z treścią błędu.

Logowanie i diagnostyka

Każde wywołanie API warto zapisać z metodą, endpointem, kodem odpowiedzi i czasem trwania. To pozwala wykryć, że limit 429 pojawia się tylko na jednym endpoincie, albo że średni czas odpowiedzi wzrósł trzykrotnie zanim użytkownicy zaczną zgłaszać problemy.