Przejdź do treści

Lista kategorii

GET /sale/categories

zgodna z Allegrolimit: read

Działy główne albo dzieci wskazanej kategorii (parent.id = identyfikator Allegro). Każda kategoria ma oba identyfikatory: id (Allegro) i alleeId.

Wystarczy dowolny ważny token — także token aplikacji (client_credentials).

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /sale/categories.
Uprawnienie: dowolny ważny token lub klucz (działa też token aplikacji client_credentials).
Grupa limitu: read.

Parametry zapytania

parent.id string

Identyfikator kategorii nadrzędnej (Allegro). Brak = działy główne.

Odpowiedzi

200 Kategorie. · CategoryList
categories array<Category> zawsze
Pola obiektu
id string zawsze

Identyfikator Allegro.

alleeId integer zawsze

Identyfikator allee.

name string zawsze
parent object · null zawsze

Kategoria nadrzędna; null dla działu głównego.

Pola obiektu
id string · null zawsze
alleeId integer zawsze
leaf boolean zawsze

Czy to kategoria najniższego poziomu (tylko w liściu można wystawić ofertę).

options object zawsze

Zawsze {} (zgodność z Allegro).

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
404CATEGORY_NOT_FOUNDNie ma takiej kategorii.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Podkategorie działu „Kultura i rozrywka”
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "categories": [
    {
      "id": "66813",
      "alleeId": 17,
      "name": "Audiobooki - CD",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "253753",
      "alleeId": 18,
      "name": "Audiobooki - mp3",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "300881",
      "alleeId": 20,
      "name": "Bilety",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "118",
      "alleeId": 25,
      "name": "Czasopisma",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "5893",
      "alleeId": 32,
      "name": "Ebooki",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "20585",
      "alleeId": 35,
      "name": "Filmy",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": true,
      "options": {}
    },
    {
      "id": "306453",
      "alleeId": 38,
      "name": "Gadżety",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "9",
      "alleeId": 39,
      "name": "Gry",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "122640",
      "alleeId": 44,
      "name": "Instrumenty",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "28496",
      "alleeId": 45,
      "name": "Kalendarze, notesy, planery",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "257900",
      "alleeId": 47,
      "name": "Kody i doładowania",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "79413",
      "alleeId": 50,
      "name": "Komiksy",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "7",
      "alleeId": 54,
      "name": "Książki",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "325021",
      "alleeId": 57,
      "name": "Mapy, atlasy",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": true,
      "options": {}
    },
    {
      "id": "1",
      "alleeId": 63,
      "name": "Muzyka",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": true,
      "options": {}
    },
    {
      "id": "66820",
      "alleeId": 75,
      "name": "Podręczniki szkolne",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": false,
      "options": {}
    },
    {
      "id": "301130",
      "alleeId": 109,
      "name": "Wyjątkowe chwile",
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6
      },
      "leaf": true,
      "options": {}
    }
  ]
}

Kategoria

GET /sale/categories/{categoryId}

zgodna z Allegrolimit: read

Jedna kategoria po identyfikatorze Allegro. leaf: true = można w niej wystawiać.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /sale/categories/{categoryId}.
Uprawnienie: dowolny ważny token lub klucz (działa też token aplikacji client_credentials).
Grupa limitu: read.

Parametry ścieżki

categoryId string wymagany

Identyfikator kategorii Allegro (liczba albo UUID).

Odpowiedzi

200 Kategoria. · Category
id string zawsze

Identyfikator Allegro.

alleeId integer zawsze

Identyfikator allee.

name string zawsze
parent object · null zawsze

Kategoria nadrzędna; null dla działu głównego.

Pola obiektu
id string · null zawsze
alleeId integer zawsze
leaf boolean zawsze

Czy to kategoria najniższego poziomu (tylko w liściu można wystawić ofertę).

options object zawsze

