Zmiany i wersjonowanie
Jedna wersja: v1 (typ application/vnd.allegro.public.v1+json). Zmiany zgodne wstecz — nowe trasy, nowe pola w odpowiedziach, nowe wartości wyliczeń w polach oznaczonych jako rozszerzalne — wchodzą bez zmiany wersji. Klient ma ignorować nieznane pola.
Zmianę niezgodną zapowiemy co najmniej 90 dni wcześniej: w dzienniku zmian, w panelu sprzedaży i nagłówkami Deprecation oraz Sunset na wygaszanych trasach. Specyfikacja maszynowa: OpenAPI 3.1 (JSON), YAML, także pod https://api.allee.pl/openapi.json.
Dziennik zmian
| Data | Zmiana |
|---|---|
| 2026-11-09 | Klucze osobiste i własne aplikacje OAuth (samoobsługa), token aplikacji client_credentials, odwołanie tokenu (RFC 7009), introspekcja /me/token, plany limitów i nagłówki X-Allee-RateLimit, kwarantanna, zgłaszanie wycieków. |
| 2026-11-09 | Allegro: /sale/offer-events, /sale/matching-categories, /sale/category-events, /sale/offers/unfilled-parameters, usuwanie szkicu, PUT/DELETE warunków i GPSR, /sale/images, podgląd opłat, wiadomości, reklamacje i dyskusje, odrzucenie zwrotu, faktury, śledzenie przesyłek, /marketplaces. |
| 2026-11-09 | Po amazonowemu: oferty po SKU (/allee/listings), schemat kategorii, wsady, raporty, powiadomienia push, konto i plan (/allee/sellers/account), Idempotency-Key, wgrywanie plików wprost do magazynu, sandbox z kluczami testowymi. |
| 2026-11-08 | Pierwsza wersja API zgodnego z Allegro: OAuth (PKCE), kategorie i parametry (także po alleeId), cenniki, warunki, GPSR, oferty, polecenia wsadowe, zamówienia, przesyłki, zdarzenia, zwroty, rozliczenia. |