Różnice względem Allegro
Klient Allegro REST API działa po zmianie dwóch adresów: https://api.allee.pl (API) i https://api.allee.pl/auth/oauth (OAuth). Te same ścieżki, nagłówki Accept/Content-Type (application/vnd.allegro.public.v1+json; zasoby BETA: …beta.v1+json), format błędów i przepływ OAuth.
Inaczej niż w Allegro
| Obszar | allee.pl |
|---|---|
| Kategorie | Każda kategoria i parametr ma też alleeId; wystawiasz po category.id (Allegro) albo category.alleeId — przy obu wygrywa allee |
| Katalog produktów | Brak — /sale/products pusty, oferta zawsze z pełnymi danymi produktu |
| Parametr Stan | Przyjmowany w każdej kategorii, także gdy jej drzewo go nie ma. Słownik pokazuje wartości Allegro, ale allee zapisuje tylko 4 (options.alleeSupported: true): Nowy, Używany, Odnowiony przez sprzedawcę, Uszkodzony — inne dają 422 DictionaryParameterValueNotFound |
| Metody dostawy | Słownik własny allee (stałe UUID) — weź z /sale/delivery-methods; metodę możesz wskazać po nazwie |
| Wystawienie | Zawsze 201 z pełnym obiektem (bez 202); zdjęcia pobierane w tle (status ACTIVATING) |
| Polecenia wsadowe | Wykonywane od razu — taskCount ostateczny w odpowiedzi PUT |
| Opis oferty | Zapisywany jako tekst (formatowanie, skrypty i style znikają); odczyt zwraca prosty HTML: akapity p i br, a nagłówek tuż przed listą wraca jako h2 + ul/li. Nie porównuj opisu 1:1 z wysłanym |
| Licytacje | Przez API tylko „Kup teraz” (licytacje z panelu) |
| Waluty, jednostki | Tylko PLN i sztuki (UNIT) |
| Zamówienia | Widoczne od READY_FOR_PROCESSING; obsługuje je jedna integracja naraz (403 ORDERS_OWNED_BY_OTHER_INTEGRATION) |
| Wiadomości | Bez załączników; nową rozmowę sprzedawca zaczyna tylko w sprawie zamówienia |
Więcej niż w Allegro
- Klucze osobiste z panelu — każdy sprzedawca sam, bez rejestracji aplikacji.
- Oferty po SKU z podglądem walidacji i
issues[](PUT /allee/listings/{sku}), schemat JSON kategorii,?validateOnly=truedla ofert Allegro. - Wsady do 10 000 komunikatów, raporty asynchroniczne, powiadomienia push z podpisem HMAC.
Idempotency-Keyna każdym POST, nagłówki planów limitów, introspekcja tokenu (GET /me/token), kupowalność oferty (GET /sale/offers/{offerId}/buyability).- Faktura PDF jednym żądaniem albo jako link, deklaracja zwrotu pieniędzy przy zwrocie, termin ustawowy reklamacji w odpowiedzi.
- Sandbox na tym samym adresie (klucz testowy) z symulatorem kupującego.
Czego allee nie ma
Allegro One Fulfillment, Wysyłam z Allegro, kampanie i promowanie Allegro, ogłoszenia płatne, licytowanie jako kupujący, płatności i zwroty pieniędzy przez API (allee nie przenosi pieniędzy), karty produktów. Takie trasy zwracają 404.