Zawsze {} (zgodność z Allegro).

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
404CATEGORY_NOT_FOUNDNie ma takiej kategorii.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/sale/categories/20585" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "id": "20585",
  "alleeId": 35,
  "name": "Filmy",
  "parent": {
    "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
    "alleeId": 6
  },
  "leaf": true,
  "options": {}
}

Parametry kategorii

GET /sale/categories/{categoryId}/parameters

Allegro + rozszerzenialimit: read

Parametry kategorii z wymagalnością, typem, ograniczeniami i słownikiem wartości. Słownik bywa węższy niż w Allegro — zawsze bierz go stąd.

Parametr Stan (11323) przyjmujemy w każdej kategorii; wartości obsługiwane przez allee mają options.alleeSupported: true. Listy są buforowane 10 minut.

Zgodność: zgodna z Allegro REST API, z rozszerzeniami allee (pola allee.*, alleeId) — GET /sale/categories/{categoryId}/parameters.
Uprawnienie: dowolny ważny token lub klucz (działa też token aplikacji client_credentials).
Grupa limitu: read.

Parametry ścieżki

categoryId string wymagany

Identyfikator kategorii Allegro.

Odpowiedzi

200 Parametry. · CategoryParameterList
parameters array<CategoryParameter> zawsze
Pola obiektu
id string zawsze

Identyfikator parametru Allegro.

alleeId integer zawsze

Identyfikator allee.

name string zawsze
type string zawsze
Wartości: dictionary, integer, float, string
required boolean zawsze

Wymagany w tej kategorii.

requiredForProduct boolean zawsze

Zawsze false (allee nie ma kart produktów).

unit string · null zawsze

Jednostka, np. kg.

options object zawsze
Pola obiektu
customValuesEnabled boolean zawsze

Zawsze false — tylko wartości ze słownika.

ambiguousValueId string · null zawsze
restrictions object zawsze

Ograniczenia wartości (sprawdzane przy zapisie oferty).

Pola obiektu
multipleChoices boolean

Czy wolno wybrać kilka wartości słownika.

minLength integer
maxLength integer
allowedNumberOfValues integer
min number
max number
range boolean

Zawsze false (zakresy nieobsługiwane).

precision integer

Miejsca po przecinku (float).

dictionary array<object>

Wartości słownika (typ dictionary).

Pola obiektu
id string zawsze

Identyfikator wartości Allegro.

alleeId integer zawsze
value string zawsze
dependsOnValueIds array<string> zawsze

Przekazujemy jak Allegro, nie sprawdzamy przy zapisie.

options object
Pola obiektu
alleeSupported boolean zawsze

