Referencja API
Wszystkie operacje API allee.pl (164), pogrupowane według zasobów. Przy każdej: opis, parametry, schemat odpowiedzi, błędy i przykład w 7 językach — uruchomiony na środowisku testowym.
Start
Stan usługiCzy API działa (bez tokenu).3 operacjeOAuthAutoryzacja aplikacji: Authorization Code + PKCE (S256), odświeżanie z rotacją, token aplikacji (client_credentials), odwołanie (RFC 7009). Zgodne z Allegro.3 operacjeKontoKonto sprzedawcy, introspekcja tokenu lub klucza, plan użycia i limity.3 operacjeZgodność sprzedawcyProfil prawny (4 rodzaje sprzedawcy), statusy weryfikacji, lista braków z kodami, oświadczenia z wersjami i historia zmian (DSA, GPSR). Od 10.11.2026.13 operacjiSandboxSymulator kupującego dla kluczy testowych (allee_sk_test_…): zamówienia, zwroty, wiadomości — bez prawdziwych klientów.4 operacje
Oferty (zgodne z Allegro)
KategorieDrzewo kategorii i parametry po identyfikatorach Allegro, podpowiedź kategorii, zmiany drzewa.5 operacjiKategorie alleeTo samo drzewo po identyfikatorach allee + schemat atrybutów kategorii (JSON Schema).4 operacjeProduktyKatalog produktów — allee go nie prowadzi (zawsze pusta lista / 404).2 operacjeDostawaSłownik metod dostawy allee i cenniki dostawy sprzedawcy.5 operacjiWarunkiWarunki zwrotów, reklamacji (rękojmia) i gwarancji.15 operacjiGPSRProducenci i osoby odpowiedzialne (rozporządzenie GPSR).10 operacjiOfertyWystawianie i zmiana ofert w kształcie Allegro, lista, kupowalność, zdarzenia ofert.8 operacjiWarianty ofertZestawy wariantów (rozmiar, kolor): każdy wariant to osobna oferta z własnym stanem, ceną i EAN-em; jedna karta w wynikach (Allegro: oferty wielowariantowe).5 operacjiZdjęciaZdjęcia z adresu (Allegro) albo wgrane wprost do magazynu (podpisany adres PUT).2 operacjeOpłatyPodgląd opłat za wystawienie i prowizji.2 operacjePolecenia wsadoweZmiana ceny, liczby sztuk, ustawień i publikacji wielu ofert naraz.13 operacjiRynkiRynek allee-pl.1 operacja
Po amazonowemu
Listingi (SKU)Oferty adresowane SKU, z podglądem walidacji i listą problemów (Amazon Listings Items).5 operacjiWsady (feeds)Wsady JSON do 10 000 komunikatów przetwarzane w tle (Amazon Feeds).6 operacjiRaportyRaporty asynchroniczne CSV/JSON (Amazon Reports).6 operacjiPowiadomienia pushWebhooki podpisane HMAC-SHA256: destynacje, subskrypcje, dziennik dostaw (Amazon Notifications + podpis jak Stripe).14 operacji
Zamówienia i obsługa posprzedażowa
ZamówieniaZamówienia allee.pl, status realizacji, dziennik zdarzeń.5 operacjiPrzesyłkiNumery przesyłek, przewoźnicy, śledzenie.4 operacjeFakturyFaktury do zamówień: plik PDF albo link.6 operacjiWiadomościCentrum wiadomości z kupującymi.8 operacjiZwrotyZwroty kupujących (zasób BETA Allegro).4 operacjeDyskusje i reklamacjeReklamacje i dyskusje (zasób BETA Allegro).5 operacjiRozliczeniaOperacje rozliczeniowe konta.2 operacje
Bezpieczeństwo
Powiadomienia push (webhooki)
Treści powiadomień, które allee wysyła na Twój adres — opis w przewodniku Powiadomienia push.
| Typ | Opis |
|---|---|
ORDER_CHANGE | ORDER_CHANGE — zmiana zamówienia. |
OFFER_STATUS_CHANGE | OFFER_STATUS_CHANGE — aktywacja, zakończenie. |
OFFER_ISSUES_CHANGE | OFFER_ISSUES_CHANGE — nowe problemy oferty. |
MESSAGE_RECEIVED | MESSAGE_RECEIVED — nowa wiadomość kupującego (bez treści — pobierz GET /messaging/messages/{id}). |
RETURN_CHANGE | RETURN_CHANGE — zwrot. |
ISSUE_CHANGE | ISSUE_CHANGE — reklamacja lub dyskusja. |
FEED_PROCESSING_FINISHED | FEED_PROCESSING_FINISHED — wsad przetworzony. |
REPORT_PROCESSING_FINISHED | REPORT_PROCESSING_FINISHED — raport gotowy. |
API_KEY_SECURITY_EVENT | API_KEY_SECURITY_EVENT — zdarzenie bezpieczeństwa klucza lub aplikacji. |
SELLER_COMPLIANCE_CHANGED | SELLER_COMPLIANCE_CHANGED — zmienił się stan zgodności (status, braki, oświadczenia albo blokada). Szczegóły: GET /allee/sellers/compliance. Bez danych osobowych. |
OFFER_NOTICE_RECEIVED | OFFER_NOTICE_RECEIVED — nowe zgłoszenie nielegalnej treści dotyczące oferty lub sklepu. Szczegóły: GET /allee/notices. |
OFFER_RESTRICTED | OFFER_RESTRICTED — decyzja allee wobec oferty lub konta. Uzasadnienie: GET /allee/decisions/{id}. |
TEST_NOTIFICATION | TEST_NOTIFICATION — wysyłane przez …/test. |
DESTINATION_VERIFICATION | DESTINATION_VERIFICATION — weryfikacja adresu przy zakładaniu destynacji. |