Parametr Stan: czy allee przyjmuje tę wartość.

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
404CATEGORY_NOT_FOUNDNie ma takiej kategorii.
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/sale/categories/20585/parameters" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "parameters": [
    {
      "id": "11323",
      "alleeId": 669,
      "name": "Stan",
      "type": "dictionary",
      "required": true,
      "requiredForProduct": false,
      "unit": null,
      "options": {
        "customValuesEnabled": false,
        "ambiguousValueId": null
      },
      "restrictions": {
        "multipleChoices": false
      },
      "dictionary": [
        {
          "id": "11323_1",
          "alleeId": 6386,
          "value": "Nowy",
          "dependsOnValueIds": [],
          "options": {
            "alleeSupported": true
          }
        },
        {
          "id": "11323_2",
          "alleeId": 6387,
          "value": "Używany",
          "dependsOnValueIds": [],
          "options": {
            "alleeSupported": true
          }
        }
      ]
    },
    {
      "id": "246845",
      "alleeId": 8973,
      "name": "Nośnik",
      "type": "dictionary",
      "required": true,
      "requiredForProduct": false,
      "unit": null,
      "options": {
        "customValuesEnabled": false,
        "ambiguousValueId": null
      },
      "restrictions": {
        "multipleChoices": false
      },
      "dictionary": [
        {
          "id": "246845_622161",
          "alleeId": 79215,
          "value": "płyta Blu-ray 3D",
          "dependsOnValueIds": []
        },
        {
          "id": "246845_622165",
          "alleeId": 79216,
          "value": "płyta DVD",
          "dependsOnValueIds": []
        },
        {
          "id": "246845_622169",
          "alleeId": 79217,
          "value": "płyta Blu-ray",
          "dependsOnValueIds": []
        },
        {
          "id": "246845_728783",
          "alleeId": 79218,
          "value": "płyta Blu-ray 4K",
          "dependsOnValueIds": []
        },
        {
          "id": "246845_622173",
          "alleeId": 79219,
          "value": "płyta VCD",
          "dependsOnValueIds": []
        },
        {
          "id": "246845_622177",
          "alleeId": 79220,
          "value": "kaseta wideo",
          "dependsOnValueIds": []
        },
        {
          "id": "246845_738593",
          "alleeId": 79221,
          "value": "płyta DVD+Książka",
          "dependsOnValueIds": []
        }
      ]
    },
    {
      "id": "250077",
      "alleeId": 10923,
      "name": "Gatunek",
      "type": "dictionary",
      "required": true,
      "requiredForProduct": false,
      "unit": null,
      "options": {
        "customValuesEnabled": false,
        "ambiguousValueId": null
      },
      "restrictions": {
        "multipleChoices": false
      },
      "dictionary": [
        {
          "id": "250077_1797493",
          "alleeId": 258674,
          "value": "anime",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797494",
          "alleeId": 258675,
          "value": "bollywood",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797495",
          "alleeId": 258676,
          "value": "dla dzieci",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797496",
          "alleeId": 258677,
          "value": "dokumentalne",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797497",
          "alleeId": 258678,
          "value": "dramaty",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797498",
          "alleeId": 258679,
          "value": "fantasy",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797499",
          "alleeId": 258680,
          "value": "horrory",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797500",
          "alleeId": 258681,
          "value": "kabarety",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797501",
          "alleeId": 258682,
          "value": "komedie",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797503",
          "alleeId": 258683,
          "value": "kostiumowe",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797504",
          "alleeId": 258684,
          "value": "kryminały",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797505",
          "alleeId": 258685,
          "value": "kursy, ćwiczenia",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797506",
          "alleeId": 258686,
          "value": "musicale",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797507",
          "alleeId": 258687,
          "value": "opery",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797508",
          "alleeId": 258688,
          "value": "popularnonaukowe",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797510",
          "alleeId": 258689,
          "value": "przygodowe",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797511",
          "alleeId": 258690,
          "value": "romanse",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797512",
          "alleeId": 258691,
          "value": "science fiction",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797513",
          "alleeId": 258692,
          "value": "sensacyjne",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797514",
          "alleeId": 258693,
          "value": "seriale",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797515",
          "alleeId": 258694,
          "value": "spektakle teatralne",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797516",
          "alleeId": 258695,
          "value": "thrillery",
          "dependsOnValueIds": []
        },
        {
          "id": "250077_1797
… (skrócono — pełna odpowiedź ma 40 KB)

Podpowiedź kategorii dla nazwy

GET /sale/matching-categories

Allegro + rozszerzenialimit: read

Najlepiej pasujące kategorie-liście dla nazwy produktu (z bazy słów kategorii allee, bez modeli AI na żywo). Najlepsza pierwsza; allee.score = trafność.

Zgodność: zgodna z Allegro REST API, z rozszerzeniami allee (pola allee.*, alleeId) — GET /sale/matching-categories.
Uprawnienie: dowolny ważny token lub klucz (działa też token aplikacji client_credentials).
Grupa limitu: read.

Parametry zapytania

name string wymagany

Nazwa produktu albo tytuł oferty, np. „film dvd” (2–200 znaków).

Odpowiedzi

200 Podpowiedzi. · MatchingCategoryList
matchingCategories array<object> zawsze
Pola obiektu
id string · null zawsze
alleeId integer zawsze
name string zawsze
leaf boolean zawsze
parent MatchingCategoryParent · null zawsze
Pola obiektu
id string · null zawsze
alleeId integer zawsze
name string zawsze
leaf boolean zawsze
parent MatchingCategoryParent · null zawsze
allee object zawsze
Pola obiektu
score number zawsze

Trafność dopasowania (większa = lepsza).

Błędy

HTTPKodZnaczenie
400VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/sale/matching-categories?name=film%20dvd" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "matchingCategories": [
    {
      "id": "748",
      "alleeId": 353,
      "name": "Film, telewizja",
      "leaf": true,
      "parent": {
        "id": "118",
        "alleeId": 25,
        "name": "Czasopisma",
        "leaf": false,
        "parent": {
          "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
          "alleeId": 6,
          "name": "Kultura i rozrywka",
          "leaf": false,
          "parent": null
        }
      },
      "allee": {
        "score": 13
      }
    },
    {
      "id": "20585",
      "alleeId": 35,
      "name": "Filmy",
      "leaf": true,
      "parent": {
        "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
        "alleeId": 6,
        "name": "Kultura i rozrywka",
        "leaf": false,
        "parent": null
      },
      "allee": {
        "score": 12
      }
    },
    {
      "id": "306309",
      "alleeId": 10741,
      "name": "Rękawy foliowe",
      "leaf": true,
      "parent": {
        "id": "64537",
        "alleeId": 2309,
        "name": "Folia",
        "leaf": false,
        "parent": {
          "id": "64482",
          "alleeId": 770,
          "name": "Pakowanie i wysyłka",
          "leaf": false,
          "parent": {
            "id": "64477",
            "alleeId": 21,
            "name": "Biuro i Reklama",
            "leaf": false,
            "parent": {
              "id": "4bd97d96-f0ff-46cb-a52c-2992bd972bb1",
              "alleeId": 4,
              "name": "Firma i usługi",
              "leaf": false,
              "parent": null
            }
          }
        }
      },
      "allee": {
        "score": 6
      }
    },
    {
      "id": "64548",
      "alleeId": 11290,
      "name": "Stretch",
      "leaf": true,
      "parent": {
        "id": "64537",
        "alleeId": 2309,
        "name": "Folia",
        "leaf": false,
        "parent": {
          "id": "64482",
          "alleeId": 770,
          "name": "Pakowanie i wysyłka",
          "leaf": false,
          "parent": {
            "id": "64477",
            "alleeId": 21,
            "name": "Biuro i Reklama",
            "leaf": false,
            "parent": {
              "id": "4bd97d96-f0ff-46cb-a52c-2992bd972bb1",
              "alleeId": 4,
              "name": "Firma i usługi",
              "leaf": false,
              "parent": null
            }
          }
        }
      },
      "allee": {
        "score": 6
      }
    },
    {
      "id": "324422",
      "alleeId": 6341,
      "name": "Wydania pudełkowe",
      "leaf": true,
      "parent": {
        "id": "324420",
        "alleeId": 395,
        "name": "Gry komputerowe PC",
        "leaf": false,
        "parent": {
          "id": "9",
          "alleeId": 39,
          "name": "Gry",
          "leaf": false,
          "parent": {
            "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45",
            "alleeId": 6,
            "name": "Kultura i rozrywka",
            "leaf": false,
            "parent": null
          }
        }
      },
      "allee": {
        "score": 6
      }
    },
    {
      "id": "259428",
      "alleeId": 3682,
      "name": "Nagrywarki DVD/HDD",
      "leaf": true,
      "parent": {
        "id": "717",
        "alleeId": 1169,
        "name": "TV i Video",
        "leaf": false,
        "parent": {
          "id": "10",
          "alleeId": 86,
          "name": "RTV i AGD",
          "leaf": false,
          "parent": {
            "id": "42540aec-367a-4e5e-b411-17c09b08e41f",
            "alleeId": 3,
            "name": "Elektronika",
            "leaf": false,
            "parent": null
          }
        }
      },
      "allee": {
        "score": 3
      }
    },
    {
      "id": "259446",
      "alleeId": 3957,
      "name": "Odtwarzacze DVD",
      "leaf": true,
      "parent": {
        "id": "717",
        "alleeId": 1169,
        "name": "TV i Video",
        "leaf": false,
        "parent": {
          "id": "10",
          "alleeId": 86,
          "name": "RTV i AGD",
          "leaf": false,
          "parent": {
            "id": "42540aec-367a-4e5e-b411-17c09b08e41f",
            "alleeId": 3,
            "name": "Elektronika",
            "leaf": false,
            "parent": null
          }
        }
      },
      "allee": {
        "score": 3
      }
    },
    {
      "id": "259432",
      "alleeId": 3958,
      "name": "Odtwarzacze DVD przenośne",
      "leaf": true,
      "parent": {
        "id": "717",
        "alleeId": 1169,
        "name": "TV i Video",
        "leaf": false,
        "parent": {
          "id": "10",
          "alleeId": 86,
          "name": "RTV i AGD",
          "leaf": false,
          "parent": {
            "id": "42540aec-367a-4e5e-b411-17c09b08e41f",
            "alleeId": 3,
            "name": "Elektronika",
            "leaf": false,
            "parent": null
          }
        }
      },
      "allee": {
        "score": 3
      }
    },
    {
      "id": "101353",
      "alleeId": 9453,
      "name": "Nadruki na CD/DVD",
      "leaf": true,
      "parent": {
        "id": "64602",
        "alleeId": 1463,
        "name": "Akcydensy (poligrafia)",
        "leaf": false,
        "parent": {
          "id": "64485",
          "alleeId": 983,
          "name": "Reklama",
          "leaf": false,
          "parent": {
            "id": "64477",
            "alleeId": 21,
            "name": "Biuro i Reklama",
            "leaf": false,
            "parent": {
              "id": "4bd97d96-f0ff-46cb-a52c-2992bd972bb1",
              "alleeId": 4,
              "name": "Firma i usługi",
              "leaf": false,
              "parent": null
            }
          }
        }
      },
      "allee": {
        "score": 3
      }
    },
    {
      "id": "257289",
      "alleeId": 7815,
      "name": "DVD",
      "leaf": true,
      "parent": {
        "id": "257286",
        "alleeId": 3823,
        "name": "Nośniki",
        "leaf": false,
        "parent": {
          "
… (skrócono — pełna odpowiedź ma 6 KB)

Zmiany w drzewie kategorii

GET /sale/category-events

zgodna z Allegrolimit: read

Utworzenie, zmiana nazwy, przeniesienie i usunięcie kategorii. Odpytuj z kursorem from = id ostatniego zdarzenia.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /sale/category-events.
Uprawnienie: dowolny ważny token lub klucz (działa też token aplikacji client_credentials).
Grupa limitu: read.

Parametry zapytania

from string

Zdarzenia po tym identyfikatorze.

limit integer

1–1000.

type array<string>

Filtr typów (można powtórzyć albo rozdzielić przecinkiem).

Odpowiedzi

200 Zdarzenia. · CategoryEventList
categoryEvents array<object> zawsze
Pola obiektu
id string zawsze

Kursor zdarzenia (do parametru from).

type string zawsze
Wartości: CATEGORY_CREATED, CATEGORY_RENAMED, CATEGORY_MOVED, CATEGORY_DELETED
occurredAt string · date-time zawsze
category object zawsze
Pola obiektu
id string · null zawsze
alleeId integer zawsze
name string
parent object · null
Pola obiektu
id string · null zawsze
alleeId integer zawsze
redirectCategory object · null

Kategoria zastępcza (przy usunięciu).

Pola obiektu
id string · null zawsze
alleeId integer zawsze

Błędy

HTTPKodZnaczenie
400VALIDATION_ERRORZła wartość parametru zapytania (400) albo pola treści (422); path wskazuje miejsce.
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/sale/category-events?limit=10" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "categoryEvents": []
}