{ "openapi": "3.1.0", "info": { "title": "allee.pl REST API", "version": "2026-11-09", "summary": "Sprzedaż na allee.pl przez API: zgodne z Allegro REST, rozszerzone o warstwę wzorowaną na Amazon SP-API.", "description": "REST API allee.pl dla sprzedawców i integratorów. **Każdy sprzedawca** utworzy sam klucz API w panelu sprzedaży (Klucze API) i zacznie wystawiać przez API — bez umowy i bez rejestracji aplikacji. Integratorzy obsługujący wielu sprzedawców używają OAuth 2.0 jak w Allegro.\n\n- **Zgodność z Allegro REST API:** trasy `/sale/*`, `/order/*`, `/billing/*`, `/messaging/*`, nagłówki `Accept`/`Content-Type` (`application/vnd.allegro.public.v1+json`), format błędów i OAuth są takie same — klient Allegro po zmianie adresów (`https://api.allee.pl`) działa.\n- **Po amazonowemu (`/allee/*`):** oferty po SKU z podglądem walidacji i listą problemów, schemat atrybutów kategorii (JSON Schema), wsady do 10 000 komunikatów, raporty asynchroniczne, powiadomienia push podpisane HMAC, plany użycia z nagłówkami limitów, klucze testowe (sandbox).\n- **Bezpieczeństwo:** klucze z listą IP i zakresami, monitoring każdego klucza w panelu, kwarantanna przy nietypowym użyciu, rotacja refresh tokenów (RFC 9700), dane osobowe kupujących tylko z zakresem `allee:api:orders:pii`.\n\nDaty: ISO 8601 w UTC. Kwoty: `{\"amount\": \"123.45\", \"currency\": \"PLN\"}`. Każda odpowiedź ma `X-Request-Id` — podawaj go przy zgłoszeniach. Klient ma ignorować nieznane pola odpowiedzi (nowe pola dochodzą bez zmiany wersji).", "contact": { "name": "allee.pl — wsparcie API", "url": "https://allee.pl/dla-deweloperow" }, "termsOfService": "https://allee.pl/regulamin", "x-logo": { "url": "https://allee.pl/assets/allee-logo.svg", "altText": "allee.pl" } }, "jsonSchemaDialect": "https://spec.openapis.org/oas/3.1/dialect/base", "servers": [ { "url": "https://api.allee.pl", "description": "Produkcja i sandbox — tryb rozstrzyga rodzaj klucza (allee_sk_live_… / allee_sk_test_…)." } ], "security": [ { "bearerAuth": [] } ], "tags": [ { "name": "Stan usługi", "description": "Czy API działa (bez tokenu)." }, { "name": "OAuth", "description": "Autoryzacja aplikacji: Authorization Code + PKCE (S256), odświeżanie z rotacją, token aplikacji (client_credentials), odwołanie (RFC 7009). Zgodne z Allegro." }, { "name": "Konto", "description": "Konto sprzedawcy, introspekcja tokenu lub klucza, plan użycia i limity." }, { "name": "Zgodność sprzedawcy", "description": "Profil prawny (4 rodzaje sprzedawcy), statusy weryfikacji, lista braków z kodami, oświadczenia z wersjami i historia zmian (DSA, GPSR). Od 10.11.2026." }, { "name": "Sandbox", "description": "Symulator kupującego dla kluczy testowych (allee_sk_test_…): zamówienia, zwroty, wiadomości — bez prawdziwych klientów." }, { "name": "Kategorie", "description": "Drzewo kategorii i parametry po identyfikatorach Allegro, podpowiedź kategorii, zmiany drzewa." }, { "name": "Kategorie allee", "description": "To samo drzewo po identyfikatorach allee + schemat atrybutów kategorii (JSON Schema)." }, { "name": "Produkty", "description": "Katalog produktów — allee go nie prowadzi (zawsze pusta lista / 404)." }, { "name": "Dostawa", "description": "Słownik metod dostawy allee i cenniki dostawy sprzedawcy." }, { "name": "Warunki", "description": "Warunki zwrotów, reklamacji (rękojmia) i gwarancji." }, { "name": "GPSR", "description": "Producenci i osoby odpowiedzialne (rozporządzenie GPSR)." }, { "name": "Oferty", "description": "Wystawianie i zmiana ofert w kształcie Allegro, lista, kupowalność, zdarzenia ofert." }, { "name": "Warianty ofert", "description": "Zestawy 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)." }, { "name": "Zdjęcia", "description": "Zdjęcia z adresu (Allegro) albo wgrane wprost do magazynu (podpisany adres PUT)." }, { "name": "Opłaty", "description": "Podgląd opłat za wystawienie i prowizji." }, { "name": "Polecenia wsadowe", "description": "Zmiana ceny, liczby sztuk, ustawień i publikacji wielu ofert naraz." }, { "name": "Rynki", "description": "Rynek allee-pl." }, { "name": "Listingi (SKU)", "description": "Oferty adresowane SKU, z podglądem walidacji i listą problemów (Amazon Listings Items)." }, { "name": "Wsady (feeds)", "description": "Wsady JSON do 10 000 komunikatów przetwarzane w tle (Amazon Feeds)." }, { "name": "Raporty", "description": "Raporty asynchroniczne CSV/JSON (Amazon Reports)." }, { "name": "Powiadomienia push", "description": "Webhooki podpisane HMAC-SHA256: destynacje, subskrypcje, dziennik dostaw (Amazon Notifications + podpis jak Stripe)." }, { "name": "Zamówienia", "description": "Zamówienia allee.pl, status realizacji, dziennik zdarzeń." }, { "name": "Przesyłki", "description": "Numery przesyłek, przewoźnicy, śledzenie." }, { "name": "Faktury", "description": "Faktury do zamówień: plik PDF albo link." }, { "name": "Wiadomości", "description": "Centrum wiadomości z kupującymi." }, { "name": "Zwroty", "description": "Zwroty kupujących (zasób BETA Allegro)." }, { "name": "Dyskusje i reklamacje", "description": "Reklamacje i dyskusje (zasób BETA Allegro)." }, { "name": "Rozliczenia", "description": "Operacje rozliczeniowe konta." }, { "name": "Bezpieczeństwo", "description": "Odbiornik zgłoszeń wycieków kluczy (GitHub secret scanning)." } ], "x-tagGroups": [ { "name": "Start", "tags": [ "Stan usługi", "OAuth", "Konto", "Zgodność sprzedawcy", "Sandbox" ] }, { "name": "Oferty (zgodne z Allegro)", "tags": [ "Kategorie", "Kategorie allee", "Produkty", "Dostawa", "Warunki", "GPSR", "Oferty", "Warianty ofert", "Zdjęcia", "Opłaty", "Polecenia wsadowe", "Rynki" ] }, { "name": "Po amazonowemu", "tags": [ "Listingi (SKU)", "Wsady (feeds)", "Raporty", "Powiadomienia push" ] }, { "name": "Zamówienia i obsługa posprzedażowa", "tags": [ "Zamówienia", "Przesyłki", "Faktury", "Wiadomości", "Zwroty", "Dyskusje i reklamacje", "Rozliczenia" ] }, { "name": "Bezpieczeństwo", "tags": [ "Bezpieczeństwo" ] } ], "paths": { "/": { "get": { "operationId": "getServiceStatus", "summary": "Stan usługi", "tags": [ "Stan usługi" ], "description": "Bez tokenu. Do monitoringu: 200 i bieżący czas (UTC).\n\n**Zgodność:** tylko allee.\n**Uwierzytelnienie:** brak.", "responses": { "200": { "description": "API działa.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ServiceStatus" }, "example": { "status": "ok", "api": "allee", "czas": "2026-11-10T11:10:02Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ServiceStatus" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "read", "errors": [ { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET / (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET / (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/`, {\n method: \"GET\",\n headers: {\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET / (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/\");\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET / (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET / (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/after-sales-service-conditions/implied-warranties": { "get": { "operationId": "getImpliedWarrantyList", "summary": "Warunki reklamacji (rękojmia) — lista", "tags": [ "Warunki" ], "description": "Twoje wpisy warunków reklamacji (id i nazwa). Klucz listy: `impliedWarranties`.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/implied-warranties.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Lista.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarrantyList" }, "example": { "impliedWarranties": [ { "id": "eab748ba-c9ec-444f-8f18-eb3b4174ebca", "name": "Reklamacje demo" }, { "id": "d82f8496-f284-4cdf-9575-242222870c5f", "name": "Rękojmia 2 lata" } ], "count": 2 } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarrantyList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /after-sales-service-conditions/implied-warranties", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /after-sales-service-conditions/implied-warranties (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/after-sales-service-conditions/implied-warranties\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/implied-warranties`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/after-sales-service-conditions/implied-warranties\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/implied-warranties\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/after-sales-service-conditions/implied-warranties\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createImpliedWarranty", "summary": "Warunki reklamacji (rękojmia) — nowe", "tags": [ "Warunki" ], "description": "`name` (1–100 znaków) i pola w kształcie Allegro z **białej listy** (np. okres `P14D`, kto pokrywa koszt zwrotu, adres) — wartości sprawdzamy, a pola spoza listy pomijamy.\n\n**201** — nowy wpis. **200** — ta sama `name` **i** identyczna treść (bezpieczne ponowienie). Ta sama `name`, inna treść → 422 `NAME_HAS_TO_BE_UNIQUE` (`details` = id istniejącego). Najwyżej 50 wpisów każdego rodzaju.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /after-sales-service-conditions/implied-warranties.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarrantyInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarrantyInput" } } } }, "responses": { "200": { "description": "Identyczny wpis już był.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" } } } }, "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" }, "example": { "id": "d82f8496-f284-4cdf-9575-242222870c5f", "name": "Rękojmia 2 lata", "individual": { "period": "P2Y" }, "corporate": { "period": "P1Y" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `LIMIT_EXCEEDED`, `NAME_HAS_TO_BE_UNIQUE`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /after-sales-service-conditions/implied-warranties", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LIMIT_EXCEEDED" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P1Y\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Rękojmia 2 lata',\n 'individual' => [\n 'period' => 'P2Y',\n ],\n 'corporate' => [\n 'period' => 'P1Y',\n ],\n];\n$ch = curl_init($base . '/after-sales-service-conditions/implied-warranties');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /after-sales-service-conditions/implied-warranties (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\",\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/after-sales-service-conditions/implied-warranties\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /after-sales-service-conditions/implied-warranties (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P1Y\"\n }\n};\nconst res = await fetch(`${BASE}/after-sales-service-conditions/implied-warranties`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /after-sales-service-conditions/implied-warranties (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/after-sales-service-conditions/implied-warranties\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P1Y\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /after-sales-service-conditions/implied-warranties (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P1Y\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/implied-warranties\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /after-sales-service-conditions/implied-warranties (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P1Y\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/after-sales-service-conditions/implied-warranties\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/after-sales-service-conditions/implied-warranties/{impliedWarrantyId}": { "get": { "operationId": "getImpliedWarranty", "summary": "Warunki reklamacji (rękojmia)", "tags": [ "Warunki" ], "description": "Pełny wpis warunków reklamacji. Cudzy → 403, brak (albo inny rodzaj) → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/implied-warranties/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "impliedWarrantyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wpis.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" }, "example": { "id": "d82f8496-f284-4cdf-9575-242222870c5f", "name": "Rękojmia 2 lata", "individual": { "period": "P2Y" }, "corporate": { "period": "P1Y" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /after-sales-service-conditions/implied-warranties/{id}", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateImpliedWarranty", "summary": "Warunki reklamacji (rękojmia) — zmiana", "tags": [ "Warunki" ], "description": "Pełna podmiana treści (biała lista pól Allegro dla rodzaju; nieznane pole → 422 `UnknownJSONProperty`). Oferty wskazujące ten wpis widzą nową treść.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /after-sales-service-conditions/implied-warranties/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "impliedWarrantyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarrantyInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarrantyInput" } } } }, "responses": { "200": { "description": "Zmieniono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" }, "example": { "id": "d82f8496-f284-4cdf-9575-242222870c5f", "name": "Rękojmia 2 lata", "individual": { "period": "P2Y" }, "corporate": { "period": "P2Y" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImpliedWarranty" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `NAME_HAS_TO_BE_UNIQUE`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /after-sales-service-conditions/implied-warranties/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P2Y\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Rękojmia 2 lata',\n 'individual' => [\n 'period' => 'P2Y',\n ],\n 'corporate' => [\n 'period' => 'P2Y',\n ],\n];\n$ch = curl_init($base . '/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\",\n },\n \"corporate\": {\n \"period\": \"P2Y\",\n },\n}\nr = requests.request(\"PUT\", BASE + \"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P2Y\"\n }\n};\nconst res = await fetch(`${BASE}/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P2Y\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P2Y\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Rękojmia 2 lata\",\n \"individual\": {\n \"period\": \"P2Y\"\n },\n \"corporate\": {\n \"period\": \"P2Y\"\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/after-sales-service-conditions/implied-warranties/d82f8496-f284-4cdf-9575-242222870c5f\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteImpliedWarranty", "summary": "Warunki reklamacji (rękojmia) — usunięcie", "tags": [ "Warunki" ], "description": "Usuwa wpis. Wpis wskazany w którejś ofercie → **409 `IN_USE`** (najpierw odepnij go od ofert).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /after-sales-service-conditions/implied-warranties/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "impliedWarrantyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `IN_USE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /after-sales-service-conditions/implied-warranties/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "IN_USE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/after-sales-service-conditions/implied-warranties/c3d63ea5-5893-4e48-a3e3-63cb41d238f3\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/after-sales-service-conditions/return-policies": { "get": { "operationId": "getReturnPolicyList", "summary": "Warunki zwrotów — lista", "tags": [ "Warunki" ], "description": "Twoje wpisy warunków zwrotów (id i nazwa). Klucz listy: `returnPolicies`.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/return-policies.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Lista.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicyList" }, "example": { "returnPolicies": [ { "id": "0d2fcf15-119d-479c-9d97-ba1794013def", "name": "Zwroty 30 dni" }, { "id": "42133d83-0ba2-472e-9f21-25f2c35b69e4", "name": "Zwroty demo" } ], "count": 2 } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicyList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /after-sales-service-conditions/return-policies", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /after-sales-service-conditions/return-policies (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/after-sales-service-conditions/return-policies\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /after-sales-service-conditions/return-policies (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/return-policies`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /after-sales-service-conditions/return-policies (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/after-sales-service-conditions/return-policies\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /after-sales-service-conditions/return-policies (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/return-policies\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /after-sales-service-conditions/return-policies (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/after-sales-service-conditions/return-policies\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createReturnPolicy", "summary": "Warunki zwrotów — nowe", "tags": [ "Warunki" ], "description": "`name` (1–100 znaków) i pola w kształcie Allegro z **białej listy** (np. okres `P14D`, kto pokrywa koszt zwrotu, adres) — wartości sprawdzamy, a pola spoza listy pomijamy.\n\n**201** — nowy wpis. **200** — ta sama `name` **i** identyczna treść (bezpieczne ponowienie). Ta sama `name`, inna treść → 422 `NAME_HAS_TO_BE_UNIQUE` (`details` = id istniejącego). Najwyżej 50 wpisów każdego rodzaju.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /after-sales-service-conditions/return-policies.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicyInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicyInput" } } } }, "responses": { "200": { "description": "Identyczny wpis już był.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" } } } }, "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" }, "example": { "id": "0d2fcf15-119d-479c-9d97-ba1794013def", "name": "Zwroty 30 dni", "availability": { "range": "FULL" }, "withdrawalPeriod": "P30D", "returnCost": { "coveredBy": "SELLER" }, "address": { "name": "Sklep Przykładowy", "street": "Magazynowa 1", "postCode": "00-001", "city": "Warszawa", "countryCode": "PL" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `LIMIT_EXCEEDED`, `NAME_HAS_TO_BE_UNIQUE`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /after-sales-service-conditions/return-policies", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LIMIT_EXCEEDED" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 1\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Zwroty 30 dni',\n 'availability' => [\n 'range' => 'FULL',\n ],\n 'withdrawalPeriod' => 'P30D',\n 'returnCost' => [\n 'coveredBy' => 'SELLER',\n ],\n 'address' => [\n 'name' => 'Sklep Przykładowy',\n 'street' => 'Magazynowa 1',\n 'postCode' => '00-001',\n 'city' => 'Warszawa',\n 'countryCode' => 'PL',\n ],\n];\n$ch = curl_init($base . '/after-sales-service-conditions/return-policies');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /after-sales-service-conditions/return-policies (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\",\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\",\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 1\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/after-sales-service-conditions/return-policies\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /after-sales-service-conditions/return-policies (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 1\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n};\nconst res = await fetch(`${BASE}/after-sales-service-conditions/return-policies`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /after-sales-service-conditions/return-policies (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/after-sales-service-conditions/return-policies\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 1\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /after-sales-service-conditions/return-policies (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 1\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/return-policies\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /after-sales-service-conditions/return-policies (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 1\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/after-sales-service-conditions/return-policies\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/after-sales-service-conditions/return-policies/{returnPolicyId}": { "get": { "operationId": "getReturnPolicy", "summary": "Warunki zwrotów", "tags": [ "Warunki" ], "description": "Pełny wpis warunków zwrotów. Cudzy → 403, brak (albo inny rodzaj) → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/return-policies/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "returnPolicyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wpis.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" }, "example": { "id": "0d2fcf15-119d-479c-9d97-ba1794013def", "name": "Zwroty 30 dni", "availability": { "range": "FULL" }, "withdrawalPeriod": "P30D", "returnCost": { "coveredBy": "SELLER" }, "address": { "name": "Sklep Przykładowy", "street": "Magazynowa 1", "postCode": "00-001", "city": "Warszawa", "countryCode": "PL" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /after-sales-service-conditions/return-policies/{id}", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateReturnPolicy", "summary": "Warunki zwrotów — zmiana", "tags": [ "Warunki" ], "description": "Pełna podmiana treści (biała lista pól Allegro dla rodzaju; nieznane pole → 422 `UnknownJSONProperty`). Oferty wskazujące ten wpis widzą nową treść.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /after-sales-service-conditions/return-policies/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "returnPolicyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicyInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicyInput" } } } }, "responses": { "200": { "description": "Zmieniono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" }, "example": { "id": "0d2fcf15-119d-479c-9d97-ba1794013def", "name": "Zwroty 30 dni", "availability": { "range": "FULL" }, "withdrawalPeriod": "P30D", "returnCost": { "coveredBy": "SELLER" }, "address": { "name": "Sklep Przykładowy", "street": "Magazynowa 2", "postCode": "00-001", "city": "Warszawa", "countryCode": "PL" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReturnPolicy" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `NAME_HAS_TO_BE_UNIQUE`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /after-sales-service-conditions/return-policies/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 2\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Zwroty 30 dni',\n 'availability' => [\n 'range' => 'FULL',\n ],\n 'withdrawalPeriod' => 'P30D',\n 'returnCost' => [\n 'coveredBy' => 'SELLER',\n ],\n 'address' => [\n 'name' => 'Sklep Przykładowy',\n 'street' => 'Magazynowa 2',\n 'postCode' => '00-001',\n 'city' => 'Warszawa',\n 'countryCode' => 'PL',\n ],\n];\n$ch = curl_init($base . '/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\",\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\",\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 2\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n },\n}\nr = requests.request(\"PUT\", BASE + \"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 2\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n};\nconst res = await fetch(`${BASE}/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 2\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 2\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Zwroty 30 dni\",\n \"availability\": {\n \"range\": \"FULL\"\n },\n \"withdrawalPeriod\": \"P30D\",\n \"returnCost\": {\n \"coveredBy\": \"SELLER\"\n },\n \"address\": {\n \"name\": \"Sklep Przykładowy\",\n \"street\": \"Magazynowa 2\",\n \"postCode\": \"00-001\",\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\"\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/after-sales-service-conditions/return-policies/0d2fcf15-119d-479c-9d97-ba1794013def\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteReturnPolicy", "summary": "Warunki zwrotów — usunięcie", "tags": [ "Warunki" ], "description": "Usuwa wpis. Wpis wskazany w którejś ofercie → **409 `IN_USE`** (najpierw odepnij go od ofert).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /after-sales-service-conditions/return-policies/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "returnPolicyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `IN_USE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /after-sales-service-conditions/return-policies/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "IN_USE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/after-sales-service-conditions/return-policies/134c9af0-5758-4921-92d0-6e9e2a8f595f\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/after-sales-service-conditions/warranties": { "get": { "operationId": "getWarrantyList", "summary": "Gwarancja — lista", "tags": [ "Warunki" ], "description": "Twoje wpisy gwarancji (id i nazwa). Klucz listy: `warranties`.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/warranties.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Lista.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/WarrantyList" }, "example": { "warranties": [ { "id": "e0b5c0de-c9d1-4be5-a5be-595e95db67ad", "name": "Gwarancja demo" }, { "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2", "name": "Gwarancja producenta" } ], "count": 2 } }, "application/json": { "schema": { "$ref": "#/components/schemas/WarrantyList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /after-sales-service-conditions/warranties", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /after-sales-service-conditions/warranties (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/after-sales-service-conditions/warranties\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /after-sales-service-conditions/warranties (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/warranties`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /after-sales-service-conditions/warranties (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/after-sales-service-conditions/warranties\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /after-sales-service-conditions/warranties (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/warranties\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /after-sales-service-conditions/warranties (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/after-sales-service-conditions/warranties\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createWarranty", "summary": "Gwarancja — nowe", "tags": [ "Warunki" ], "description": "`name` (1–100 znaków) i pola w kształcie Allegro z **białej listy** (np. okres `P14D`, kto pokrywa koszt zwrotu, adres) — wartości sprawdzamy, a pola spoza listy pomijamy.\n\n**201** — nowy wpis. **200** — ta sama `name` **i** identyczna treść (bezpieczne ponowienie). Ta sama `name`, inna treść → 422 `NAME_HAS_TO_BE_UNIQUE` (`details` = id istniejącego). Najwyżej 50 wpisów każdego rodzaju.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /after-sales-service-conditions/warranties.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/WarrantyInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WarrantyInput" } } } }, "responses": { "200": { "description": "Identyczny wpis już był.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Warranty" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Warranty" } } } }, "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Warranty" }, "example": { "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2", "name": "Gwarancja producenta", "individual": { "period": "P2Y", "type": "MANUFACTURER" }, "corporate": { "period": "P1Y", "type": "MANUFACTURER" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Warranty" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `LIMIT_EXCEEDED`, `NAME_HAS_TO_BE_UNIQUE`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /after-sales-service-conditions/warranties", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LIMIT_EXCEEDED" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P2Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Gwarancja producenta',\n 'individual' => [\n 'period' => 'P2Y',\n 'type' => 'MANUFACTURER',\n ],\n 'corporate' => [\n 'period' => 'P1Y',\n 'type' => 'MANUFACTURER',\n ],\n];\n$ch = curl_init($base . '/after-sales-service-conditions/warranties');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /after-sales-service-conditions/warranties (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P2Y\",\n \"type\": \"MANUFACTURER\",\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/after-sales-service-conditions/warranties\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /after-sales-service-conditions/warranties (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P2Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n};\nconst res = await fetch(`${BASE}/after-sales-service-conditions/warranties`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /after-sales-service-conditions/warranties (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/after-sales-service-conditions/warranties\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P2Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /after-sales-service-conditions/warranties (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P2Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/warranties\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /after-sales-service-conditions/warranties (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P2Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/after-sales-service-conditions/warranties\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/after-sales-service-conditions/warranties/{warrantyId}": { "get": { "operationId": "getWarranty", "summary": "Gwarancja", "tags": [ "Warunki" ], "description": "Pełny wpis gwarancji. Cudzy → 403, brak (albo inny rodzaj) → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /after-sales-service-conditions/warranties/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "warrantyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wpis.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Warranty" }, "example": { "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2", "name": "Gwarancja producenta", "individual": { "period": "P2Y", "type": "MANUFACTURER" }, "corporate": { "period": "P1Y", "type": "MANUFACTURER" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Warranty" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /after-sales-service-conditions/warranties/{id}", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateWarranty", "summary": "Gwarancja — zmiana", "tags": [ "Warunki" ], "description": "Pełna podmiana treści (biała lista pól Allegro dla rodzaju; nieznane pole → 422 `UnknownJSONProperty`). Oferty wskazujące ten wpis widzą nową treść.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /after-sales-service-conditions/warranties/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "warrantyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/WarrantyInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/WarrantyInput" } } } }, "responses": { "200": { "description": "Zmieniono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Warranty" }, "example": { "id": "5be961ca-7c55-4d2a-9332-93d58877d4a2", "name": "Gwarancja producenta", "individual": { "period": "P3Y", "type": "MANUFACTURER" }, "corporate": { "period": "P1Y", "type": "MANUFACTURER" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Warranty" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `NAME_HAS_TO_BE_UNIQUE`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /after-sales-service-conditions/warranties/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P3Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Gwarancja producenta',\n 'individual' => [\n 'period' => 'P3Y',\n 'type' => 'MANUFACTURER',\n ],\n 'corporate' => [\n 'period' => 'P1Y',\n 'type' => 'MANUFACTURER',\n ],\n];\n$ch = curl_init($base . '/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P3Y\",\n \"type\": \"MANUFACTURER\",\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\",\n },\n}\nr = requests.request(\"PUT\", BASE + \"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P3Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n};\nconst res = await fetch(`${BASE}/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P3Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P3Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Gwarancja producenta\",\n \"individual\": {\n \"period\": \"P3Y\",\n \"type\": \"MANUFACTURER\"\n },\n \"corporate\": {\n \"period\": \"P1Y\",\n \"type\": \"MANUFACTURER\"\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/after-sales-service-conditions/warranties/5be961ca-7c55-4d2a-9332-93d58877d4a2\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteWarranty", "summary": "Gwarancja — usunięcie", "tags": [ "Warunki" ], "description": "Usuwa wpis. Wpis wskazany w którejś ofercie → **409 `IN_USE`** (najpierw odepnij go od ofert).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /after-sales-service-conditions/warranties/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "warrantyId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `IN_USE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /after-sales-service-conditions/warranties/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "IN_USE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/after-sales-service-conditions/warranties/2ebf18a5-0d1e-4ece-a9e0-66861011ca83\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/billing-documents/{invoiceId}/file": { "get": { "operationId": "downloadBillingDocument", "summary": "Pobranie pliku faktury (podpisany link)", "tags": [ "Faktury" ], "description": "Adres z `allee.downloadUrl` (ważny 5 minut) — **bez tokenu**; podpis jest przepustką. Po terminie → 403 `LINK_EXPIRED_OR_INVALID` (pobierz nowy adres z `GET …/invoices`).\n\nLink z sandboxu (klucz testowy) ma dodatkowo `mode=test` — znacznik jest objęty podpisem, więc pobierasz go tak samo, bez tokenu; nie zmieniaj ani nie usuwaj parametrów adresu (zmiana → 403).\n\n**Zgodność:** tylko allee — Rozszerzenie allee.\n**Uwierzytelnienie:** podpis w adresie (link ważny 5 minut) — bez tokenu.", "parameters": [ { "name": "invoiceId", "in": "path", "required": true, "description": "Identyfikator faktury.", "schema": { "type": "string" } }, { "name": "expires", "in": "query", "required": true, "description": "Z podpisanego adresu.", "schema": { "type": "string" } }, { "name": "mode", "in": "query", "required": false, "description": "Z podpisanego adresu — tylko linki z sandboxu (objęte podpisem).", "schema": { "type": "string", "enum": [ "test" ] } }, { "name": "signature", "in": "query", "required": true, "description": "Z podpisanego adresu.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Plik PDF (Content-Disposition: attachment).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "Brak uprawnień. Kody: `LINK_EXPIRED_OR_INVALID`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "allee", "equivalent": "Rozszerzenie allee", "limitGroup": "read", "errors": [ { "status": 403, "code": "LINK_EXPIRED_OR_INVALID" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…\" \\\n -H \"Accept: application/pdf\" \\\n -o pobrana-faktura.pdf -w 'HTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/pdf',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\n$kod = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);\nif ($kod === 200) file_put_contents('pobrana-faktura.pdf', $odp);\necho 'HTTP ', $kod, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/pdf\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…\", headers=headers, timeout=60, allow_redirects=False)\nif r.status_code == 200:\n with open(\"pobrana-faktura.pdf\", \"wb\") as f:\n f.write(r.content)\nprint(\"HTTP\", r.status_code)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Node.js 18+, wbudowany fetch; plik .mjs)\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…`, {\n method: \"GET\",\n headers: {\n \"Accept\": \"application/pdf\",\n },\n redirect: \"manual\",\n});\nif (res.status === 200) await writeFile(\"pobrana-faktura.pdf\", Buffer.from(await res.arrayBuffer()));\nconsole.log(\"HTTP\", res.status);\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…\");\nreq.Headers.Accept.ParseAdd(\"application/pdf\");\nusing var res = await http.SendAsync(req);\nif ((int)res.StatusCode == 200) File.WriteAllBytes(\"pobrana-faktura.pdf\", await res.Content.ReadAsByteArrayAsync());\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.file.Path;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…\"))\n .header(\"Accept\", \"application/pdf\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofFile(Path.of(\"pobrana-faktura.pdf\")));\n System.out.println(\"HTTP \" + res.statusCode());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"application/pdf\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tif res.StatusCode == 200 {\n\t\tf, err := os.Create(\"pobrana-faktura.pdf\")\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t\tdefer f.Close()\n\t\tif _, err := f.ReadFrom(res.Body); err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n}\n" } ] } }, "/allee/categories": { "get": { "operationId": "getAlleeCategories", "summary": "Lista kategorii (identyfikatory allee)", "tags": [ "Kategorie allee" ], "description": "To samo drzewo co `/sale/categories`, ale po identyfikatorach allee (`parent.id` = alleeId).\n\n**Zgodność:** tylko allee — GET /sale/categories (po alleeId).\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "parent.id", "in": "query", "required": false, "description": "alleeId kategorii nadrzędnej; brak = działy główne.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Kategorie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/AlleeCategoryList" }, "example": { "categories": [ { "alleeId": 17, "id": "66813", "name": "Audiobooki - CD", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 18, "id": "253753", "name": "Audiobooki - mp3", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 20, "id": "300881", "name": "Bilety", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 25, "id": "118", "name": "Czasopisma", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 32, "id": "5893", "name": "Ebooki", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 35, "id": "20585", "name": "Filmy", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": true }, { "alleeId": 38, "id": "306453", "name": "Gadżety", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 39, "id": "9", "name": "Gry", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 44, "id": "122640", "name": "Instrumenty", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 45, "id": "28496", "name": "Kalendarze, notesy, planery", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 47, "id": "257900", "name": "Kody i doładowania", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 50, "id": "79413", "name": "Komiksy", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 54, "id": "7", "name": "Książki", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 57, "id": "325021", "name": "Mapy, atlasy", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": true }, { "alleeId": 63, "id": "1", "name": "Muzyka", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": true }, { "alleeId": 75, "id": "66820", "name": "Podręczniki szkolne", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": false }, { "alleeId": 109, "id": "301130", "name": "Wyjątkowe chwile", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": true } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/AlleeCategoryList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro: GET /sale/categories (po alleeId)", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/categories?parent.id=6\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/categories (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/categories?parent.id=6\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/categories (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/categories?parent.id=6`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/categories (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/categories?parent.id=6\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/categories (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/categories?parent.id=6\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/categories (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/categories?parent.id=6\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/categories/{alleeCategoryId}": { "get": { "operationId": "getAlleeCategory", "summary": "Kategoria (identyfikator allee)", "tags": [ "Kategorie allee" ], "description": "Kategoria ze ścieżką od działu głównego (`path`).\n\n**Zgodność:** tylko allee — GET /sale/categories/{categoryId}.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "alleeCategoryId", "in": "path", "required": true, "description": "alleeId kategorii.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Kategoria.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/AlleeCategory" }, "example": { "alleeId": 35, "id": "20585", "name": "Filmy", "parent": { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45" }, "leaf": true, "path": [ { "alleeId": 6, "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45", "name": "Kultura i rozrywka" }, { "alleeId": 35, "id": "20585", "name": "Filmy" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/AlleeCategory" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro: GET /sale/categories/{categoryId}", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/categories/35\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/categories/35 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/categories/35\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/categories/35 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/categories/35`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/categories/35 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/categories/35\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/categories/35 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/categories/35\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/categories/35 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/categories/35\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/categories/{alleeCategoryId}/parameters": { "get": { "operationId": "getAlleeCategoryParameters", "summary": "Parametry kategorii (identyfikator allee)", "tags": [ "Kategorie allee" ], "description": "Identyczna lista jak `/sale/categories/{id}/parameters`.\n\n**Zgodność:** tylko allee — GET /sale/categories/{categoryId}/parameters.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "alleeCategoryId", "in": "path", "required": true, "description": "alleeId kategorii.", "schema": { "type": "integer" } } ], "responses": { "200": { "description": "Parametry.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CategoryParameterList" }, "example": { "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_1797517", "alleeId": 258696, "value": "westerny", "dependsOnValueIds": [] }, { "id": "250077_1797518", "alleeId": 258697, "value": "wojenne", "dependsOnValueIds": [] }, { "id": "250077_1797519", "alleeId": 258698, "value": "zestawy, pakiety", "dependsOnValueIds": [] }, { "id": "250077_1797509", "alleeId": 258699, "value": "inny", "dependsOnValueIds": [] } ] }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "type": "string", "required": true, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "minLength": 8, "maxLength": 14, "allowedNumberOfValues": 1 } }, { "id": "237218", "alleeId": 7939, "name": "Tytuł", "type": "string", "required": true, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "minLength": 1, "maxLength": 100, "allowedNumberOfValues": 1 } }, { "id": "10524", "alleeId": 586, "name": "Rodzaj wydania", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "10524_3", "alleeId": 5952, "value": "Wydanie - część kolekcji", "dependsOnValueIds": [] }, { "id": "10524_1", "alleeId": 5953, "value": "Wydanie pełne", "dependsOnValueIds": [] }, { "id": "10524_4", "alleeId": 5954, "value": "Wydanie specjalne, limitowane", "dependsOnValueIds": [] }, { "id": "10524_2", "alleeId": 5955, "value": "Wydanie z gazety", "dependsOnValueIds": [] } ] }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "229205_340245", "alleeId": 60427, "value": "oryginalne", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340249", "alleeId": 60428, "value": "otwarte", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340253", "alleeId": 60429, "value": "uszkodzone", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340257", "alleeId": 60430, "value": "zastępcze", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340261", "alleeId": 60431, "value": "brak opakowania", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] } ] }, { "id": "7037", "alleeId": 443, "name": "Region producenta filmu", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "7037_1", "alleeId": 4954, "value": "Afryka", "dependsOnValueIds": [] }, { "id": "7037_3", "alleeId": 4955, "value": "Ameryka Północna", "dependsOnValueIds": [] }, { "id": "7037_2", "alleeId": 4956, "value": "Ameryka Południowa", "dependsOnValueIds": [] }, { "id": "7037_4", "alleeId": 4957, "value": "Australia", "dependsOnValueIds": [] }, { "id": "7037_5", "alleeId": 4958, "value": "Azja", "dependsOnValueIds": [] }, { "id": "7037_6", "alleeId": 4959, "value": "Europa", "dependsOnValueIds": [] }, { "id": "7037_7", "alleeId": 4960, "value": "Produkcja mieszana", "dependsOnValueIds": [] } ] }, { "id": "249816", "alleeId": 10734, "name": "Język dubbingu", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": true }, "dictionary": [ { "id": "249816_1743449", "alleeId": 243265, "value": "angielski", "dependsOnValueIds": [] }, { "id": "249816_1743468", "alleeId": 243266, "value": "arabski", "dependsOnValueIds": [] }, { "id": "249816_1743469", "alleeId": 243267, "value": "chiński (mandaryński)", "dependsOnValueIds": [] }, { "id": "249816_1743450", "alleeId": 243268, "value": "czeski", "dependsOnValueIds": [] }, { "id": "249816_1743466", "alleeId": 243269, "value": "duński", "dependsOnValueIds": [] }, { "id": "249816_1743459", "alleeId": 243270, "value": "fiński", "dependsOnValueIds": [] }, { "id": "249816_1743455", "alleeId": 243271, "value": "francuski", "dependsOnValueIds": [] }, { "id": "249816_1743465", "alleeId": 243272, "value": "grecki", "dependsOnValueIds": [] }, { "id": "249816_1743472", "alleeId": 243273, "value": "hindi", "dependsOnValueIds": [] }, { "id": "249816_1743460", "alleeId": 243274, "value": "hiszpański", "dependsOnValueIds": [] }, { "id": "249816_1743470", "alleeId": 243275, "value": "japoński", "dependsOnValueIds": [] }, { "id": "249816_1743471", "alleeId": 243276, "value": "koreański", "dependsOnValueIds": [] }, { "id": "249816_1743467", "alleeId": 243277, "value": "niderlandzki", "dependsOnValueIds": [] }, { "id": "249816_1743456", "alleeId": 243278, "value": "niemiecki", "dependsOnValueIds": [] }, { "id": "249816_1743458", "alleeId": 243279, "value": "norweski", "dependsOnValueIds": [] }, { "id": "249816_1743448", "alleeId": 243280, "value": "polski", "dependsOnValueIds": [] }, { "id": "249816_1743452", "alleeId": 243281, "value": "portugalski", "dependsOnValueIds": [] }, { "id": "249816_1743462", "alleeId": 243282, "value": "rosyjski", "dependsOnValueIds": [] }, { "id": "249816_1743453", "alleeId": 243283, "value": "rumuński", "dependsOnValueIds": [] }, { "id": "249816_1743454", "alleeId": 243284, "value": "słowacki", "dependsOnValueIds": [] }, { "id": "249816_1743457", "alleeId": 243285, "value": "szwedzki", "dependsOnValueIds": [] }, { "id": "249816_1743464", "alleeId": 243286, "value": "turecki", "dependsOnValueIds": [] }, { "id": "249816_1743463", "alleeId": 243287, "value": "ukraiński", "dependsOnValueIds": [] }, { "id": "249816_1743451", "alleeId": 243288, "value": "węgierski", "dependsOnValueIds": [] }, { "id": "249816_1743461", "alleeId": 243289, "value": "włoski", "dependsOnValueIds": [] } ] }, { "id": "249815", "alleeId": 10733, "name": "Język lektora", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": true }, "dictionary": [ { "id": "249815_1743424", "alleeId": 243240, "value": "angielski", "dependsOnValueIds": [] }, { "id": "249815_1743443", "alleeId": 243241, "value": "arabski", "dependsOnValueIds": [] }, { "id": "249815_1743444", "alleeId": 243242, "value": "chiński (mandaryński)", "dependsOnValueIds": [] }, { "id": "249815_1743425", "alleeId": 243243, "value": "czeski", "dependsOnValueIds": [] }, { "id": "249815_1743441", "alleeId": 243244, "value": "duński", "dependsOnValueIds": [] }, { "id": "249815_1743434", "alleeId": 243245, "value": "fiński", "dependsOnValueIds": [] }, { "id": "249815_1743430", "alleeId": 243246, "value": "francuski", "dependsOnValueIds": [] }, { "id": "249815_1743440", "alleeId": 243247, "value": "grecki", "dependsOnValueIds": [] }, { "id": "249815_1743447", "alleeId": 243248, "value": "hindi", "dependsOnValueIds": [] }, { "id": "249815_1743435", "alleeId": 243249, "value": "hiszpański", "dependsOnValueIds": [] }, { "id": "249815_1743445", "alleeId": 243250, "value": "japoński", "dependsOnValueIds": [] }, { "id": "249815_1743446", "alleeId": 243251, "value": "koreański", "dependsOnValueIds": [] }, { "id": "249815_1743442", "alleeId": 243252, "value": "niderlandzki", "dependsOnValueIds": [] }, { "id": "249815_1743431", "alleeId": 243253, "value": "niemiecki", "dependsOnValueIds": [] }, { "id": "249815_1743433", "alleeId": 243254, "value": "norweski", "dependsOnValueIds": [] }, { "id": "249815_1743423", "alleeId": 243255, "value": "polski", "dependsOnValueIds": [] }, { "id": "249815_1743427", "alleeId": 243256, "value": "portugalski", "dependsOnValueIds": [] }, { "id": "249815_1743437", "alleeId": 243257, "value": "rosyjski", "dependsOnValueIds": [] }, { "id": "249815_1743428", "alleeId": 243258, "value": "rumuński", "dependsOnValueIds": [] }, { "id": "249815_1743429", "alleeId": 243259, "value": "słowacki", "dependsOnValueIds": [] }, { "id": "249815_1743432", "alleeId": 243260, "value": "szwedzki", "dependsOnValueIds": [] }, { "id": "249815_1743439", "alleeId": 243261, "value": "turecki", "dependsOnValueIds": [] }, { "id": "249815_1743438", "alleeId": 243262, "value": "ukraiński", "dependsOnValueIds": [] }, { "id": "249815_1743426", "alleeId": 243263, "value": "węgierski", "dependsOnValueIds": [] }, { "id": "249815_1743436", "alleeId": 243264, "value": "włoski", "dependsOnValueIds": [] } ] }, { "id": "249814", "alleeId": 10732, "name": "Język napisów", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": true }, "dictionary": [ { "id": "249814_1743397", "alleeId": 243215, "value": "angielski", "dependsOnValueIds": [] }, { "id": "249814_1743416", "alleeId": 243216, "value": "arabski", "dependsOnValueIds": [] }, { "id": "249814_1743417", "alleeId": 243217, "value": "chiński (mandaryński)", "dependsOnValueIds": [] }, { "id": "249814_1743398", "alleeId": 243218, "value": "czeski", "dependsOnValueIds": [] }, { "id": "249814_1743414", "alleeId": 243219, "value": "duński", "dependsOnValueIds": [] }, { "id": "249814_1743407", "alleeId": 243220, "value": "fiński", "dependsOnValueIds": [] }, { "id": "249814_1743403", "alleeId": 243221, "value": "francuski", "dependsOnValueIds": [] }, { "id": "249814_1743413", "alleeId": 243222, "value": "grecki", "dependsOnValueIds": [] }, { "id": "249814_1743420", "alleeId": 243223, "value": "hindi", "dependsOnValueIds": [] }, { "id": "249814_1743408", "alleeId": 243224, "value": "hiszpański", "dependsOnValueIds": [] }, { "id": "249814_1743418", "alleeId": 243225, "value": "japoński", "dependsOnValueIds": [] }, { "id": "249814_1743419", "alleeId": 243226, "value": "koreański", "dependsOnValueIds": [] }, { "id": "249814_1743415", "alleeId": 243227, "value": "niderlandzki", "dependsOnValueIds": [] }, { "id": "249814_1743404", "alleeId": 243228, "value": "niemiecki", "dependsOnValueIds": [] }, { "id": "249814_1743406", "alleeId": 243229, "value": "norweski", "dependsOnValueIds": [] }, { "id": "249814_1743396", "alleeId": 243230, "value": "polski", "dependsOnValueIds": [] }, { "id": "249814_1743400", "alleeId": 243231, "value": "portugalski", "dependsOnValueIds": [] }, { "id": "249814_1743410", "alleeId": 243232, "value": "rosyjski", "dependsOnValueIds": [] }, { "id": "249814_1743401", "alleeId": 243233, "value": "rumuński", "dependsOnValueIds": [] }, { "id": "249814_1743402", "alleeId": 243234, "value": "słowacki", "dependsOnValueIds": [] }, { "id": "249814_1743405", "alleeId": 243235, "value": "szwedzki", "dependsOnValueIds": [] }, { "id": "249814_1743412", "alleeId": 243236, "value": "turecki", "dependsOnValueIds": [] }, { "id": "249814_1743411", "alleeId": 243237, "value": "ukraiński", "dependsOnValueIds": [] }, { "id": "249814_1743399", "alleeId": 243238, "value": "węgierski", "dependsOnValueIds": [] }, { "id": "249814_1743409", "alleeId": 243239, "value": "włoski", "dependsOnValueIds": [] } ] }, { "id": "249777", "alleeId": 10701, "name": "Wytwórnia filmowa", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "249777_1930418", "alleeId": 239006, "value": "20th Century Fox", "dependsOnValueIds": [] }, { "id": "249777_1930415", "alleeId": 239007, "value": "20th Century Studios", "dependsOnValueIds": [] }, { "id": "249777_1737231", "alleeId": 239008, "value": "A.k.a. Cartoon", "dependsOnValueIds": [] }, { "id": "249777_1737232", "alleeId": 239009, "value": "Aardman Animations", "dependsOnValueIds": [] }, { "id": "249777_1737234", "alleeId": 239010, "value": "Atéliery Bonton Zlín", "dependsOnValueIds": [] }, { "id": "249777_1737235", "alleeId": 239011, "value": "Biełaruśfilm", "dependsOnValueIds": [] }, { "id": "249777_1737236", "alleeId": 239012, "value": "Bratři v triku", "dependsOnValueIds": [] }, { "id": "249777_1737237", "alleeId": 239013, "value": "Bridge (studio)", "dependsOnValueIds": [] }, { "id": "249777_1737238", "alleeId": 239014, "value": "Burbank Films Australia", "dependsOnValueIds": [] }, { "id": "249777_1930416", "alleeId": 239015, "value": "Cass film", "dependsOnValueIds": [] }, { "id": "249777_1737239", "alleeId": 239016, "value": "CinéGroupe", "dependsOnValueIds": [] }, { "id": "249777_1737240", "alleeId": 239017, "value": "CloverWorks", "dependsOnValueIds": [] }, { "id": "249777_1930412", "alleeId": 239018, "value": "Columbia Pictures", "dependsOnValueIds": [] }, { "id": "249777_2035720", "alleeId": 239019, "value": "Concorde Video", "dependsOnValueIds": [] }, { "id": "249777_1737241", "alleeId": 239020, "value": "Diomedéa", "dependsOnValueIds": [] }, { "id": "249777_1737242", "alleeId": 239021, "value": "Doga Kobo", "dependsOnValueIds": [] }, { "id": "249777_1737243", "alleeId": 239022, "value": "DreamWorks Animation", "dependsOnValueIds": [] }, { "id": "249777_1737244", "alleeId": 239023, "value": "Felix Film", "dependsOnValueIds": [] }, { "id": "249777_1737245", "alleeId": 239024, "value": "Frederator Studios", "dependsOnValueIds": [] }, { "id": "249777_1737246", "alleeId": 239025, "value": "Fresh TV", "dependsOnValueIds": [] }, { "id": "249777_1737247", "alleeId": 239026, "value": "Gaumont", "dependsOnValueIds": [] }, { "id": "249777_1737248", "alleeId": 239027, "value": "Geek Toys", "dependsOnValueIds": [] }, { "id": "249777_1737249", "alleeId": 239028, "value": "Geno Studio", "dependsOnValueIds": [] }, { "id": "249777_1737250", "alleeId": 239029, "value": "Golden Films", "dependsOnValueIds": [] }, { "id": "249777_1737252", "alleeId": 239030, "value": "Hanna-Barbera", "dependsOnValueIds": [] }, { "id": "249777_1737253", "alleeId": 239031, "value": "ImageMovers", "dependsOnValueIds": [] }, { "id": "249777_1737254", "alleeId": 239032, "value": "ImageMovers Digital", "dependsOnValueIds": [] }, { "id": "249777_1737256", "alleeId": 239033, "value": "Kinema Citrus", "dependsOnValueIds": [] }, { "id": "249777_1930413", "alleeId": 239034, "value": "Kino Świat", "dependsOnValueIds": [] }, { "id": "249777_1737257", "alleeId": 239035, "value": "Klasky Csupo, Inc.", "dependsOnValueIds": [] }, { "id": "249777_1737258", "alleeId": 239036, "value": "Lay-duce", "dependsOnValueIds": [] }, { "id": "249777_1930409", "alleeId": 239037, "value": "LEONINE Distribution", "dependsOnValueIds": [] }, { "id": "249777_1737260", "alleeId": 239038, "value": "Mainframe Entertainment", "dependsOnValueIds": [] }, { "id": "249777_1737261", "alleeId": 239039, "value": "MAPPA", "dependsOnValueIds": [] }, { "id": "249777_1737262", "alleeId": 239040, "value": "Marathon Media Group", "dependsOnValueIds": [] }, { "id": "249777_1737263", "alleeId": 239041, "value": "Marvel Animation", "dependsOnValueIds": [] }, { "id": "249777_2055003", "alleeId": 239042, "value": "Mayfly", "dependsOnValueIds": [] }, { "id": "249777_1737264", "alleeId": 239043, "value": "Metro-Goldwyn-Mayer", "dependsOnValueIds": [] }, { "id": "249777_1930421", "alleeId": 239044, "value": "MGM Studios", "dependsOnValueIds": [] }, { "id": "249777_1737266", "alleeId": 239045, "value": "Mongolkino", "dependsOnValueIds": [] }, { "id": "249777_1737267", "alleeId": 239046, "value": "NAZ", "dependsOnValueIds": [] }, { "id": "249777_1737268", "alleeId": 239047, "value": "Nelvana", "dependsOnValueIds": [] }, { "id": "249777_1737269", "alleeId": 239048, "value": "Neptuno Films", "dependsOnValueIds": [] }, { "id": "249777_1737270", "alleeId": 239049, "value": "Nerd Corps Entertainment", "dependsOnValueIds": [] }, { "id": "249777_2081635", "alleeId": 239050, "value": "New Abra", "dependsOnValueIds": [] }, { "id": "249777_1737271", "alleeId": 239051, "value": "NUT (studio)", "dependsOnValueIds": [] }, { "id": "249777_1737272", "alleeId": 239052, "value": "Orange (studio)", "dependsOnValueIds": [] }, { "id": "249777_1737273", "alleeId": 239053, "value": "Pacific Data Images", "dependsOnValueIds": [] }, { "id": "249777_1737274", "alleeId": 239054, "value": "Pannonia Film Studio", "dependsOnValueIds": [] }, { "id": "249777_1930422", "alleeId": 239055, "value": "Paramount", "dependsOnValueIds": [] }, { "id": "249777_1930420", "alleeId": 239056, "value": "Paramount Pictures", "dependsOnValueIds": [] }, { "id": "249777_1737275", "alleeId": 239057, "value": "Passione", "dependsOnValueIds": [] }, { "id": "249777_1737276", "alleeId": 239058, "value": "Pine Jam", "dependsOnValueIds": [] }, { "id": "249777_1737277", "alleeId": 239059, "value": "Pixar", "dependsOnValueIds": [] }, { "id": "249777_1930417", "alleeId": 239060, "value": "Plaion Pictures", "dependsOnValueIds": [] }, { "id": "249777_1737278", "alleeId": 239061, "value": "Platige Image", "dependsOnValueIds": [] }, { "id": "249777_1737279", "alleeId": 239062, "value": "Platinum Vision", "dependsOnValueIds": [] }, { "id": "249777_1928589", "alleeId": 239063, "value": "Prosveta", "dependsOnValueIds": [] }, { "id": "249777_1737280", "alleeId": 239064, "value": "Rainbow", "dependsOnValueIds": [] }, { "id": "249777_1737281", "alleeId": 239065, "value": "Renegade Animation", "dependsOnValueIds": [] }, { "id": "249777_1737282", "alleeId": 239066, "value": "Revoroot", "dependsOnValueIds": [] }, { "id": "249777_1737283", "alleeId": 239067, "value": "Se-ma-for", "dependsOnValueIds": [] }, { "id": "249777_1737285", "alleeId": 239068, "value": "Silver Link", "dependsOnValueIds": [] }, { "id": "249777_1737286", "alleeId": 239069, "value": "Sojuzmultfilm", "dependsOnValueIds": [] }, { "id": "249777_1737287", "alleeId": 239070, "value": "Sony Pictures Animation", "dependsOnValueIds": [] }, { "id": "249777_1737288", "alleeId": 239071, "value": "SPInka Film Studio", "dependsOnValueIds": [] }, { "id": "249777_1737289", "alleeId": 239072, "value": "Stoopid Buddy Studios", "dependsOnValueIds": [] }, { "id": "249777_1737290", "alleeId": 239073, "value": "Studio Bind", "dependsOnValueIds": [] }, { "id": "249777_1930414", "alleeId": 239074, "value": "Studiocanal", "dependsOnValueIds": [] }, { "id": "249777_1737291", "alleeId": 239075, "value": "Studio Ekran", "dependsOnValueIds": [] }, { "id": "249777_1737292", "alleeId": 239076, "value": "Studio Filmów Animowanych", "dependsOnValueIds": [] }, { "id": "249777_1737233", "alleeId": 239077, "value": "Studio Filmowe Anima-Pol", "dependsOnValueIds": [] }, { "id": "249777_1737293", "alleeId": 239078, "value": "Studio Miniatur Filmowych", "dependsOnValueIds": [] }, { "id": "249777_1737294", "alleeId": 239079, "value": "Teletoon", "dependsOnValueIds": [] }, { "id": "249777_2076447", "alleeId": 239080, "value": "TELEWIZJA POLSKA SA", "dependsOnValueIds": [] }, { "id": "249777_1737295", "alleeId": 239081, "value": "Trigger", "dependsOnValueIds": [] }, { "id": "249777_1737296", "alleeId": 239082, "value": "Troyca", "dependsOnValueIds": [] }, { "id": "249777_1737298", "alleeId": 239083, "value": "TV Studio Filmów Animowanych", "dependsOnValueIds": [] }, { "id": "249777_1930419", "alleeId": 239084, "value": "Universal Pictures", "dependsOnValueIds": [] }, { "id": "249777_1930410", "alleeId": 239085, "value": "Universal Pictures Video", "dependsOnValueIds": [] }, { "id": "249777_1926942", "alleeId": 239086, "value": "VICTOR 11", "dependsOnValueIds": [] }, { "id": "249777_1737299", "alleeId": 239087, "value": "Walt Disney Animation Studios", "dependsOnValueIds": [] }, { "id": "249777_1930411", "alleeId": 239088, "value": "Warner Bros.", "dependsOnValueIds": [] }, { "id": "249777_1737300", "alleeId": 239089, "value": "Warner Bros. Animation", "dependsOnValueIds": [] }, { "id": "249777_2010823", "alleeId": 239090, "value": "WFDiF", "dependsOnValueIds": [] }, { "id": "249777_1737301", "alleeId": 239091, "value": "WildBrain", "dependsOnValueIds": [] }, { "id": "249777_1737302", "alleeId": 239092, "value": "Wit Studio", "dependsOnValueIds": [] }, { "id": "249777_1737303", "alleeId": 239093, "value": "Wołgogradtielefilm", "dependsOnValueIds": [] }, { "id": "249777_1737304", "alleeId": 239094, "value": "World Events Productions", "dependsOnValueIds": [] }, { "id": "249777_1737305", "alleeId": 239095, "value": "Zagreb Film", "dependsOnValueIds": [] }, { "id": "249777_1737306", "alleeId": 239096, "value": "Zero-G", "dependsOnValueIds": [] }, { "id": "249777_1737307", "alleeId": 239097, "value": "Zodiac Entertainment", "dependsOnValueIds": [] } ] }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "type": "string", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "minLength": 8, "maxLength": 14, "allowedNumberOfValues": 20 } }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "type": "float", "required": false, "requiredForProduct": false, "unit": "kg", "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "min": 0, "max": 1000000, "range": false, "precision": 3 } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryParameterList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro: GET /sale/categories/{categoryId}/parameters", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/categories/35/parameters\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/categories/35/parameters (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/categories/35/parameters\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/categories/35/parameters (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/categories/35/parameters`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/categories/35/parameters (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/categories/35/parameters\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/categories/35/parameters (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/categories/35/parameters\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/categories/35/parameters (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/categories/35/parameters\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/categories/{alleeCategoryId}/schema": { "get": { "operationId": "getCategorySchema", "summary": "Schemat atrybutów kategorii (JSON Schema)", "tags": [ "Kategorie allee" ], "description": "JSON Schema 2020-12 treści `PUT /allee/listings/{sku}` dla kategorii: atrybuty, wymagalność, wartości słowników, zakresy, jednostki. Waliduj dokument u siebie, zanim wyślesz — te same reguły sprawdza API.\n\nOdpowiedź ma `ETag` (= `meta.version`): wyślij `If-None-Match`, a dostaniesz 304, gdy schemat się nie zmienił.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Product Type Definitions — getDefinitionsProductType.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "alleeCategoryId", "in": "path", "required": true, "description": "alleeId kategorii-liścia.", "schema": { "type": "integer" } }, { "name": "requirements", "in": "query", "required": false, "description": "LISTING = pełna oferta; LISTING_OFFER_ONLY = dane sprzedażowe istniejącego SKU.", "schema": { "type": "string", "enum": [ "LISTING", "LISTING_OFFER_ONLY" ], "default": "LISTING" } } ], "responses": { "200": { "description": "Schemat.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "ETag": { "$ref": "#/components/headers/ETag" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CategorySchema" }, "example": { "category": { "alleeId": 35, "id": "20585", "name": "Filmy" }, "requirements": "LISTING", "metaSchema": { "link": { "resource": "https://json-schema.org/draft/2020-12/schema", "verb": "GET" } }, "schema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "$id": "https://api.allee.pl/allee/categories/35/schema?requirements=LISTING", "title": "Oferta allee — Filmy", "description": "Treść PUT /allee/listings/{sku}. Ceny brutto w PLN. Parametry: klucz = id parametru Allegro (GET /allee/categories/35/parameters).", "type": "object", "required": [ "attributes" ], "additionalProperties": false, "properties": { "requirements": { "enum": [ "LISTING", "LISTING_OFFER_ONLY" ], "default": "LISTING" }, "status": { "enum": [ "ACTIVE", "INACTIVE" ], "default": "INACTIVE", "description": "ACTIVE = publikuj (wymaga GPSR); INACTIVE = szkic albo bez zmiany statusu." }, "productType": { "type": "string", "description": "Pomijane (zgodność z klientami Amazon)." }, "attributes": { "type": "object", "additionalProperties": false, "required": [ "name", "category", "images", "description", "price", "stock", "shippingRatesId", "parameters" ], "properties": { "name": { "type": "string", "minLength": 10, "maxLength": 75, "pattern": "^(?!.*\\S{31})", "title": "Tytuł oferty", "description": "10–75 znaków, żadne słowo dłuższe niż 30 znaków.", "examples": [ "Przykładowy produkt testowy allee" ] }, "category": { "type": "object", "title": "Kategoria", "additionalProperties": false, "properties": { "alleeId": { "const": 35 }, "id": { "const": "20585" } }, "minProperties": 1, "examples": [ { "alleeId": 35 } ] }, "parameters": { "type": "object", "title": "Parametry kategorii (klucz = id parametru Allegro)", "properties": { "11323": { "title": "Stan", "x-allee": { "alleeId": 669, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "11323_253798", "11323_253802", "11323_253806", "11323_1", "11323_2", "11323_238066", "11323_1223453", "11323_238070", "11323_246514", "11323_238058", "11323_238062", "11323_1223636", "11323_246538", "11323_246510", "11323_246462", "11323_246534", "11323_2036070", "11323_1223635", "11323_1223462", "11323_246466", "11323_852680", "11323_2036071", "11323_2036072" ], "enumNames": [ "Do renowacji", "Po renowacji", "Nie wymaga renowacji", "Nowy", "Używany", "Po zwrocie", "Na części", "Niepełny komplet", "Nowy z defektem", "Powystawowy", "Uszkodzony", "Przepakowany", "Odnowiony przez sprzedawcę", "Nowy bez metki", "Regenerowany", "Odnowiony przez producenta", "Produkt cyfrowy", "Po demontażu", "Niepełny zestaw", "Bieżnikowany", "Z demontażu (demo)", "Produkt inwestycyjny", "Produkt kolekcjonerski" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "Do renowacji", "Po renowacji", "Nie wymaga renowacji", "Nowy", "Używany", "Po zwrocie", "Na części", "Niepełny komplet", "Nowy z defektem", "Powystawowy", "Uszkodzony", "Przepakowany", "Odnowiony przez sprzedawcę", "Nowy bez metki", "Regenerowany", "Odnowiony przez producenta", "Produkt cyfrowy", "Po demontażu", "Niepełny zestaw", "Bieżnikowany", "Z demontażu (demo)", "Produkt inwestycyjny", "Produkt kolekcjonerski" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "11323_253798" ] } ], "x-allee-supported": true, "description": "Stan towaru — tylko wartości, które allee zapisuje (GET …/parameters: options.alleeSupported)." }, "246845": { "title": "Nośnik", "x-allee": { "alleeId": 8973, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "246845_622161", "246845_622165", "246845_622169", "246845_728783", "246845_622173", "246845_622177", "246845_738593" ], "enumNames": [ "płyta Blu-ray 3D", "płyta DVD", "płyta Blu-ray", "płyta Blu-ray 4K", "płyta VCD", "kaseta wideo", "płyta DVD+Książka" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "płyta Blu-ray 3D", "płyta DVD", "płyta Blu-ray", "płyta Blu-ray 4K", "płyta VCD", "kaseta wideo", "płyta DVD+Książka" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "246845_622161" ] } ] }, "250077": { "title": "Gatunek", "x-allee": { "alleeId": 10923, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "250077_1797493", "250077_1797494", "250077_1797495", "250077_1797496", "250077_1797497", "250077_1797498", "250077_1797499", "250077_1797500", "250077_1797501", "250077_1797503", "250077_1797504", "250077_1797505", "250077_1797506", "250077_1797507", "250077_1797508", "250077_1797510", "250077_1797511", "250077_1797512", "250077_1797513", "250077_1797514", "250077_1797515", "250077_1797516", "250077_1797517", "250077_1797518", "250077_1797519", "250077_1797509" ], "enumNames": [ "anime", "bollywood", "dla dzieci", "dokumentalne", "dramaty", "fantasy", "horrory", "kabarety", "komedie", "kostiumowe", "kryminały", "kursy, ćwiczenia", "musicale", "opery", "popularnonaukowe", "przygodowe", "romanse", "science fiction", "sensacyjne", "seriale", "spektakle teatralne", "thrillery", "westerny", "wojenne", "zestawy, pakiety", "inny" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "anime", "bollywood", "dla dzieci", "dokumentalne", "dramaty", "fantasy", "horrory", "kabarety", "komedie", "kostiumowe", "kryminały", "kursy, ćwiczenia", "musicale", "opery", "popularnonaukowe", "przygodowe", "romanse", "science fiction", "sensacyjne", "seriale", "spektakle teatralne", "thrillery", "westerny", "wojenne", "zestawy, pakiety", "inny" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "250077_1797493" ] } ] }, "225693": { "title": "EAN (GTIN)", "x-allee": { "alleeId": 5967, "type": "string", "unit": null }, "type": "object", "properties": { "values": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "string", "pattern": "^(\\d{8}|\\d{12,14})$" } } }, "required": [ "values" ], "additionalProperties": false, "description": "Kod z poprawną cyfrą kontrolną (GTIN-8/12/13/14).", "examples": [ { "values": [ "5901234123457" ] } ] }, "237218": { "title": "Tytuł", "x-allee": { "alleeId": 7939, "type": "string", "unit": null }, "type": "object", "properties": { "values": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "string", "minLength": 1, "maxLength": 100, "pattern": "\\S" } } }, "required": [ "values" ], "additionalProperties": false, "examples": [ { "values": [ "Przykład" ] } ] }, "10524": { "title": "Rodzaj wydania", "x-allee": { "alleeId": 586, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "10524_3", "10524_1", "10524_4", "10524_2" ], "enumNames": [ "Wydanie - część kolekcji", "Wydanie pełne", "Wydanie specjalne, limitowane", "Wydanie z gazety" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "Wydanie - część kolekcji", "Wydanie pełne", "Wydanie specjalne, limitowane", "Wydanie z gazety" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "10524_3" ] } ] }, "229205": { "title": "Stan opakowania", "x-allee": { "alleeId": 6525, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "229205_340245", "229205_340249", "229205_340253", "229205_340257", "229205_340261" ], "enumNames": [ "oryginalne", "otwarte", "uszkodzone", "zastępcze", "brak opakowania" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "oryginalne", "otwarte", "uszkodzone", "zastępcze", "brak opakowania" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "229205_340245" ] } ] }, "7037": { "title": "Region producenta filmu", "x-allee": { "alleeId": 443, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "7037_1", "7037_3", "7037_2", "7037_4", "7037_5", "7037_6", "7037_7" ], "enumNames": [ "Afryka", "Ameryka Północna", "Ameryka Południowa", "Australia", "Azja", "Europa", "Produkcja mieszana" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "Afryka", "Ameryka Północna", "Ameryka Południowa", "Australia", "Azja", "Europa", "Produkcja mieszana" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "7037_1" ] } ] }, "249816": { "title": "Język dubbingu", "x-allee": { "alleeId": 10734, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "249816_1743449", "249816_1743468", "249816_1743469", "249816_1743450", "249816_1743466", "249816_1743459", "249816_1743455", "249816_1743465", "249816_1743472", "249816_1743460", "249816_1743470", "249816_1743471", "249816_1743467", "249816_1743456", "249816_1743458", "249816_1743448", "249816_1743452", "249816_1743462", "249816_1743453", "249816_1743454", "249816_1743457", "249816_1743464", "249816_1743463", "249816_1743451", "249816_1743461" ], "enumNames": [ "angielski", "arabski", "chiński (mandaryński)", "czeski", "duński", "fiński", "francuski", "grecki", "hindi", "hiszpański", "japoński", "koreański", "niderlandzki", "niemiecki", "norweski", "polski", "portugalski", "rosyjski", "rumuński", "słowacki", "szwedzki", "turecki", "ukraiński", "węgierski", "włoski" ] } }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "angielski", "arabski", "chiński (mandaryński)", "czeski", "duński", "fiński", "francuski", "grecki", "hindi", "hiszpański", "japoński", "koreański", "niderlandzki", "niemiecki", "norweski", "polski", "portugalski", "rosyjski", "rumuński", "słowacki", "szwedzki", "turecki", "ukraiński", "węgierski", "włoski" ] } } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "249816_1743449" ] } ] }, "249815": { "title": "Język lektora", "x-allee": { "alleeId": 10733, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "249815_1743424", "249815_1743443", "249815_1743444", "249815_1743425", "249815_1743441", "249815_1743434", "249815_1743430", "249815_1743440", "249815_1743447", "249815_1743435", "249815_1743445", "249815_1743446", "249815_1743442", "249815_1743431", "249815_1743433", "249815_1743423", "249815_1743427", "249815_1743437", "249815_1743428", "249815_1743429", "249815_1743432", "249815_1743439", "249815_1743438", "249815_1743426", "249815_1743436" ], "enumNames": [ "angielski", "arabski", "chiński (mandaryński)", "czeski", "duński", "fiński", "francuski", "grecki", "hindi", "hiszpański", "japoński", "koreański", "niderlandzki", "niemiecki", "norweski", "polski", "portugalski", "rosyjski", "rumuński", "słowacki", "szwedzki", "turecki", "ukraiński", "węgierski", "włoski" ] } }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "angielski", "arabski", "chiński (mandaryński)", "czeski", "duński", "fiński", "francuski", "grecki", "hindi", "hiszpański", "japoński", "koreański", "niderlandzki", "niemiecki", "norweski", "polski", "portugalski", "rosyjski", "rumuński", "słowacki", "szwedzki", "turecki", "ukraiński", "węgierski", "włoski" ] } } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "249815_1743424" ] } ] }, "249814": { "title": "Język napisów", "x-allee": { "alleeId": 10732, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "249814_1743397", "249814_1743416", "249814_1743417", "249814_1743398", "249814_1743414", "249814_1743407", "249814_1743403", "249814_1743413", "249814_1743420", "249814_1743408", "249814_1743418", "249814_1743419", "249814_1743415", "249814_1743404", "249814_1743406", "249814_1743396", "249814_1743400", "249814_1743410", "249814_1743401", "249814_1743402", "249814_1743405", "249814_1743412", "249814_1743411", "249814_1743399", "249814_1743409" ], "enumNames": [ "angielski", "arabski", "chiński (mandaryński)", "czeski", "duński", "fiński", "francuski", "grecki", "hindi", "hiszpański", "japoński", "koreański", "niderlandzki", "niemiecki", "norweski", "polski", "portugalski", "rosyjski", "rumuński", "słowacki", "szwedzki", "turecki", "ukraiński", "węgierski", "włoski" ] } }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "angielski", "arabski", "chiński (mandaryński)", "czeski", "duński", "fiński", "francuski", "grecki", "hindi", "hiszpański", "japoński", "koreański", "niderlandzki", "niemiecki", "norweski", "polski", "portugalski", "rosyjski", "rumuński", "słowacki", "szwedzki", "turecki", "ukraiński", "węgierski", "włoski" ] } } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "249814_1743397" ] } ] }, "249777": { "title": "Wytwórnia filmowa", "x-allee": { "alleeId": 10701, "type": "dictionary", "unit": null }, "type": "object", "properties": { "valuesIds": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "249777_1930418", "249777_1930415", "249777_1737231", "249777_1737232", "249777_1737234", "249777_1737235", "249777_1737236", "249777_1737237", "249777_1737238", "249777_1930416", "249777_1737239", "249777_1737240", "249777_1930412", "249777_2035720", "249777_1737241", "249777_1737242", "249777_1737243", "249777_1737244", "249777_1737245", "249777_1737246", "249777_1737247", "249777_1737248", "249777_1737249", "249777_1737250", "249777_1737252", "249777_1737253", "249777_1737254", "249777_1737256", "249777_1930413", "249777_1737257", "249777_1737258", "249777_1930409", "249777_1737260", "249777_1737261", "249777_1737262", "249777_1737263", "249777_2055003", "249777_1737264", "249777_1930421", "249777_1737266", "249777_1737267", "249777_1737268", "249777_1737269", "249777_1737270", "249777_2081635", "249777_1737271", "249777_1737272", "249777_1737273", "249777_1737274", "249777_1930422", "249777_1930420", "249777_1737275", "249777_1737276", "249777_1737277", "249777_1930417", "249777_1737278", "249777_1737279", "249777_1928589", "249777_1737280", "249777_1737281", "249777_1737282", "249777_1737283", "249777_1737285", "249777_1737286", "249777_1737287", "249777_1737288", "249777_1737289", "249777_1737290", "249777_1930414", "249777_1737291", "249777_1737292", "249777_1737233", "249777_1737293", "249777_1737294", "249777_2076447", "249777_1737295", "249777_1737296", "249777_1737298", "249777_1930419", "249777_1930410", "249777_1926942", "249777_1737299", "249777_1930411", "249777_1737300", "249777_2010823", "249777_1737301", "249777_1737302", "249777_1737303", "249777_1737304", "249777_1737305", "249777_1737306", "249777_1737307" ], "enumNames": [ "20th Century Fox", "20th Century Studios", "A.k.a. Cartoon", "Aardman Animations", "Atéliery Bonton Zlín", "Biełaruśfilm", "Bratři v triku", "Bridge (studio)", "Burbank Films Australia", "Cass film", "CinéGroupe", "CloverWorks", "Columbia Pictures", "Concorde Video", "Diomedéa", "Doga Kobo", "DreamWorks Animation", "Felix Film", "Frederator Studios", "Fresh TV", "Gaumont", "Geek Toys", "Geno Studio", "Golden Films", "Hanna-Barbera", "ImageMovers", "ImageMovers Digital", "Kinema Citrus", "Kino Świat", "Klasky Csupo, Inc.", "Lay-duce", "LEONINE Distribution", "Mainframe Entertainment", "MAPPA", "Marathon Media Group", "Marvel Animation", "Mayfly", "Metro-Goldwyn-Mayer", "MGM Studios", "Mongolkino", "NAZ", "Nelvana", "Neptuno Films", "Nerd Corps Entertainment", "New Abra", "NUT (studio)", "Orange (studio)", "Pacific Data Images", "Pannonia Film Studio", "Paramount", "Paramount Pictures", "Passione", "Pine Jam", "Pixar", "Plaion Pictures", "Platige Image", "Platinum Vision", "Prosveta", "Rainbow", "Renegade Animation", "Revoroot", "Se-ma-for", "Silver Link", "Sojuzmultfilm", "Sony Pictures Animation", "SPInka Film Studio", "Stoopid Buddy Studios", "Studio Bind", "Studiocanal", "Studio Ekran", "Studio Filmów Animowanych", "Studio Filmowe Anima-Pol", "Studio Miniatur Filmowych", "Teletoon", "TELEWIZJA POLSKA SA", "Trigger", "Troyca", "TV Studio Filmów Animowanych", "Universal Pictures", "Universal Pictures Video", "VICTOR 11", "Walt Disney Animation Studios", "Warner Bros.", "Warner Bros. Animation", "WFDiF", "WildBrain", "Wit Studio", "Wołgogradtielefilm", "World Events Productions", "Zagreb Film", "Zero-G", "Zodiac Entertainment" ] }, "maxItems": 1 }, "values": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "enum": [ "20th Century Fox", "20th Century Studios", "A.k.a. Cartoon", "Aardman Animations", "Atéliery Bonton Zlín", "Biełaruśfilm", "Bratři v triku", "Bridge (studio)", "Burbank Films Australia", "Cass film", "CinéGroupe", "CloverWorks", "Columbia Pictures", "Concorde Video", "Diomedéa", "Doga Kobo", "DreamWorks Animation", "Felix Film", "Frederator Studios", "Fresh TV", "Gaumont", "Geek Toys", "Geno Studio", "Golden Films", "Hanna-Barbera", "ImageMovers", "ImageMovers Digital", "Kinema Citrus", "Kino Świat", "Klasky Csupo, Inc.", "Lay-duce", "LEONINE Distribution", "Mainframe Entertainment", "MAPPA", "Marathon Media Group", "Marvel Animation", "Mayfly", "Metro-Goldwyn-Mayer", "MGM Studios", "Mongolkino", "NAZ", "Nelvana", "Neptuno Films", "Nerd Corps Entertainment", "New Abra", "NUT (studio)", "Orange (studio)", "Pacific Data Images", "Pannonia Film Studio", "Paramount", "Paramount Pictures", "Passione", "Pine Jam", "Pixar", "Plaion Pictures", "Platige Image", "Platinum Vision", "Prosveta", "Rainbow", "Renegade Animation", "Revoroot", "Se-ma-for", "Silver Link", "Sojuzmultfilm", "Sony Pictures Animation", "SPInka Film Studio", "Stoopid Buddy Studios", "Studio Bind", "Studiocanal", "Studio Ekran", "Studio Filmów Animowanych", "Studio Filmowe Anima-Pol", "Studio Miniatur Filmowych", "Teletoon", "TELEWIZJA POLSKA SA", "Trigger", "Troyca", "TV Studio Filmów Animowanych", "Universal Pictures", "Universal Pictures Video", "VICTOR 11", "Walt Disney Animation Studios", "Warner Bros.", "Warner Bros. Animation", "WFDiF", "WildBrain", "Wit Studio", "Wołgogradtielefilm", "World Events Productions", "Zagreb Film", "Zero-G", "Zodiac Entertainment" ] }, "maxItems": 1 } }, "additionalProperties": false, "minProperties": 1, "maxProperties": 1, "examples": [ { "valuesIds": [ "249777_1930418" ] } ] }, "250792": { "title": "Kod taryfy celnej", "x-allee": { "alleeId": 11529, "type": "string", "unit": null }, "type": "object", "properties": { "values": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "string", "minLength": 8, "maxLength": 14, "pattern": "\\S" } } }, "required": [ "values" ], "additionalProperties": false, "examples": [ { "values": [ "Przykład" ] } ] }, "17448": { "title": "Waga produktu z opakowaniem jednostkowym", "x-allee": { "alleeId": 811, "type": "float", "unit": "kg" }, "type": "object", "properties": { "values": { "type": "array", "minItems": 1, "maxItems": 1, "items": { "type": "number", "minimum": 0, "maximum": 1000000 } } }, "required": [ "values" ], "additionalProperties": false, "examples": [ { "values": [ 1 ] } ] } }, "additionalProperties": false, "required": [ "11323", "246845", "250077", "225693", "237218" ] }, "images": { "type": "array", "title": "Zdjęcia (adresy https; pierwsze = główne)", "minItems": 1, "maxItems": 16, "uniqueItems": true, "items": { "type": "string", "pattern": "^https?://[^\\s]{4,995}$" }, "examples": [ [ "https://cdn.allee.pl/przyklad.jpg" ] ] }, "description": { "type": "string", "minLength": 20, "maxLength": 20000, "title": "Opis (tekst; pusta linia = nowy akapit, „- ” = punkt listy)", "examples": [ "Opis produktu: co kupujący dostaje w paczce.\n\nWymiary i materiał w parametrach." ] }, "price": { "type": "object", "title": "Cena brutto", "required": [ "amount" ], "additionalProperties": false, "properties": { "amount": { "type": "string", "pattern": "^\\d{1,8}(\\.\\d{1,2})?$" }, "currency": { "const": "PLN" } }, "x-allee-minimum": "1.00", "x-allee-maximum": "10000000.00", "examples": [ { "amount": "49.99", "currency": "PLN" } ] }, "stock": { "type": "integer", "minimum": 1, "maximum": 99999, "title": "Liczba sztuk (nowa oferta: co najmniej 1; 0 kończy ofertę)", "examples": [ 5 ] }, "ean": { "type": "string", "pattern": "^(\\d{8}|\\d{12,14})$", "title": "EAN (GTIN) — skrót parametru 225693" }, "shippingRatesId": { "type": "string", "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "title": "Cennik dostawy (GET /sale/shipping-rates)" }, "handlingTime": { "enum": [ "PT0S", "PT24H", "P2D", "P3D", "P4D", "P5D", "P7D", "P10D", "P14D", "P21D", "P30D", "P60D" ], "title": "Czas wysyłki (ISO 8601)" }, "returnPolicyId": { "type": [ "string", "null" ], "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "title": "Warunki zwrotów (GET /after-sales-service-conditions/return-policies)" }, "warrantyId": { "type": [ "string", "null" ], "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "title": "Gwarancja" }, "impliedWarrantyId": { "type": [ "string", "null" ], "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "title": "Reklamacje (rękojmia)" }, "responsibleProducerId": { "type": [ "string", "null" ], "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "title": "Producent odpowiedzialny GPSR (GET /sale/responsible-producers)" }, "responsiblePersonId": { "type": [ "string", "null" ], "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$", "title": "Osoba odpowiedzialna GPSR (GET /sale/responsible-persons)" }, "safetyInformation": { "title": "Informacje o bezpieczeństwie GPSR", "oneOf": [ { "type": "object", "required": [ "type", "description" ], "properties": { "type": { "const": "TEXT" }, "description": { "type": "string", "minLength": 1, "maxLength": 5000 } } }, { "type": "object", "required": [ "type" ], "properties": { "type": { "const": "NO_SAFETY_INFORMATION" } } }, { "type": "null" } ] }, "taxRate": { "enum": [ "0.00", "5.00", "8.00", "23.00", null ], "title": "Stawka VAT" }, "invoice": { "enum": [ "VAT", "VAT_MARGIN", "WITHOUT_VAT", "NO_INVOICE" ], "title": "Faktura" }, "location": { "type": [ "object", "null" ], "title": "Lokalizacja towaru", "additionalProperties": false, "properties": { "city": { "type": "string" }, "countryCode": { "type": "string", "pattern": "^[A-Z]{2}$" }, "postCode": { "type": "string" }, "province": { "type": "string" } } } } } }, "allOf": [ { "if": { "properties": { "status": { "const": "ACTIVE" } }, "required": [ "status" ] }, "then": { "properties": { "attributes": { "required": [ "responsibleProducerId", "safetyInformation" ] } } } } ] }, "meta": { "version": "c0382ae5b1a72452", "generatedAt": "2026-11-10T11:10:03Z" }, "propertyGroups": { "produkt": { "title": "Produkt", "propertyNames": [ "name", "category", "parameters", "images", "description", "ean" ] }, "oferta": { "title": "Oferta", "propertyNames": [ "price", "stock", "shippingRatesId", "handlingTime", "taxRate", "invoice", "location" ] }, "warunki": { "title": "Zwroty, reklamacje, gwarancja", "propertyNames": [ "returnPolicyId", "impliedWarrantyId", "warrantyId" ] }, "gpsr": { "title": "Bezpieczeństwo produktu (GPSR)", "propertyNames": [ "responsibleProducerId", "responsiblePersonId", "safetyInformation" ] } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategorySchema" } } } }, "304": { "description": "Bez zmian (If-None-Match).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `CATEGORY_NOT_LEAF`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Product Type Definitions — getDefinitionsProductType", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 422, "code": "CATEGORY_NOT_LEAF" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/categories/35/schema?requirements=LISTING\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/categories/35/schema (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/categories/35/schema?requirements=LISTING\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/categories/35/schema (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/categories/35/schema?requirements=LISTING`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/categories/35/schema (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/categories/35/schema?requirements=LISTING\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/categories/35/schema (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/categories/35/schema?requirements=LISTING\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/categories/35/schema (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/categories/35/schema?requirements=LISTING\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/compliance/rules": { "get": { "operationId": "getComplianceRules", "summary": "Wymagania prawne w kategorii", "tags": [ "Zgodność sprzedawcy" ], "description": "Co trzeba podać w ofercie tej kategorii, żeby była zgodna z prawem: reguły z kodem i wersją, wymaganie, ścieżka pola (`productSet[0].responsibleProducer`, `parameters.{id}`…), skutek (`WARN` / `BLOCK`), od kiedy blokuje, podstawa prawna. Reguły dotyczą poddrzewa kategorii (np. GPSR nie obejmuje żywności, antyków, usług), rodzaju sprzedawcy i stanu produktu; reguły parametrowe — tylko kategorii, które mają dany parametr.\n\nPytaj raz na kategorię (wynik możesz trzymać w pamięci podręcznej do zmiany wersji reguł).\n\n**Zgodność:** tylko allee — Product Type Definitions (wymagania prawne).\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "category.id", "in": "query", "required": true, "description": "Kategoria.", "schema": { "type": "string", "description": "Identyfikator kategorii allee albo Allegro." } }, { "name": "sellerType", "in": "query", "required": false, "description": "Tylko reguły dla tego rodzaju sprzedawcy.", "schema": { "type": "string", "enum": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ] } } ], "responses": { "200": { "description": "Reguły.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ComplianceRuleList" }, "example": { "category": { "id": "20585" }, "sellerType": null, "rules": [], "count": 0 } }, "application/json": { "schema": { "$ref": "#/components/schemas/ComplianceRuleList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "Amazon SP-API: Product Type Definitions (wymagania prawne)", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/compliance/rules?category.id=20585\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/compliance/rules (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/compliance/rules?category.id=20585\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/compliance/rules (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/compliance/rules?category.id=20585`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/compliance/rules (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/compliance/rules?category.id=20585\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/compliance/rules (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/compliance/rules?category.id=20585\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/compliance/rules (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/compliance/rules?category.id=20585\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/decisions": { "get": { "operationId": "getDecisions", "summary": "Decyzje allee z uzasadnieniem (DSA)", "tags": [ "Zgodność sprzedawcy" ], "description": "Decyzje ograniczające (zakończenie oferty, ostrzeżenie, blokady, zawieszenie) z uzasadnieniem: środek, podstawa (`ILLEGAL_CONTENT` — przepis prawa albo `TERMS_OF_SERVICE`), fakty, czy użyto automatu, środki odwoławcze i termin odwołania.\n\nNowa decyzja = webhook `OFFER_RESTRICTED`.\n\n**Zgodność:** tylko allee — — (DSA art. 17).\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji.", "schema": { "type": "integer", "description": "1–100, domyślnie 50." } }, { "name": "offset", "in": "query", "required": false, "description": "Przesunięcie.", "schema": { "type": "integer", "description": "Domyślnie 0." } } ], "responses": { "200": { "description": "Decyzje.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DecisionList" }, "example": { "decisions": [ { "id": "DEC-2026-000001", "noticeId": "DSA-2026-000001", "offerId": "900000000000021", "measure": "OSTRZEZENIE", "measureLabel": "Ostrzeżenie dla sprzedawcy", "legalGround": "TERMS_OF_SERVICE", "groundReference": "§ 7 regulaminu allee (oryginalność towarów)", "facts": "Zdjęcia sugerują podrobiony znak; sprzedawca przedstawił fakturę — ostrzeżenie zamiast zakończenia oferty.", "automatedMeans": false, "territorialScope": "allee.pl (cała UE)", "createdAt": "2026-11-10T11:10:03.000Z", "redress": { "internalComplaint": "Odwołanie w panelu (Ustawienia › Zgodność) albo POST /allee/decisions/{id}/appeal do 12.05.2027.", "outOfCourt": "Certyfikowany organ pozasądowego rozstrzygania sporów (art. 21 DSA).", "court": "Sąd powszechny." }, "appealDeadline": "2027-05-12T11:10:03.000Z", "appeal": null } ], "limit": 50, "offset": 0 } }, "application/json": { "schema": { "$ref": "#/components/schemas/DecisionList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "— (DSA art. 17)", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/decisions\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/decisions (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/decisions\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/decisions (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/decisions`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/decisions (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/decisions\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/decisions (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/decisions\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/decisions (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/decisions\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/decisions/{id}": { "get": { "operationId": "getDecision", "summary": "Decyzja (uzasadnienie)", "tags": [ "Zgodność sprzedawcy" ], "description": "Jedna decyzja ze stanem odwołania.\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Numer decyzji.", "schema": { "type": "string", "examples": [ "DEC-2026-000001" ] } } ], "responses": { "200": { "description": "Decyzja.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Decision" }, "example": { "id": "DEC-2026-000001", "noticeId": "DSA-2026-000001", "offerId": "900000000000021", "measure": "OSTRZEZENIE", "measureLabel": "Ostrzeżenie dla sprzedawcy", "legalGround": "TERMS_OF_SERVICE", "groundReference": "§ 7 regulaminu allee (oryginalność towarów)", "facts": "Zdjęcia sugerują podrobiony znak; sprzedawca przedstawił fakturę — ostrzeżenie zamiast zakończenia oferty.", "automatedMeans": false, "territorialScope": "allee.pl (cała UE)", "createdAt": "2026-11-10T11:10:03.000Z", "redress": { "internalComplaint": "Odwołanie w panelu (Ustawienia › Zgodność) albo POST /allee/decisions/{id}/appeal do 12.05.2027.", "outOfCourt": "Certyfikowany organ pozasądowego rozstrzygania sporów (art. 21 DSA).", "court": "Sąd powszechny." }, "appealDeadline": "2027-05-12T11:10:03.000Z", "appeal": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/decisions/DEC-2026-000001\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/decisions/DEC-2026-000001 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/decisions/DEC-2026-000001\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/decisions/DEC-2026-000001 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/decisions/DEC-2026-000001`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/decisions/DEC-2026-000001 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/decisions/DEC-2026-000001\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/decisions/DEC-2026-000001 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/decisions/DEC-2026-000001\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/decisions/DEC-2026-000001 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/decisions/DEC-2026-000001\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/decisions/{id}/appeal": { "post": { "operationId": "appealDecision", "summary": "Odwołanie od decyzji", "tags": [ "Zgodność sprzedawcy" ], "description": "Odwołanie w ciągu 6 miesięcy; rozpatruje człowiek. Uchylenie cofa środek (wznowienie oferty, zdjęcie blokady). Jedno odwołanie na decyzję — drugie → 409.\n\n**Zgodność:** tylko allee — — (DSA art. 20).\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Numer decyzji.", "schema": { "type": "string", "examples": [ "DEC-2026-000001" ] } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/TextInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TextInput" } } } }, "responses": { "201": { "description": "Odwołanie złożone.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Decision" }, "example": { "id": "DEC-2026-000001", "noticeId": "DSA-2026-000001", "offerId": "900000000000021", "measure": "OSTRZEZENIE", "measureLabel": "Ostrzeżenie dla sprzedawcy", "legalGround": "TERMS_OF_SERVICE", "groundReference": "§ 7 regulaminu allee (oryginalność towarów)", "facts": "Zdjęcia sugerują podrobiony znak; sprzedawca przedstawił fakturę — ostrzeżenie zamiast zakończenia oferty.", "automatedMeans": false, "territorialScope": "allee.pl (cała UE)", "createdAt": "2026-11-10T11:10:03.000Z", "redress": { "internalComplaint": "Odwołanie w panelu (Ustawienia › Zgodność) albo POST /allee/decisions/{id}/appeal do 12.05.2027.", "outOfCourt": "Certyfikowany organ pozasądowego rozstrzygania sporów (art. 21 DSA).", "court": "Sąd powszechny." }, "appealDeadline": "2027-05-12T11:10:03.000Z", "appeal": { "status": "SUBMITTED", "text": "Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.", "submittedAt": "2026-11-10T11:10:03.000Z", "resolution": null, "resolvedAt": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Decision" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "— (DSA art. 20)", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/decisions/DEC-2026-000001/appeal\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"text\": \"Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.',\n];\n$ch = curl_init($base . '/allee/decisions/DEC-2026-000001/appeal');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/decisions/DEC-2026-000001/appeal (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"text\": \"Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/decisions/DEC-2026-000001/appeal\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/decisions/DEC-2026-000001/appeal (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"text\": \"Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.\"\n};\nconst res = await fetch(`${BASE}/allee/decisions/DEC-2026-000001/appeal`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/decisions/DEC-2026-000001/appeal (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/decisions/DEC-2026-000001/appeal\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"text\": \"Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/decisions/DEC-2026-000001/appeal (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"text\": \"Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/decisions/DEC-2026-000001/appeal\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/decisions/DEC-2026-000001/appeal (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"text\": \"Faktura potwierdza legalne pochodzenie towaru — proszę o uchylenie ostrzeżenia.\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/decisions/DEC-2026-000001/appeal\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/declarations": { "get": { "operationId": "getDeclarations", "summary": "Oświadczenia sprzedawcy (treści z wersjami)", "tags": [ "Zgodność sprzedawcy" ], "description": "Aktualne treści oświadczeń (np. DSA „tylko produkty zgodne z prawem”), dla kogo są wymagane i czy sprzedawca zaakceptował aktualną wersję. Nowa wersja treści = trzeba ją zaakceptować ponownie (w compliance: `DECLARATION_UPDATE_REQUIRED`).\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allegro:api:profile:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Oświadczenia.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DeclarationList" }, "example": { "declarations": [ { "code": "AUTHENTIC_GOODS", "version": "2026-11-10", "title": "Sprzedaję oryginalne towary z legalnego źródła", "text": "Oświadczam, że sprzedawane przeze mnie towary są oryginalne, pochodzą z legalnego źródła i nie naruszają praw własności intelektualnej (w tym znaków towarowych).", "legalBasis": "prawo własności przemysłowej", "requiredFor": [ "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ], "effectiveFrom": "2026-11-09T23:00:00.000Z", "accepted": { "current": false, "acceptedAt": null, "acceptedVersions": [] } }, { "code": "DATA_TRUE", "version": "2026-11-10", "title": "Moje dane są prawdziwe i aktualne", "text": "Oświadczam, że dane podane w allee (dane identyfikacyjne, adres, dane kontaktowe i rejestrowe) są prawdziwe, kompletne i aktualne, a każdą zmianę wprowadzę bez zwłoki.", "legalBasis": "DSA art. 30 ust. 1 i 4", "requiredFor": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ], "effectiveFrom": "2026-11-09T23:00:00.000Z", "accepted": { "current": false, "acceptedAt": null, "acceptedVersions": [] } }, { "code": "DSA_LEGAL_PRODUCTS", "version": "2026-11-10", "title": "Oferuję wyłącznie produkty i usługi zgodne z prawem", "text": "Oświadczam, że oferuję w allee wyłącznie produkty i usługi zgodne z mającymi zastosowanie przepisami prawa Unii Europejskiej i prawa polskiego, w tym z wymaganiami dotyczącymi bezpieczeństwa produktów i oznakowania.", "legalBasis": "DSA art. 30 ust. 1 lit. e", "requiredFor": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ], "effectiveFrom": "2026-11-09T23:00:00.000Z", "accepted": { "current": false, "acceptedAt": null, "acceptedVersions": [] } }, { "code": "IMAGE_RIGHTS", "version": "2026-11-10", "title": "Mam prawa do zdjęć i opisów", "text": "Oświadczam, że mam prawo do używania zdjęć, opisów i innych materiałów, które publikuję w ofertach, i że nie naruszają one praw osób trzecich.", "legalBasis": "ustawa o prawie autorskim i prawach pokrewnych", "requiredFor": [ "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ], "effectiveFrom": "2026-11-09T23:00:00.000Z", "accepted": { "current": false, "acceptedAt": null, "acceptedVersions": [] } }, { "code": "PRIVATE_NOT_TRADER", "version": "2026-11-10", "title": "Sprzedaję jako osoba prywatna, nie w ramach działalności", "text": "Oświadczam, że sprzedaję w allee rzeczy z własnego gospodarstwa domowego, okazjonalnie i nie w celach zarobkowych w ramach działalności gospodarczej. Rozumiem, że kupujący nie korzystają wobec mnie z praw konsumenta przysługujących przy zakupie od przedsiębiorcy. Jeśli zacznę sprzedawać zarobkowo, zmienię rodzaj konta.", "legalBasis": "DSA art. 30 i 31; ustawa o prawach konsumenta", "requiredFor": [ "PRIVATE_PERSON" ], "effectiveFrom": "2026-11-09T23:00:00.000Z", "accepted": { "current": false, "acceptedAt": null, "acceptedVersions": [] } }, { "code": "UNREGISTERED_LIMIT", "version": "2026-11-10", "title": "Działalność nierejestrowana mieści się w limicie", "text": "Oświadczam, że prowadzę działalność nierejestrowaną, której przychód należny nie przekracza w żadnym kwartale limitu z art. 5 ustawy Prawo przedsiębiorców. Po przekroczeniu limitu zarejestruję działalność i zmienię rodzaj konta w allee.", "legalBasis": "Prawo przedsiębiorców art. 5", "requiredFor": [ "UNREGISTERED_ACTIVITY" ], "effectiveFrom": "2026-11-09T23:00:00.000Z", "accepted": { "current": false, "acceptedAt": null, "acceptedVersions": [] } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/DeclarationList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:profile:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "read", "scope": "allegro:api:profile:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/declarations\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/declarations (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/declarations\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/declarations (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/declarations`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/declarations (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/declarations\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/declarations (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/declarations\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/declarations (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/declarations\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/feeds": { "post": { "operationId": "createFeed", "summary": "Nowy wsad ofert (JSON_LISTINGS_FEED)", "tags": [ "Wsady (feeds)" ], "description": "Do 10 000 komunikatów (UPDATE, PARTIAL_UPDATE, PATCH, DELETE) przetwarzanych w tle w kolejności `messageId`. Odpowiedź **202** od razu; koniec poznasz z `GET /allee/feeds/{feedId}` albo powiadomienia `FEED_PROCESSING_FINISHED`, wynik każdego komunikatu — z `…/result`.\n\nŹródło (dokładnie jedno): `content` (dokument inline), `messages` (sama lista) albo `inputFeedDocumentId`. Najwyżej 2 wsady sprzedawcy w toku (429 `TOO_MANY_CONCURRENT`). Gdy kolejka nie działa, wsad do 500 komunikatów przetwarzamy od razu (202 z `DONE`).\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Feeds — createFeed (JSON_LISTINGS_FEED).\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CreateFeedRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CreateFeedRequest" } } } }, "responses": { "202": { "description": "Przyjęto do przetwarzania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Feed" }, "example": { "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49", "feedType": "JSON_LISTINGS_FEED", "marketplaceIds": [ "allee-pl" ], "createdTime": "2026-11-10T11:10:04.563Z", "processingStatus": "IN_QUEUE", "processingStartTime": null, "processingEndTime": null, "resultFeedDocumentId": null, "allee": { "source": "INLINE", "messages": { "total": 3, "processed": 0, "accepted": 0, "invalid": 0, "withWarnings": 0 }, "fatalError": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Feed" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `FEED_DOCUMENT_NOT_FOUND`, `INVALID_FEED_DOCUMENT`, `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`, `QUEUE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Feeds — createFeed (JSON_LISTINGS_FEED)", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "FEED_DOCUMENT_NOT_FOUND" }, { "status": 422, "code": "INVALID_FEED_DOCUMENT" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" }, { "status": 503, "code": "QUEUE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"feedType\": \"JSON_LISTINGS_FEED\",\n \"content\": {\n \"header\": {\n \"sellerId\": 980000001,\n \"version\": \"2.0\"\n },\n \"messages\": [\n {\n \"messageId\": 1,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Gabinet doktora Caligari DVD\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"45.00\",\n \"currency\": \"PLN\"\n },\n \"stock\": 3,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 2,\n \"sku\": \"FILM-21ef85-6\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Nosferatu DVD wydanie specjalne\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 5,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 3,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"PARTIAL_UPDATE\",\n \"attributes\": {\n \"price\": {\n \"amount\": \"41.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 15\n }\n }\n ]\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'JSON_LISTINGS_FEED',\n 'content' => [\n 'header' => [\n 'sellerId' => 980000001,\n 'version' => '2.0',\n ],\n 'messages' => [\n [\n 'messageId' => 1,\n 'sku' => 'FILM-21ef85-5',\n 'operationType' => 'UPDATE',\n 'requirements' => 'LISTING',\n 'attributes' => [\n 'name' => 'Gabinet doktora Caligari DVD',\n 'category' => [\n 'alleeId' => 35,\n ],\n 'parameters' => [\n '225693' => [\n 'values' => [\n '5901234123464',\n ],\n ],\n '237218' => [\n 'values' => [\n 'Metropolis',\n ],\n ],\n '246845' => [\n 'valuesIds' => [\n '246845_622165',\n ],\n ],\n '250077' => [\n 'valuesIds' => [\n '250077_1797493',\n ],\n ],\n '11323' => [\n 'valuesIds' => [\n '11323_1',\n ],\n ],\n ],\n 'price' => [\n 'amount' => '45.00',\n 'currency' => 'PLN',\n ],\n 'stock' => 3,\n 'images' => [\n 'https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp',\n ],\n 'description' => 'Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.',\n 'shippingRatesId' => '797d2e65-cb23-4a16-98e9-d6f2a399839a',\n 'responsibleProducerId' => '472bad66-e704-4344-a2d6-9bd85b1f9a5e',\n 'safetyInformation' => [\n 'type' => 'TEXT',\n 'description' => 'Produkt bezpieczny w normalnym użytkowaniu.',\n ],\n ],\n ],\n [\n 'messageId' => 2,\n 'sku' => 'FILM-21ef85-6',\n 'operationType' => 'UPDATE',\n 'requirements' => 'LISTING',\n 'attributes' => [\n 'name' => 'Nosferatu DVD wydanie specjalne',\n 'category' => [\n 'alleeId' => 35,\n ],\n 'parameters' => [\n '225693' => [\n 'values' => [\n '5901234123464',\n ],\n ],\n '237218' => [\n 'values' => [\n 'Metropolis',\n ],\n ],\n '246845' => [\n 'valuesIds' => [\n '246845_622165',\n ],\n ],\n '250077' => [\n 'valuesIds' => [\n '250077_1797493',\n ],\n ],\n '11323' => [\n 'valuesIds' => [\n '11323_1',\n ],\n ],\n ],\n 'price' => [\n 'amount' => '39.90',\n 'currency' => 'PLN',\n ],\n 'stock' => 5,\n 'images' => [\n 'https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp',\n ],\n 'description' => 'Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.',\n 'shippingRatesId' => '797d2e65-cb23-4a16-98e9-d6f2a399839a',\n 'responsibleProducerId' => '472bad66-e704-4344-a2d6-9bd85b1f9a5e',\n 'safetyInformation' => [\n 'type' => 'TEXT',\n 'description' => 'Produkt bezpieczny w normalnym użytkowaniu.',\n ],\n ],\n ],\n [\n 'messageId' => 3,\n 'sku' => 'FILM-21ef85-5',\n 'operationType' => 'PARTIAL_UPDATE',\n 'attributes' => [\n 'price' => [\n 'amount' => '41.90',\n 'currency' => 'PLN',\n ],\n 'stock' => 15,\n ],\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/allee/feeds');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/feeds (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"feedType\": \"JSON_LISTINGS_FEED\",\n \"content\": {\n \"header\": {\n \"sellerId\": 980000001,\n \"version\": \"2.0\",\n },\n \"messages\": [\n {\n \"messageId\": 1,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Gabinet doktora Caligari DVD\",\n \"category\": {\n \"alleeId\": 35,\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\",\n ],\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\",\n ],\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\",\n ],\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\",\n ],\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\",\n ],\n },\n },\n \"price\": {\n \"amount\": \"45.00\",\n \"currency\": \"PLN\",\n },\n \"stock\": 3,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\",\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\",\n },\n },\n },\n {\n \"messageId\": 2,\n \"sku\": \"FILM-21ef85-6\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Nosferatu DVD wydanie specjalne\",\n \"category\": {\n \"alleeId\": 35,\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\",\n ],\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\",\n ],\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\",\n ],\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\",\n ],\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\",\n ],\n },\n },\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\",\n },\n \"stock\": 5,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\",\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\",\n },\n },\n },\n {\n \"messageId\": 3,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"PARTIAL_UPDATE\",\n \"attributes\": {\n \"price\": {\n \"amount\": \"41.90\",\n \"currency\": \"PLN\",\n },\n \"stock\": 15,\n },\n },\n ],\n },\n}\nr = requests.request(\"POST\", BASE + \"/allee/feeds\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/feeds (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"feedType\": \"JSON_LISTINGS_FEED\",\n \"content\": {\n \"header\": {\n \"sellerId\": 980000001,\n \"version\": \"2.0\"\n },\n \"messages\": [\n {\n \"messageId\": 1,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Gabinet doktora Caligari DVD\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"45.00\",\n \"currency\": \"PLN\"\n },\n \"stock\": 3,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 2,\n \"sku\": \"FILM-21ef85-6\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Nosferatu DVD wydanie specjalne\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 5,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 3,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"PARTIAL_UPDATE\",\n \"attributes\": {\n \"price\": {\n \"amount\": \"41.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 15\n }\n }\n ]\n }\n};\nconst res = await fetch(`${BASE}/allee/feeds`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/feeds (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/feeds\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"feedType\": \"JSON_LISTINGS_FEED\",\n \"content\": {\n \"header\": {\n \"sellerId\": 980000001,\n \"version\": \"2.0\"\n },\n \"messages\": [\n {\n \"messageId\": 1,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Gabinet doktora Caligari DVD\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"45.00\",\n \"currency\": \"PLN\"\n },\n \"stock\": 3,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 2,\n \"sku\": \"FILM-21ef85-6\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Nosferatu DVD wydanie specjalne\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 5,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 3,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"PARTIAL_UPDATE\",\n \"attributes\": {\n \"price\": {\n \"amount\": \"41.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 15\n }\n }\n ]\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/feeds (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"feedType\": \"JSON_LISTINGS_FEED\",\n \"content\": {\n \"header\": {\n \"sellerId\": 980000001,\n \"version\": \"2.0\"\n },\n \"messages\": [\n {\n \"messageId\": 1,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Gabinet doktora Caligari DVD\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"45.00\",\n \"currency\": \"PLN\"\n },\n \"stock\": 3,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 2,\n \"sku\": \"FILM-21ef85-6\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Nosferatu DVD wydanie specjalne\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 5,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 3,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"PARTIAL_UPDATE\",\n \"attributes\": {\n \"price\": {\n \"amount\": \"41.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 15\n }\n }\n ]\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/feeds\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/feeds (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"feedType\": \"JSON_LISTINGS_FEED\",\n \"content\": {\n \"header\": {\n \"sellerId\": 980000001,\n \"version\": \"2.0\"\n },\n \"messages\": [\n {\n \"messageId\": 1,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Gabinet doktora Caligari DVD\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"45.00\",\n \"currency\": \"PLN\"\n },\n \"stock\": 3,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 2,\n \"sku\": \"FILM-21ef85-6\",\n \"operationType\": \"UPDATE\",\n \"requirements\": \"LISTING\",\n \"attributes\": {\n \"name\": \"Nosferatu DVD wydanie specjalne\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 5,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n },\n {\n \"messageId\": 3,\n \"sku\": \"FILM-21ef85-5\",\n \"operationType\": \"PARTIAL_UPDATE\",\n \"attributes\": {\n \"price\": {\n \"amount\": \"41.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 15\n }\n }\n ]\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/feeds\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getFeeds", "summary": "Lista wsadów", "tags": [ "Wsady (feeds)" ], "description": "Wsady tej aplikacji (klucza) u sprzedawcy, najnowsze pierwsze.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Feeds — getFeeds.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "processingStatuses", "in": "query", "required": false, "description": "Statusy rozdzielone przecinkiem: IN_QUEUE, IN_PROGRESS, DONE, CANCELLED, FATAL.", "schema": { "type": "string" } }, { "name": "pageSize", "in": "query", "required": false, "description": "1–100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 } }, { "name": "nextToken", "in": "query", "required": false, "description": "Token następnej strony.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wsady.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/FeedList" }, "example": { "feeds": [ { "feedId": "9be12e3a-f19a-4295-8542-b7392a657fcd", "feedType": "JSON_LISTINGS_FEED", "marketplaceIds": [ "allee-pl" ], "createdTime": "2026-11-10T11:10:04.568Z", "processingStatus": "CANCELLED", "processingStartTime": null, "processingEndTime": "2026-11-10T11:10:04.570Z", "resultFeedDocumentId": null, "allee": { "source": "INLINE", "messages": { "total": 1, "processed": 0, "accepted": 0, "invalid": 0, "withWarnings": 0 }, "fatalError": null } }, { "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49", "feedType": "JSON_LISTINGS_FEED", "marketplaceIds": [ "allee-pl" ], "createdTime": "2026-11-10T11:10:04.563Z", "processingStatus": "DONE", "processingStartTime": "2026-11-10T11:10:04.617Z", "processingEndTime": "2026-11-10T11:10:04.709Z", "resultFeedDocumentId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49", "allee": { "source": "INLINE", "messages": { "total": 3, "processed": 3, "accepted": 3, "invalid": 0, "withWarnings": 0 }, "fatalError": null } } ], "nextToken": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/FeedList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Feeds — getFeeds", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/feeds (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/feeds (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/feeds (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/feeds (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/feeds (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/feeds?processingStatuses=DONE%2CCANCELLED&pageSize=10\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/feeds/documents": { "post": { "operationId": "createFeedDocument", "summary": "Miejsce wgrania dokumentu wsadu", "tags": [ "Wsady (feeds)" ], "description": "Dla wsadów większych niż chcesz wysłać w treści żądania: podpisany adres PUT (5 min, do 10 MB) — wgraj dokument JSON wprost do magazynu, potem `POST /allee/feeds` z `inputFeedDocumentId`. W sandboxie → 403 `SANDBOX_UNSUPPORTED` (wysyłaj `content`).\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Feeds — createFeedDocument.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "contentType": { "type": "string", "enum": [ "application/json" ] } }, "required": [ "contentType" ] } }, "application/json": { "schema": { "type": "object", "properties": { "contentType": { "type": "string", "enum": [ "application/json" ] } }, "required": [ "contentType" ] } } } }, "responses": { "201": { "description": "Miejsce wgrania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/FeedDocumentUpload" }, "example": { "feedDocumentId": "aac1646a-866c-4baa-9f1c-b9cbbf6f8d35", "method": "PUT", "url": "https://0e31a0c8a001f9f8df521110ca4f3f6e.r2.cloudflarestorage.com/allee/api-feeds/980000001/aac1646a-866c-4baa-9f1c-b9cbbf6f8d35.json?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=0136e1e8b4bd3d8e11870c33177d2879%2F20261110%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20261110T111005Z&X-Amz-Expires=300&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Signature=…", "headers": { "Content-Type": "application/json" }, "expiresAt": "2026-11-10T11:15:05.000Z", "maxBytes": 10485760 } }, "application/json": { "schema": { "$ref": "#/components/schemas/FeedDocumentUpload" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `SANDBOX_UNSUPPORTED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`, `STORAGE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Feeds — createFeedDocument", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "SANDBOX_UNSUPPORTED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" }, { "status": 503, "code": "STORAGE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/documents\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"contentType\": \"application/json\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'application/json',\n];\n$ch = curl_init($base . '/allee/feeds/documents');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/feeds/documents (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"contentType\": \"application/json\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/feeds/documents\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/feeds/documents (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"contentType\": \"application/json\"\n};\nconst res = await fetch(`${BASE}/allee/feeds/documents`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/feeds/documents (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/feeds/documents\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"contentType\": \"application/json\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/feeds/documents (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"contentType\": \"application/json\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/feeds/documents\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/feeds/documents (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"contentType\": \"application/json\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/feeds/documents\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/feeds/{feedId}": { "get": { "operationId": "getFeed", "summary": "Wsad", "tags": [ "Wsady (feeds)" ], "description": "Stan i liczniki wsadu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Feeds — getFeed.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "feedId", "in": "path", "required": true, "description": "Identyfikator wsadu.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Wsad.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Feed" }, "example": { "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49", "feedType": "JSON_LISTINGS_FEED", "marketplaceIds": [ "allee-pl" ], "createdTime": "2026-11-10T11:10:04.563Z", "processingStatus": "IN_QUEUE", "processingStartTime": null, "processingEndTime": null, "resultFeedDocumentId": null, "allee": { "source": "INLINE", "messages": { "total": 3, "processed": 0, "accepted": 0, "invalid": 0, "withWarnings": 0 }, "fatalError": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Feed" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Feeds — getFeed", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "cancelFeed", "summary": "Anulowanie wsadu", "tags": [ "Wsady (feeds)" ], "description": "Tylko wsad w kolejce (`IN_QUEUE`); inaczej 409 `FEED_NOT_CANCELLABLE` z bieżącym statusem w `details`.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Feeds — cancelFeed.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "feedId", "in": "path", "required": true, "description": "Identyfikator wsadu.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Anulowano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Feed" }, "example": { "feedId": "9be12e3a-f19a-4295-8542-b7392a657fcd", "feedType": "JSON_LISTINGS_FEED", "marketplaceIds": [ "allee-pl" ], "createdTime": "2026-11-10T11:10:04.568Z", "processingStatus": "CANCELLED", "processingStartTime": null, "processingEndTime": "2026-11-10T11:10:04.570Z", "resultFeedDocumentId": null, "allee": { "source": "INLINE", "messages": { "total": 1, "processed": 0, "accepted": 0, "invalid": 0, "withWarnings": 0 }, "fatalError": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Feed" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `FEED_NOT_CANCELLABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Feeds — cancelFeed", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "FEED_NOT_CANCELLABLE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/allee/feeds/9be12e3a-f19a-4295-8542-b7392a657fcd\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/feeds/{feedId}/result": { "get": { "operationId": "getFeedResult", "summary": "Raport przetwarzania wsadu", "tags": [ "Wsady (feeds)" ], "description": "Po `DONE`/`FATAL`: podsumowanie, problemy z numerem komunikatu i wynik każdego komunikatu (oferta, zmiana, issues). Wcześniej → 409 `FEED_NOT_FINISHED`.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Feeds — processing report (JSON).\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "feedId", "in": "path", "required": true, "description": "Identyfikator wsadu.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Raport.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/FeedResult" }, "example": { "header": { "sellerId": "980000001", "feedId": "8abb06e8-6e07-4bbb-b0d7-7fda5882df49", "version": "2.0" }, "issues": [], "summary": { "errors": 0, "warnings": 0, "messagesProcessed": 3, "messagesAccepted": 3, "messagesInvalid": 0 }, "allee": { "processingStatus": "DONE", "fatalError": null, "results": [ { "messageId": 1, "sku": "FILM-21ef85-5", "offerId": "900000000000026", "status": "ACCEPTED", "change": "CREATED", "issues": [] }, { "messageId": 2, "sku": "FILM-21ef85-6", "offerId": "900000000000027", "status": "ACCEPTED", "change": "CREATED", "issues": [] }, { "messageId": 3, "sku": "FILM-21ef85-5", "offerId": "900000000000026", "status": "ACCEPTED", "change": "UPDATED", "issues": [] } ] } } }, "application/json": { "schema": { "$ref": "#/components/schemas/FeedResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `FEED_NOT_FINISHED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Feeds — processing report (JSON)", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "FEED_NOT_FINISHED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/feeds/8abb06e8-6e07-4bbb-b0d7-7fda5882df49/result\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/fees/estimate": { "post": { "operationId": "getMyFeesEstimates", "summary": "Wyceny opłat (wsadowo)", "tags": [ "Opłaty" ], "description": "Do 20 wycen w jednym żądaniu: dla oferty (`idType: OFFER_ID`), SKU (`SKU`) albo nowej oferty (`NEW`). Błąd jednej wyceny nie psuje pozostałych (`status: CLIENT_ERROR`).\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Product Fees — getMyFeesEstimates.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "feesEstimateRequests": { "type": "array", "items": { "type": "object", "properties": { "identifier": { "type": "string", "description": "Twój identyfikator wyceny (wraca w odpowiedzi)." }, "idType": { "type": "string", "enum": [ "OFFER_ID", "SKU", "NEW" ] }, "idValue": { "type": "string", "description": "Id oferty albo SKU." }, "price": { "$ref": "#/components/schemas/MoneyInput" }, "quantity": { "type": "integer" }, "sellingFormat": { "type": "string", "enum": [ "BUY_NOW" ] } } }, "minItems": 1, "maxItems": 20 } }, "required": [ "feesEstimateRequests" ] } }, "application/json": { "schema": { "type": "object", "properties": { "feesEstimateRequests": { "type": "array", "items": { "type": "object", "properties": { "identifier": { "type": "string", "description": "Twój identyfikator wyceny (wraca w odpowiedzi)." }, "idType": { "type": "string", "enum": [ "OFFER_ID", "SKU", "NEW" ] }, "idValue": { "type": "string", "description": "Id oferty albo SKU." }, "price": { "$ref": "#/components/schemas/MoneyInput" }, "quantity": { "type": "integer" }, "sellingFormat": { "type": "string", "enum": [ "BUY_NOW" ] } } }, "minItems": 1, "maxItems": 20 } }, "required": [ "feesEstimateRequests" ] } } } }, "responses": { "200": { "description": "Wyceny.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/FeesEstimateResult" }, "example": { "feesEstimates": [ { "identifier": "moja-oferta", "status": "SUCCESS", "totalFees": { "amount": "0.00", "currency": "PLN" }, "feeDetails": [ { "feeType": "LISTING_FEE", "feeAmount": { "amount": "0.00", "currency": "PLN" } }, { "feeType": "SUCCESS_COMMISSION", "feeAmount": { "amount": "0.00", "currency": "PLN" } } ], "error": null }, { "identifier": "nowa-oferta", "status": "SUCCESS", "totalFees": { "amount": "0.00", "currency": "PLN" }, "feeDetails": [ { "feeType": "LISTING_FEE", "feeAmount": { "amount": "0.00", "currency": "PLN" } }, { "feeType": "SUCCESS_COMMISSION", "feeAmount": { "amount": "0.00", "currency": "PLN" } } ], "error": null } ], "feeScheduleVersion": "2026-11-09" } }, "application/json": { "schema": { "$ref": "#/components/schemas/FeesEstimateResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Product Fees — getMyFeesEstimates", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/fees/estimate\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"feesEstimateRequests\": [\n {\n \"identifier\": \"moja-oferta\",\n \"idType\": \"SKU\",\n \"idValue\": \"FILM-21ef85-1\",\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"identifier\": \"nowa-oferta\",\n \"idType\": \"NEW\",\n \"price\": {\n \"amount\": \"199.00\",\n \"currency\": \"PLN\"\n },\n \"quantity\": 1\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n [\n 'identifier' => 'moja-oferta',\n 'idType' => 'SKU',\n 'idValue' => 'FILM-21ef85-1',\n 'price' => [\n 'amount' => '39.90',\n 'currency' => 'PLN',\n ],\n ],\n [\n 'identifier' => 'nowa-oferta',\n 'idType' => 'NEW',\n 'price' => [\n 'amount' => '199.00',\n 'currency' => 'PLN',\n ],\n 'quantity' => 1,\n ],\n ],\n];\n$ch = curl_init($base . '/allee/fees/estimate');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/fees/estimate (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"feesEstimateRequests\": [\n {\n \"identifier\": \"moja-oferta\",\n \"idType\": \"SKU\",\n \"idValue\": \"FILM-21ef85-1\",\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\",\n },\n },\n {\n \"identifier\": \"nowa-oferta\",\n \"idType\": \"NEW\",\n \"price\": {\n \"amount\": \"199.00\",\n \"currency\": \"PLN\",\n },\n \"quantity\": 1,\n },\n ],\n}\nr = requests.request(\"POST\", BASE + \"/allee/fees/estimate\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/fees/estimate (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"feesEstimateRequests\": [\n {\n \"identifier\": \"moja-oferta\",\n \"idType\": \"SKU\",\n \"idValue\": \"FILM-21ef85-1\",\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"identifier\": \"nowa-oferta\",\n \"idType\": \"NEW\",\n \"price\": {\n \"amount\": \"199.00\",\n \"currency\": \"PLN\"\n },\n \"quantity\": 1\n }\n ]\n};\nconst res = await fetch(`${BASE}/allee/fees/estimate`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/fees/estimate (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/fees/estimate\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"feesEstimateRequests\": [\n {\n \"identifier\": \"moja-oferta\",\n \"idType\": \"SKU\",\n \"idValue\": \"FILM-21ef85-1\",\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"identifier\": \"nowa-oferta\",\n \"idType\": \"NEW\",\n \"price\": {\n \"amount\": \"199.00\",\n \"currency\": \"PLN\"\n },\n \"quantity\": 1\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/fees/estimate (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"feesEstimateRequests\": [\n {\n \"identifier\": \"moja-oferta\",\n \"idType\": \"SKU\",\n \"idValue\": \"FILM-21ef85-1\",\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"identifier\": \"nowa-oferta\",\n \"idType\": \"NEW\",\n \"price\": {\n \"amount\": \"199.00\",\n \"currency\": \"PLN\"\n },\n \"quantity\": 1\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/fees/estimate\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/fees/estimate (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"feesEstimateRequests\": [\n {\n \"identifier\": \"moja-oferta\",\n \"idType\": \"SKU\",\n \"idValue\": \"FILM-21ef85-1\",\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"identifier\": \"nowa-oferta\",\n \"idType\": \"NEW\",\n \"price\": {\n \"amount\": \"199.00\",\n \"currency\": \"PLN\"\n },\n \"quantity\": 1\n }\n ]\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/fees/estimate\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/listings": { "get": { "operationId": "searchListingsItems", "summary": "Wyszukiwanie listingów", "tags": [ "Listingi (SKU)" ], "description": "Oferty z SKU, filtrowane po SKU, statusie i problemach (np. wszystkie z błędami: `issueSeverity=ERROR`).\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Listings Items — searchListingsItems.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "skus", "in": "query", "required": false, "description": "SKU rozdzielone przecinkiem (do 100).", "schema": { "type": "string" } }, { "name": "status", "in": "query", "required": false, "description": "Statusy publikacji rozdzielone przecinkiem (INACTIVE, ACTIVATING, ACTIVE, ENDED).", "schema": { "type": "string" } }, { "name": "issueSeverity", "in": "query", "required": false, "description": "ERROR i/lub WARNING — tylko listingi z takimi problemami.", "schema": { "type": "string" } }, { "name": "includedData", "in": "query", "required": false, "description": "Sekcje rozdzielone przecinkiem: summaries, attributes, issues, offers, fulfillmentAvailability.", "schema": { "type": "string", "default": "summaries" } }, { "name": "pageSize", "in": "query", "required": false, "description": "1–100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "pageToken", "in": "query", "required": false, "description": "Token następnej strony (pagination.nextToken).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Listingi.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSearchResult" }, "example": { "numberOfResults": 2, "pagination": { "nextToken": null }, "items": [ { "sku": "FILM-21ef85-1", "summaries": [ { "marketplaceId": "allee-pl", "offerId": "900000000000021", "category": { "alleeId": 35, "id": "20585" }, "status": [ "DISCOVERABLE", "BUYABLE" ], "publicationStatus": "ACTIVE", "itemName": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "conditionType": "new_new", "createdDate": "2026-11-10T11:10:03.000Z", "lastUpdatedDate": "2026-11-10T11:10:04.000Z", "mainImage": { "link": "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021" } ], "issues": [] }, { "sku": "FILM-21ef85-3", "summaries": [ { "marketplaceId": "allee-pl", "offerId": "900000000000024", "category": { "alleeId": 35, "id": "20585" }, "status": [ "DISCOVERABLE", "BUYABLE" ], "publicationStatus": "ACTIVE", "itemName": "Metropolis DVD wersja odrestaurowana", "conditionType": "new_new", "createdDate": "2026-11-10T11:10:04.000Z", "lastUpdatedDate": "2026-11-10T11:10:04.000Z", "mainImage": { "link": "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" }, "url": "https://allee.pl/oferta/metropolis-dvd-wersja-odrestaurowana-900000000000024" } ], "issues": [] } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSearchResult" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Listings Items — searchListingsItems", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/listings?skus=FILM-21ef85-1%2CFILM-21ef85-3&includedData=summaries%2Cissues&pageSize=20\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/listings (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/listings?skus=FILM-21ef85-1%2CFILM-21ef85-3&includedData=summaries%2Cissues&pageSize=20\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/listings (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/listings?skus=FILM-21ef85-1%2CFILM-21ef85-3&includedData=summaries%2Cissues&pageSize=20`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/listings (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/listings?skus=FILM-21ef85-1%2CFILM-21ef85-3&includedData=summaries%2Cissues&pageSize=20\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/listings (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/listings?skus=FILM-21ef85-1%2CFILM-21ef85-3&includedData=summaries%2Cissues&pageSize=20\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/listings (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/listings?skus=FILM-21ef85-1%2CFILM-21ef85-3&includedData=summaries%2Cissues&pageSize=20\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/listings/{sku}": { "get": { "operationId": "getListingsItem", "summary": "Listing po SKU", "tags": [ "Listingi (SKU)" ], "description": "Oferta po SKU w wybranych sekcjach. `issues` = problemy liczone z tych samych reguł co walidacja i panel Jakość.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Listings Items — getListingsItem.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "sku", "in": "path", "required": true, "description": "SKU (external.id): 1–100 znaków, bez „/” i znaków sterujących. W adresie zakoduj (np. spacja → %20).", "schema": { "type": "string" } }, { "name": "includedData", "in": "query", "required": false, "description": "Sekcje rozdzielone przecinkiem: summaries, attributes, issues, offers, fulfillmentAvailability.", "schema": { "type": "string", "default": "summaries" } } ], "responses": { "200": { "description": "Listing.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingItem" }, "example": { "sku": "FILM-21ef85-3", "summaries": [ { "marketplaceId": "allee-pl", "offerId": "900000000000024", "category": { "alleeId": 35, "id": "20585" }, "status": [ "DISCOVERABLE", "BUYABLE" ], "publicationStatus": "ACTIVE", "itemName": "Metropolis DVD wersja odrestaurowana", "conditionType": "new_new", "createdDate": "2026-11-10T11:10:04.000Z", "lastUpdatedDate": "2026-11-10T11:10:04.000Z", "mainImage": { "link": "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" }, "url": "https://allee.pl/oferta/metropolis-dvd-wersja-odrestaurowana-900000000000024" } ], "attributes": { "name": "Metropolis DVD wersja odrestaurowana", "category": { "alleeId": 35, "id": "20585" }, "parameters": { "246845": { "valuesIds": [ "246845_622165" ] }, "250077": { "valuesIds": [ "250077_1797493" ] }, "225693": { "values": [ "5901234123464" ] }, "237218": { "values": [ "Metropolis" ] }, "11323": { "valuesIds": [ "11323_1" ] } }, "images": [ "https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp" ], "description": "Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.", "price": { "amount": "59.90", "currency": "PLN" }, "stock": 4, "shippingRatesId": "797d2e65-cb23-4a16-98e9-d6f2a399839a", "responsibleProducerId": "472bad66-e704-4344-a2d6-9bd85b1f9a5e", "safetyInformation": { "type": "TEXT", "description": "Produkt bezpieczny w normalnym użytkowaniu." } }, "issues": [], "offers": [ { "marketplaceId": "allee-pl", "offerType": "B2C", "price": { "amount": "59.90", "currency": "PLN" }, "sellingFormat": "BUY_NOW" } ], "fulfillmentAvailability": [ { "fulfillmentChannelCode": "DEFAULT", "quantity": 4, "handlingTime": null } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingItem" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Listings Items — getListingsItem", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/listings/FILM-21ef85-3?includedData=summaries%2Cattributes%2Cissues%2Coffers%2CfulfillmentAvailability\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/listings/FILM-21ef85-3 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/listings/FILM-21ef85-3?includedData=summaries%2Cattributes%2Cissues%2Coffers%2CfulfillmentAvailability\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/listings/FILM-21ef85-3 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/listings/FILM-21ef85-3?includedData=summaries%2Cattributes%2Cissues%2Coffers%2CfulfillmentAvailability`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/listings/FILM-21ef85-3 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/listings/FILM-21ef85-3?includedData=summaries%2Cattributes%2Cissues%2Coffers%2CfulfillmentAvailability\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/listings/FILM-21ef85-3 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/listings/FILM-21ef85-3?includedData=summaries%2Cattributes%2Cissues%2Coffers%2CfulfillmentAvailability\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/listings/FILM-21ef85-3 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/listings/FILM-21ef85-3?includedData=summaries%2Cattributes%2Cissues%2Coffers%2CfulfillmentAvailability\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "putListingsItem", "summary": "Utworzenie albo zastąpienie oferty po SKU", "tags": [ "Listingi (SKU)" ], "description": "Idempotentne po SKU: brak oferty → tworzy (**201**), jest → zastępuje (**200**, `change: UPDATED` albo `UNCHANGED`). Atrybuty płaskie, nazwy jak w schemacie kategorii.\n\nBłędy nie przerywają w połowie: odpowiedź **422** ma `status: INVALID`, pełną listę `issues[]` (kod, ważność, atrybuty) i te same błędy w kształcie Allegro (`errors[]`). Z `?mode=VALIDATION_PREVIEW` nic nie zapisujemy — sprawdzasz dokument przed wysłaniem.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Listings Items — putListingsItem.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "sku", "in": "path", "required": true, "description": "SKU (external.id): 1–100 znaków, bez „/” i znaków sterujących. W adresie zakoduj (np. spacja → %20).", "schema": { "type": "string" } }, { "name": "mode", "in": "query", "required": false, "description": "VALIDATION_PREVIEW = pełna walidacja bez zapisu (odpowiedź 200, status VALID/INVALID).", "schema": { "type": "string", "enum": [ "VALIDATION_PREVIEW" ] } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingPutRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingPutRequest" } } } }, "responses": { "200": { "description": "Zastąpiono / bez zmian / podgląd.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" }, "example": { "sku": "FILM-21ef85-3", "status": "VALID", "submissionId": "813685289be61f68", "offerId": null, "change": null, "publicationStatus": null, "issues": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } } } }, "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" }, "example": { "sku": "FILM-21ef85-3", "status": "ACCEPTED", "submissionId": "703bc87433a98c12", "offerId": "900000000000024", "change": "CREATED", "publicationStatus": "ACTIVE", "issues": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "INVALID — nic nie zapisano. Kody błędów: `JsonMappingException`, `UnknownJSONProperty`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Listings Items — putListingsItem", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/allee/listings/FILM-21ef85-3\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"requirements\": \"LISTING\",\n \"status\": \"ACTIVE\",\n \"attributes\": {\n \"name\": \"Metropolis DVD wersja odrestaurowana\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"59.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 4,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'LISTING',\n 'status' => 'ACTIVE',\n 'attributes' => [\n 'name' => 'Metropolis DVD wersja odrestaurowana',\n 'category' => [\n 'alleeId' => 35,\n ],\n 'parameters' => [\n '225693' => [\n 'values' => [\n '5901234123464',\n ],\n ],\n '237218' => [\n 'values' => [\n 'Metropolis',\n ],\n ],\n '246845' => [\n 'valuesIds' => [\n '246845_622165',\n ],\n ],\n '250077' => [\n 'valuesIds' => [\n '250077_1797493',\n ],\n ],\n '11323' => [\n 'valuesIds' => [\n '11323_1',\n ],\n ],\n ],\n 'price' => [\n 'amount' => '59.90',\n 'currency' => 'PLN',\n ],\n 'stock' => 4,\n 'images' => [\n 'https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp',\n ],\n 'description' => 'Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.',\n 'shippingRatesId' => '797d2e65-cb23-4a16-98e9-d6f2a399839a',\n 'responsibleProducerId' => '472bad66-e704-4344-a2d6-9bd85b1f9a5e',\n 'safetyInformation' => [\n 'type' => 'TEXT',\n 'description' => 'Produkt bezpieczny w normalnym użytkowaniu.',\n ],\n ],\n];\n$ch = curl_init($base . '/allee/listings/FILM-21ef85-3');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /allee/listings/FILM-21ef85-3 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"requirements\": \"LISTING\",\n \"status\": \"ACTIVE\",\n \"attributes\": {\n \"name\": \"Metropolis DVD wersja odrestaurowana\",\n \"category\": {\n \"alleeId\": 35,\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\",\n ],\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\",\n ],\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\",\n ],\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\",\n ],\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\",\n ],\n },\n },\n \"price\": {\n \"amount\": \"59.90\",\n \"currency\": \"PLN\",\n },\n \"stock\": 4,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\",\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\",\n },\n },\n}\nr = requests.request(\"PUT\", BASE + \"/allee/listings/FILM-21ef85-3\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /allee/listings/FILM-21ef85-3 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"requirements\": \"LISTING\",\n \"status\": \"ACTIVE\",\n \"attributes\": {\n \"name\": \"Metropolis DVD wersja odrestaurowana\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"59.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 4,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n};\nconst res = await fetch(`${BASE}/allee/listings/FILM-21ef85-3`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /allee/listings/FILM-21ef85-3 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/allee/listings/FILM-21ef85-3\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"requirements\": \"LISTING\",\n \"status\": \"ACTIVE\",\n \"attributes\": {\n \"name\": \"Metropolis DVD wersja odrestaurowana\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"59.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 4,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /allee/listings/FILM-21ef85-3 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"requirements\": \"LISTING\",\n \"status\": \"ACTIVE\",\n \"attributes\": {\n \"name\": \"Metropolis DVD wersja odrestaurowana\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"59.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 4,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/listings/FILM-21ef85-3\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /allee/listings/FILM-21ef85-3 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"requirements\": \"LISTING\",\n \"status\": \"ACTIVE\",\n \"attributes\": {\n \"name\": \"Metropolis DVD wersja odrestaurowana\",\n \"category\": {\n \"alleeId\": 35\n },\n \"parameters\": {\n \"225693\": {\n \"values\": [\n \"5901234123464\"\n ]\n },\n \"237218\": {\n \"values\": [\n \"Metropolis\"\n ]\n },\n \"246845\": {\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n \"250077\": {\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n },\n \"11323\": {\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n },\n \"price\": {\n \"amount\": \"59.90\",\n \"currency\": \"PLN\"\n },\n \"stock\": 4,\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ],\n \"description\": \"Film na płycie DVD, nowy w folii. Wersja z polskimi napisami.\",\n \"shippingRatesId\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n \"responsibleProducerId\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu.\"\n }\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/allee/listings/FILM-21ef85-3\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "patch": { "operationId": "patchListingsItem", "summary": "Częściowa zmiana oferty po SKU (JSON Patch)", "tags": [ "Listingi (SKU)" ], "description": "Zmiany `replace` / `add` / `delete` na `/attributes/{nazwa}` (np. `/attributes/price`, `/attributes/stock`). Zmiana tylko ceny i stanu idzie szybką ścieżką.\n\nZły dokument JSON Patch → 400. Nieistniejące SKU → 404. `?mode=VALIDATION_PREVIEW` — podgląd bez zapisu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Listings Items — patchListingsItem.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "sku", "in": "path", "required": true, "description": "SKU (external.id): 1–100 znaków, bez „/” i znaków sterujących. W adresie zakoduj (np. spacja → %20).", "schema": { "type": "string" } }, { "name": "mode", "in": "query", "required": false, "description": "VALIDATION_PREVIEW = pełna walidacja bez zapisu (odpowiedź 200, status VALID/INVALID).", "schema": { "type": "string", "enum": [ "VALIDATION_PREVIEW" ] } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingPatchRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingPatchRequest" } } } }, "responses": { "200": { "description": "Zmieniono (albo podgląd).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" }, "example": { "sku": "FILM-21ef85-3", "status": "ACCEPTED", "submissionId": "3840cf94b7276dc2", "offerId": "900000000000024", "change": "UPDATED", "publicationStatus": "ACTIVE", "issues": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "INVALID. Kody błędów: `JsonMappingException`, `UnknownJSONProperty`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Listings Items — patchListingsItem", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PATCH \"${ALLEE_API_URL:-https://api.allee.pl}/allee/listings/FILM-21ef85-3\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"patches\": [\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/price\",\n \"value\": {\n \"amount\": \"54.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/stock\",\n \"value\": 6\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n [\n 'op' => 'replace',\n 'path' => '/attributes/price',\n 'value' => [\n 'amount' => '54.90',\n 'currency' => 'PLN',\n ],\n ],\n [\n 'op' => 'replace',\n 'path' => '/attributes/stock',\n 'value' => 6,\n ],\n ],\n];\n$ch = curl_init($base . '/allee/listings/FILM-21ef85-3');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PATCH',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PATCH /allee/listings/FILM-21ef85-3 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"patches\": [\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/price\",\n \"value\": {\n \"amount\": \"54.90\",\n \"currency\": \"PLN\",\n },\n },\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/stock\",\n \"value\": 6,\n },\n ],\n}\nr = requests.request(\"PATCH\", BASE + \"/allee/listings/FILM-21ef85-3\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PATCH /allee/listings/FILM-21ef85-3 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"patches\": [\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/price\",\n \"value\": {\n \"amount\": \"54.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/stock\",\n \"value\": 6\n }\n ]\n};\nconst res = await fetch(`${BASE}/allee/listings/FILM-21ef85-3`, {\n method: \"PATCH\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PATCH /allee/listings/FILM-21ef85-3 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PATCH\"), baseUrl + \"/allee/listings/FILM-21ef85-3\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"patches\": [\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/price\",\n \"value\": {\n \"amount\": \"54.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/stock\",\n \"value\": 6\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PATCH /allee/listings/FILM-21ef85-3 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"patches\": [\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/price\",\n \"value\": {\n \"amount\": \"54.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/stock\",\n \"value\": 6\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/listings/FILM-21ef85-3\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PATCH\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PATCH /allee/listings/FILM-21ef85-3 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"patches\": [\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/price\",\n \"value\": {\n \"amount\": \"54.90\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"op\": \"replace\",\n \"path\": \"/attributes/stock\",\n \"value\": 6\n }\n ]\n}`\n\treq, err := http.NewRequest(\"PATCH\", base+\"/allee/listings/FILM-21ef85-3\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteListingsItem", "summary": "Usunięcie albo zakończenie oferty po SKU", "tags": [ "Listingi (SKU)" ], "description": "Szkic nigdy nieopublikowany → usunięty (`change: DELETED`). Oferta opublikowana → zakończona (`change: ENDED`; historia sprzedaży zostaje). `?mode=VALIDATION_PREVIEW` — nic nie zmienia.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Listings Items — deleteListingsItem.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "sku", "in": "path", "required": true, "description": "SKU (external.id): 1–100 znaków, bez „/” i znaków sterujących. W adresie zakoduj (np. spacja → %20).", "schema": { "type": "string" } }, { "name": "mode", "in": "query", "required": false, "description": "VALIDATION_PREVIEW = pełna walidacja bez zapisu (odpowiedź 200, status VALID/INVALID).", "schema": { "type": "string", "enum": [ "VALIDATION_PREVIEW" ] } } ], "responses": { "200": { "description": "Usunięto / zakończono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" }, "example": { "sku": "FILM-21ef85-4", "status": "ACCEPTED", "submissionId": "e06fa881ccf8a1a7", "offerId": "900000000000025", "change": "DELETED", "publicationStatus": null, "issues": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ListingSubmissionResponse" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Listings Items — deleteListingsItem", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/allee/listings/FILM-21ef85-4\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /allee/listings/FILM-21ef85-4 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/allee/listings/FILM-21ef85-4\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /allee/listings/FILM-21ef85-4 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/listings/FILM-21ef85-4`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /allee/listings/FILM-21ef85-4 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/allee/listings/FILM-21ef85-4\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /allee/listings/FILM-21ef85-4 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/listings/FILM-21ef85-4\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /allee/listings/FILM-21ef85-4 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/allee/listings/FILM-21ef85-4\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notices": { "get": { "operationId": "getNotices", "summary": "Zgłoszenia nielegalnych treści (DSA)", "tags": [ "Zgodność sprzedawcy" ], "description": "Zgłoszenia dotyczące ofert i sklepu sprzedawcy, najnowsze pierwsze: kategoria, uzasadnienie zgłaszającego, stan (`NOWE`, `W_TOKU`, `ZASADNE`, `NIEZASADNE`), stanowisko sprzedawcy i numer decyzji. **Bez danych zgłaszającego.**\n\nNowe zgłoszenie = webhook `OFFER_NOTICE_RECEIVED`.\n\n**Zgodność:** tylko allee — — (DSA art. 16).\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji.", "schema": { "type": "integer", "description": "1–100, domyślnie 50." } }, { "name": "offset", "in": "query", "required": false, "description": "Przesunięcie.", "schema": { "type": "integer", "description": "Domyślnie 0." } } ], "responses": { "200": { "description": "Zgłoszenia.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/NoticeList" }, "example": { "notices": [ { "id": "DSA-2026-000001", "offerId": "900000000000021", "subject": "OFERTA", "url": "https://allee.pl/oferta/-900000000000021", "category": "PODROBKA", "categoryLabel": "Podróbka (fałszywy znak towarowy)", "explanation": "Logo na zdjęciach wygląda na podrobione, a cena jest dużo niższa niż u autoryzowanych sprzedawców.", "status": "NOWE", "trustedFlagger": false, "createdAt": "2026-11-10T11:10:03.000Z", "sellerResponse": null, "decisionId": null } ], "limit": 50, "offset": 0 } }, "application/json": { "schema": { "$ref": "#/components/schemas/NoticeList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "— (DSA art. 16)", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notices\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notices (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notices\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notices (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notices`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notices (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notices\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notices (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notices\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notices (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notices\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notices/{id}/response": { "post": { "operationId": "respondToNotice", "summary": "Stanowisko sprzedawcy do zgłoszenia", "tags": [ "Zgodność sprzedawcy" ], "description": "Przed decyzją allee sprzedawca może wyjaśnić, dlaczego treść jest zgodna z prawem (np. faktura od dystrybutora, licencja). Tylko zgłoszenia w stanie `NOWE` albo `W_TOKU`; po decyzji → 409 (odwołaj się od decyzji).\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Numer zgłoszenia.", "schema": { "type": "string", "examples": [ "DSA-2026-000001" ] } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/TextInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/TextInput" } } } }, "responses": { "200": { "description": "Zgłoszenie ze stanowiskiem.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Notice" }, "example": { "id": "DSA-2026-000001", "offerId": "900000000000021", "subject": "OFERTA", "url": "https://allee.pl/oferta/-900000000000021", "category": "PODROBKA", "categoryLabel": "Podróbka (fałszywy znak towarowy)", "explanation": "Logo na zdjęciach wygląda na podrobione, a cena jest dużo niższa niż u autoryzowanych sprzedawców.", "status": "W_TOKU", "trustedFlagger": false, "createdAt": "2026-11-10T11:10:03.000Z", "sellerResponse": { "text": "Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.", "respondedAt": "2026-11-10T11:10:03.000Z", "channel": "API" }, "decisionId": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/Notice" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notices/DSA-2026-000001/response\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"text\": \"Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.',\n];\n$ch = curl_init($base . '/allee/notices/DSA-2026-000001/response');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notices/DSA-2026-000001/response (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"text\": \"Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notices/DSA-2026-000001/response\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notices/DSA-2026-000001/response (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"text\": \"Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.\"\n};\nconst res = await fetch(`${BASE}/allee/notices/DSA-2026-000001/response`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notices/DSA-2026-000001/response (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notices/DSA-2026-000001/response\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"text\": \"Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notices/DSA-2026-000001/response (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"text\": \"Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notices/DSA-2026-000001/response\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notices/DSA-2026-000001/response (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"text\": \"Produkt pochodzi od autoryzowanego dystrybutora — faktura FV/2026/11/123.\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notices/DSA-2026-000001/response\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/deliveries": { "get": { "operationId": "getDeliveries", "summary": "Dziennik dostaw powiadomień", "tags": [ "Powiadomienia push" ], "description": "Dostawy z 30 dni: status, liczba prób, ostatni kod HTTP i błąd, następna próba.\n\n**Zgodność:** tylko allee — Stripe: dziennik zdarzeń webhooków.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "maximum": 10000, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–100, domyślnie 50).", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "status", "in": "query", "required": false, "description": "Status.", "schema": { "type": "string", "enum": [ "PENDING", "RETRYING", "DELIVERED", "FAILED", "CANCELLED" ] } }, { "name": "destinationId", "in": "query", "required": false, "description": "Destynacja.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Dostawy.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DeliveryList" }, "example": { "deliveries": [ { "deliveryId": "1", "notificationId": "6faf3bfa-1b81-426b-a722-5054b196920e", "notificationType": "TEST_NOTIFICATION", "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "status": "DELIVERED", "attempts": 1, "lastHttpStatus": 200, "lastDurationMs": 0, "lastError": null, "createdAt": "2026-11-10T11:10:05.588Z", "nextAttemptAt": null, "deliveredAt": "2026-11-10T11:10:05.588Z" } ], "totalCount": 1, "count": 1 } }, "application/json": { "schema": { "$ref": "#/components/schemas/DeliveryList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Stripe: dziennik zdarzeń webhooków", "limitGroup": "read", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/deliveries?destinationId=b24ba1c2-f3d2-4872-8c7a-9df3c560f76d&limit=20\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notifications/deliveries (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notifications/deliveries?destinationId=b24ba1c2-f3d2-4872-8c7a-9df3c560f76d&limit=20\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notifications/deliveries (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/deliveries?destinationId=b24ba1c2-f3d2-4872-8c7a-9df3c560f76d&limit=20`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notifications/deliveries (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notifications/deliveries?destinationId=b24ba1c2-f3d2-4872-8c7a-9df3c560f76d&limit=20\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notifications/deliveries (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/deliveries?destinationId=b24ba1c2-f3d2-4872-8c7a-9df3c560f76d&limit=20\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notifications/deliveries (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notifications/deliveries?destinationId=b24ba1c2-f3d2-4872-8c7a-9df3c560f76d&limit=20\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/destinations": { "post": { "operationId": "createDestination", "summary": "Nowa destynacja (adres webhooka)", "tags": [ "Powiadomienia push" ], "description": "Adres https Twojego serwera. Przy zakładaniu wysyłamy `DESTINATION_VERIFICATION` z `payload.challenge` — odpowiedz 2xx i `{\"challenge\": \"…\"}`. Adres: port 443, publiczny IP, bez przekierowań (ochrona SSRF).\n\nOdpowiedź zawiera `secret` (`allee_whsec_…`) **tylko raz** — zapisz go; służy do sprawdzania podpisu `Allee-Signature`.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — createDestination.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DestinationInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/DestinationInput" } } } }, "responses": { "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DestinationCreated" }, "example": { "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "name": "Serwer sklepu", "url": "https://sklep.example.com/allee/webhook", "status": "ACTIVE", "disabledReason": null, "secretLast4": "M5KD", "previousSecretExpiresAt": null, "verifiedAt": "2026-11-10T11:10:05.000Z", "createdAt": "2026-11-10T11:10:05.000Z", "lastSuccessAt": null, "lastFailureAt": null, "consecutiveFailures": 0, "subscriptions": [], "application": "API", "secret": "{secret}" } }, "application/json": { "schema": { "$ref": "#/components/schemas/DestinationCreated" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `DESTINATION_LIMIT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `DESTINATION_REDIRECT`, `DESTINATION_URL_INVALID`, `DESTINATION_VERIFICATION_FAILED`, `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — createDestination", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "DESTINATION_LIMIT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "DESTINATION_REDIRECT" }, { "status": 422, "code": "DESTINATION_URL_INVALID" }, { "status": 422, "code": "DESTINATION_VERIFICATION_FAILED" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Serwer sklepu\",\n \"url\": \"https://sklep.example.com/allee/webhook\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Serwer sklepu',\n 'url' => 'https://sklep.example.com/allee/webhook',\n];\n$ch = curl_init($base . '/allee/notifications/destinations');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notifications/destinations (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Serwer sklepu\",\n \"url\": \"https://sklep.example.com/allee/webhook\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notifications/destinations\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notifications/destinations (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Serwer sklepu\",\n \"url\": \"https://sklep.example.com/allee/webhook\"\n};\nconst res = await fetch(`${BASE}/allee/notifications/destinations`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notifications/destinations (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notifications/destinations\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Serwer sklepu\",\n \"url\": \"https://sklep.example.com/allee/webhook\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notifications/destinations (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Serwer sklepu\",\n \"url\": \"https://sklep.example.com/allee/webhook\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notifications/destinations (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Serwer sklepu\",\n \"url\": \"https://sklep.example.com/allee/webhook\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notifications/destinations\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getDestinations", "summary": "Destynacje", "tags": [ "Powiadomienia push" ], "description": "Destynacje tej aplikacji (klucza) u sprzedawcy. Bez sekretów.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — getDestinations.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Destynacje.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DestinationList" }, "example": { "destinations": [ { "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "name": "Serwer sklepu", "url": "https://sklep.example.com/allee/webhook", "status": "ACTIVE", "disabledReason": null, "secretLast4": "M5KD", "previousSecretExpiresAt": null, "verifiedAt": "2026-11-10T11:10:05.000Z", "createdAt": "2026-11-10T11:10:05.000Z", "lastSuccessAt": null, "lastFailureAt": null, "consecutiveFailures": 0, "subscriptions": [], "application": "API", "applicationName": "Klucze osobiste — sklep_przykladowy_0e60e9" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/DestinationList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — getDestinations", "limitGroup": "read", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notifications/destinations (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notifications/destinations\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notifications/destinations (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/destinations`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notifications/destinations (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notifications/destinations\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notifications/destinations (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notifications/destinations (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notifications/destinations\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/destinations/{destinationId}": { "get": { "operationId": "getDestination", "summary": "Destynacja", "tags": [ "Powiadomienia push" ], "description": "Destynacja z listą subskrypcji.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — getDestination.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "destinationId", "in": "path", "required": true, "description": "Identyfikator destynacji.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Destynacja.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Destination" }, "example": { "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "name": "Serwer sklepu", "url": "https://sklep.example.com/allee/webhook", "status": "ACTIVE", "disabledReason": null, "secretLast4": "M5KD", "previousSecretExpiresAt": null, "verifiedAt": "2026-11-10T11:10:05.000Z", "createdAt": "2026-11-10T11:10:05.000Z", "lastSuccessAt": null, "lastFailureAt": null, "consecutiveFailures": 0, "subscriptions": [], "application": "API" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Destination" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — getDestination", "limitGroup": "read", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteDestination", "summary": "Usunięcie destynacji", "tags": [ "Powiadomienia push" ], "description": "Razem z jej subskrypcjami; oczekujące dostawy są anulowane.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — deleteDestination.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "destinationId", "in": "path", "required": true, "description": "Identyfikator destynacji.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — deleteDestination", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/destinations/{destinationId}/disable": { "post": { "operationId": "disableDestination", "summary": "Wyłączenie destynacji", "tags": [ "Powiadomienia push" ], "description": "Wstrzymuje wysyłkę (subskrypcje zostają).\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "destinationId", "in": "path", "required": true, "description": "Identyfikator destynacji.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Destynacja.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Destination" }, "example": { "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "name": "Serwer sklepu", "url": "https://sklep.example.com/allee/webhook", "status": "DISABLED", "disabledReason": "Wyłączona przez aplikację", "secretLast4": "vP35", "previousSecretExpiresAt": "2026-11-11T11:10:05.000Z", "verifiedAt": "2026-11-10T11:10:05.000Z", "createdAt": "2026-11-10T11:10:05.000Z", "lastSuccessAt": null, "lastFailureAt": null, "consecutiveFailures": 0, "subscriptions": [], "application": "API" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Destination" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/disable\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/destinations/{destinationId}/enable": { "post": { "operationId": "enableDestination", "summary": "Włączenie destynacji", "tags": [ "Powiadomienia push" ], "description": "Wznawia wysyłkę (np. po automatycznym wyłączeniu po 24 h nieudanych ponowień).\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "destinationId", "in": "path", "required": true, "description": "Identyfikator destynacji.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Destynacja.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Destination" }, "example": { "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "name": "Serwer sklepu", "url": "https://sklep.example.com/allee/webhook", "status": "ACTIVE", "disabledReason": null, "secretLast4": "vP35", "previousSecretExpiresAt": "2026-11-11T11:10:05.000Z", "verifiedAt": "2026-11-10T11:10:05.000Z", "createdAt": "2026-11-10T11:10:05.000Z", "lastSuccessAt": null, "lastFailureAt": null, "consecutiveFailures": 0, "subscriptions": [], "application": "API" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Destination" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/enable\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/destinations/{destinationId}/rotate-secret": { "post": { "operationId": "rotateDestinationSecret", "summary": "Nowy sekret podpisu", "tags": [ "Powiadomienia push" ], "description": "Nowy sekret (pokazany raz). Przez okno `previousSecretExpiresIn` (0, 1h, 24h, 7d) podpisujemy oboma sekretami — nagłówek ma wtedy dwa `v1=`, więc możesz wymienić sekret bez przerwy.\n\n**Zgodność:** tylko allee — Stripe: rotacja sekretu webhooka.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "destinationId", "in": "path", "required": true, "description": "Identyfikator destynacji.", "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "previousSecretExpiresIn": { "type": "string", "enum": [ "0", "1h", "24h", "7d" ], "default": "24h" } } } }, "application/json": { "schema": { "type": "object", "properties": { "previousSecretExpiresIn": { "type": "string", "enum": [ "0", "1h", "24h", "7d" ], "default": "24h" } } } } } }, "responses": { "200": { "description": "Nowy sekret.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SecretRotation" }, "example": { "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "previousSecretExpiresAt": "2026-11-11T11:10:05.000Z", "secret": "{secret}" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SecretRotation" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Stripe: rotacja sekretu webhooka", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"previousSecretExpiresIn\": \"24h\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " '24h',\n];\n$ch = curl_init($base . '/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"previousSecretExpiresIn\": \"24h\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"previousSecretExpiresIn\": \"24h\"\n};\nconst res = await fetch(`${BASE}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"previousSecretExpiresIn\": \"24h\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"previousSecretExpiresIn\": \"24h\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"previousSecretExpiresIn\": \"24h\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/rotate-secret\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/destinations/{destinationId}/test": { "post": { "operationId": "testDestination", "summary": "Powiadomienie testowe", "tags": [ "Powiadomienia push" ], "description": "Wysyła od razu `TEST_NOTIFICATION` (podpisane) i zwraca wynik dostarczenia (kod HTTP Twojego serwera, czas).\n\n**Zgodność:** tylko allee — Stripe: „Send test webhook”.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "destinationId", "in": "path", "required": true, "description": "Identyfikator destynacji.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Wynik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DestinationTestResult" }, "example": { "notificationId": "6faf3bfa-1b81-426b-a722-5054b196920e", "delivered": true, "httpStatus": 200, "durationMs": 0, "error": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/DestinationTestResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `DESTINATION_DISABLED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Stripe: „Send test webhook”", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "DESTINATION_DISABLED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notifications/destinations/b24ba1c2-f3d2-4872-8c7a-9df3c560f76d/test\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/subscriptions": { "get": { "operationId": "getSubscriptions", "summary": "Subskrypcje", "tags": [ "Powiadomienia push" ], "description": "Subskrypcje tej aplikacji (klucza) u sprzedawcy.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — getSubscription (wszystkie).\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Subskrypcje.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SubscriptionList" }, "example": { "subscriptions": [ { "subscriptionId": "3c260023-6f73-4036-97cb-49b45a7ad683", "notificationType": "ORDER_CHANGE", "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "status": "ACTIVE", "createdAt": "2026-11-10T11:10:05.000Z" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — getSubscription (wszystkie)", "limitGroup": "read", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/subscriptions\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notifications/subscriptions (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notifications/subscriptions\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notifications/subscriptions (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/subscriptions`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notifications/subscriptions (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notifications/subscriptions\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notifications/subscriptions (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/subscriptions\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notifications/subscriptions (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notifications/subscriptions\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/subscriptions/{notificationType}": { "post": { "operationId": "createSubscription", "summary": "Subskrypcja typu powiadomień", "tags": [ "Powiadomienia push" ], "description": "Jedna subskrypcja na typ (druga → 409). Wymaga zakresu `notifications` i zakresu danych typu (np. ORDER_CHANGE → orders:read).\n\nDostarczanie: POST JSON z nagłówkami `Allee-Signature`, `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`; Twój serwer odpowiada 2xx w 5 s. Ponowienia wykładnicze do 24 h, potem destynacja jest wyłączana.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — createSubscription.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "notificationType", "in": "path", "required": true, "description": "Typ powiadomienia (GET /allee/notifications/types).", "schema": { "type": "string", "enum": [ "ORDER_CHANGE", "OFFER_STATUS_CHANGE", "OFFER_ISSUES_CHANGE", "MESSAGE_RECEIVED", "RETURN_CHANGE", "ISSUE_CHANGE", "FEED_PROCESSING_FINISHED", "REPORT_PROCESSING_FINISHED", "API_KEY_SECURITY_EVENT", "SELLER_COMPLIANCE_CHANGED", "OFFER_NOTICE_RECEIVED", "OFFER_RESTRICTED" ] } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SubscriptionInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SubscriptionInput" } } } }, "responses": { "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Subscription" }, "example": { "subscriptionId": "3c260023-6f73-4036-97cb-49b45a7ad683", "notificationType": "ORDER_CHANGE", "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "status": "ACTIVE", "createdAt": "2026-11-10T11:10:05.000Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Subscription" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `SUBSCRIPTION_EXISTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `DESTINATION_NOT_FOUND`, `JsonMappingException`, `UnknownJSONProperty`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — createSubscription", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "SUBSCRIPTION_EXISTS" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "DESTINATION_NOT_FOUND" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/subscriptions/ORDER_CHANGE\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"destinationId\": \"b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'b24ba1c2-f3d2-4872-8c7a-9df3c560f76d',\n];\n$ch = curl_init($base . '/allee/notifications/subscriptions/ORDER_CHANGE');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/notifications/subscriptions/ORDER_CHANGE (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"destinationId\": \"b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/notifications/subscriptions/ORDER_CHANGE\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/notifications/subscriptions/ORDER_CHANGE (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"destinationId\": \"b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"\n};\nconst res = await fetch(`${BASE}/allee/notifications/subscriptions/ORDER_CHANGE`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/notifications/subscriptions/ORDER_CHANGE (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/notifications/subscriptions/ORDER_CHANGE\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"destinationId\": \"b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/notifications/subscriptions/ORDER_CHANGE (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"destinationId\": \"b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/subscriptions/ORDER_CHANGE\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/notifications/subscriptions/ORDER_CHANGE (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"destinationId\": \"b24ba1c2-f3d2-4872-8c7a-9df3c560f76d\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/notifications/subscriptions/ORDER_CHANGE\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getSubscription", "summary": "Subskrypcja", "tags": [ "Powiadomienia push" ], "description": "Subskrypcja wskazanego typu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — getSubscription.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "notificationType", "in": "path", "required": true, "description": "Typ powiadomienia (GET /allee/notifications/types).", "schema": { "type": "string", "enum": [ "ORDER_CHANGE", "OFFER_STATUS_CHANGE", "OFFER_ISSUES_CHANGE", "MESSAGE_RECEIVED", "RETURN_CHANGE", "ISSUE_CHANGE", "FEED_PROCESSING_FINISHED", "REPORT_PROCESSING_FINISHED", "API_KEY_SECURITY_EVENT", "SELLER_COMPLIANCE_CHANGED", "OFFER_NOTICE_RECEIVED", "OFFER_RESTRICTED" ] } } ], "responses": { "200": { "description": "Subskrypcja.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Subscription" }, "example": { "subscriptionId": "3c260023-6f73-4036-97cb-49b45a7ad683", "notificationType": "ORDER_CHANGE", "destinationId": "b24ba1c2-f3d2-4872-8c7a-9df3c560f76d", "status": "ACTIVE", "createdAt": "2026-11-10T11:10:05.000Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Subscription" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — getSubscription", "limitGroup": "read", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/subscriptions/ORDER_CHANGE\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notifications/subscriptions/ORDER_CHANGE (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notifications/subscriptions/ORDER_CHANGE\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notifications/subscriptions/ORDER_CHANGE (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/subscriptions/ORDER_CHANGE`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notifications/subscriptions/ORDER_CHANGE (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notifications/subscriptions/ORDER_CHANGE\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notifications/subscriptions/ORDER_CHANGE (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/subscriptions/ORDER_CHANGE\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notifications/subscriptions/ORDER_CHANGE (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notifications/subscriptions/ORDER_CHANGE\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteSubscription", "summary": "Usunięcie subskrypcji", "tags": [ "Powiadomienia push" ], "description": "Koniec powiadomień tego typu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — deleteSubscriptionById.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "notificationType", "in": "path", "required": true, "description": "Typ powiadomienia (GET /allee/notifications/types).", "schema": { "type": "string", "enum": [ "ORDER_CHANGE", "OFFER_STATUS_CHANGE", "OFFER_ISSUES_CHANGE", "MESSAGE_RECEIVED", "RETURN_CHANGE", "ISSUE_CHANGE", "FEED_PROCESSING_FINISHED", "REPORT_PROCESSING_FINISHED", "API_KEY_SECURITY_EVENT", "SELLER_COMPLIANCE_CHANGED", "OFFER_NOTICE_RECEIVED", "OFFER_RESTRICTED" ] } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — deleteSubscriptionById", "limitGroup": "write", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/subscriptions/ORDER_CHANGE\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /allee/notifications/subscriptions/ORDER_CHANGE (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/allee/notifications/subscriptions/ORDER_CHANGE\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /allee/notifications/subscriptions/ORDER_CHANGE (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/subscriptions/ORDER_CHANGE`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /allee/notifications/subscriptions/ORDER_CHANGE (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/allee/notifications/subscriptions/ORDER_CHANGE\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /allee/notifications/subscriptions/ORDER_CHANGE (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/subscriptions/ORDER_CHANGE\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /allee/notifications/subscriptions/ORDER_CHANGE (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/allee/notifications/subscriptions/ORDER_CHANGE\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/notifications/types": { "get": { "operationId": "getNotificationTypes", "summary": "Typy powiadomień", "tags": [ "Powiadomienia push" ], "description": "Typy, opisy, wymagane zakresy i format podpisu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Notifications — typy.\n**Uprawnienie:** zakres `allee:api:notifications`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Typy.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/NotificationTypeList" }, "example": { "notificationTypes": [ { "notificationType": "ORDER_CHANGE", "description": "Zmiana zamówienia: nowe zamówienie, realizacja, płatność, przesyłka", "requiredScopes": [ "allee:api:notifications", "allegro:api:orders:read" ] }, { "notificationType": "OFFER_STATUS_CHANGE", "description": "Zmiana statusu oferty: aktywacja, zakończenie", "requiredScopes": [ "allee:api:notifications", "allegro:api:sale:offers:read" ] }, { "notificationType": "OFFER_ISSUES_CHANGE", "description": "Nowe problemy oferty: nieudane zdjęcia, zakończenie przez moderację", "requiredScopes": [ "allee:api:notifications", "allegro:api:sale:offers:read" ] }, { "notificationType": "MESSAGE_RECEIVED", "description": "Nowa wiadomość od kupującego", "requiredScopes": [ "allee:api:notifications", "allegro:api:messaging:read" ] }, { "notificationType": "RETURN_CHANGE", "description": "Zwrot: zgłoszenie i każda zmiana statusu", "requiredScopes": [ "allee:api:notifications", "allegro:api:orders:read" ] }, { "notificationType": "ISSUE_CHANGE", "description": "Reklamacja lub dyskusja: otwarcie, termin, zamknięcie", "requiredScopes": [ "allee:api:notifications", "allegro:api:disputes:read" ] }, { "notificationType": "FEED_PROCESSING_FINISHED", "description": "Wsad ofert przetworzony", "requiredScopes": [ "allee:api:notifications", "allegro:api:sale:offers:write" ] }, { "notificationType": "REPORT_PROCESSING_FINISHED", "description": "Raport gotowy do pobrania", "requiredScopes": [ "allee:api:notifications", "allee:api:reports" ] }, { "notificationType": "API_KEY_SECURITY_EVENT", "description": "Zdarzenie bezpieczeństwa klucza lub aplikacji (np. kwarantanna, nowa sieć)", "requiredScopes": [ "allee:api:notifications" ] }, { "notificationType": "OFFER_NOTICE_RECEIVED", "description": "Zgłoszenie nielegalnej treści dotyczące oferty lub sklepu (DSA art. 16) — Z3, includes/dsa.php", "requiredScopes": [ "allee:api:notifications", "allegro:api:sale:offers:read" ] }, { "notificationType": "OFFER_RESTRICTED", "description": "Decyzja allee wobec oferty lub konta z uzasadnieniem (DSA art. 17) — Z3, includes/dsa.php", "requiredScopes": [ "allee:api:notifications", "allegro:api:sale:offers:read" ] }, { "notificationType": "SELLER_COMPLIANCE_CHANGED", "description": "Zmiana zgodności sprzedawcy: status, braki danych, oświadczenia, blokady (Z1, includes/sp/zgodnosc.php)", "requiredScopes": [ "allee:api:notifications", "allegro:api:profile:read" ] } ], "signature": { "header": "Allee-Signature", "format": "t=,v1=", "toleranceSeconds": 300 } } }, "application/json": { "schema": { "$ref": "#/components/schemas/NotificationTypeList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:notifications" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Notifications — typy", "limitGroup": "read", "scope": "allee:api:notifications", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/notifications/types\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/notifications/types (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/notifications/types\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/notifications/types (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/notifications/types`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/notifications/types (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/notifications/types\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/notifications/types (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/notifications/types\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/notifications/types (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/notifications/types\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/report-documents/{reportDocumentId}/file": { "get": { "operationId": "downloadReportDocument", "summary": "Pobranie pliku raportu (podpisany link)", "tags": [ "Raporty" ], "description": "Adres z `GET /allee/reports/{id}/document` — **bez tokenu**. Po terminie → 403 `LINK_EXPIRED_OR_INVALID`. Treść: gzip (CSV albo JSON). Link z sandboxu ma dodatkowo `mode=test` (objęte podpisem) — pobierasz go tak samo; nie zmieniaj parametrów adresu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — pobranie dokumentu raportu z url.\n**Uwierzytelnienie:** podpis w adresie (link ważny 5 minut) — bez tokenu.", "parameters": [ { "name": "reportDocumentId", "in": "path", "required": true, "description": "Identyfikator dokumentu.", "schema": { "type": "string", "format": "uuid" } }, { "name": "expires", "in": "query", "required": true, "description": "Z podpisanego adresu.", "schema": { "type": "string" } }, { "name": "mode", "in": "query", "required": false, "description": "Z podpisanego adresu — tylko linki z sandboxu (objęte podpisem).", "schema": { "type": "string", "enum": [ "test" ] } }, { "name": "signature", "in": "query", "required": true, "description": "Z podpisanego adresu.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Plik gzip (Content-Disposition: attachment).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/gzip": { "schema": { "type": "string", "format": "binary" } } } }, "403": { "description": "Brak uprawnień. Kody: `LINK_EXPIRED_OR_INVALID`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `STORAGE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: pobranie dokumentu raportu z url", "limitGroup": "read", "errors": [ { "status": 403, "code": "LINK_EXPIRED_OR_INVALID" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "STORAGE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…\" \\\n -H \"Accept: application/gzip\" \\\n -o raport.csv.gz -w 'HTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/gzip',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\n$kod = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);\nif ($kod === 200) file_put_contents('raport.csv.gz', $odp);\necho 'HTTP ', $kod, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/gzip\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…\", headers=headers, timeout=60, allow_redirects=False)\nif r.status_code == 200:\n with open(\"raport.csv.gz\", \"wb\") as f:\n f.write(r.content)\nprint(\"HTTP\", r.status_code)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file (Node.js 18+, wbudowany fetch; plik .mjs)\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…`, {\n method: \"GET\",\n headers: {\n \"Accept\": \"application/gzip\",\n },\n redirect: \"manual\",\n});\nif (res.status === 200) await writeFile(\"raport.csv.gz\", Buffer.from(await res.arrayBuffer()));\nconsole.log(\"HTTP\", res.status);\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…\");\nreq.Headers.Accept.ParseAdd(\"application/gzip\");\nusing var res = await http.SendAsync(req);\nif ((int)res.StatusCode == 200) File.WriteAllBytes(\"raport.csv.gz\", await res.Content.ReadAsByteArrayAsync());\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.file.Path;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…\"))\n .header(\"Accept\", \"application/gzip\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofFile(Path.of(\"raport.csv.gz\")));\n System.out.println(\"HTTP \" + res.statusCode());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"application/gzip\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tif res.StatusCode == 200 {\n\t\tf, err := os.Create(\"raport.csv.gz\")\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t\tdefer f.Close()\n\t\tif _, err := f.ReadFrom(res.Body); err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n}\n" } ] } }, "/allee/reports": { "post": { "operationId": "createReport", "summary": "Zamówienie raportu", "tags": [ "Raporty" ], "description": "Raport przygotowywany w tle (CSV albo JSON, gzip). Typy i potrzebne zakresy: `OFFERS_ALL`, `OFFERS_ISSUES` (sale:offers:read), `ORDERS_BY_DATE`, `RETURNS` (orders:read + obsługa zamówień), `BILLING_ENTRIES` (billing:read), `API_USAGE` (tylko reports).\n\nOkres domyślnie 30 dni, najwyżej 92. Dane osobowe kupujących tylko z `allee:api:orders:pii`. Do 5 raportów w kolejce. Koniec: `GET /allee/reports/{id}` albo powiadomienie `REPORT_PROCESSING_FINISHED`.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Reports — createReport.\n**Uprawnienie:** zakres `allee:api:reports`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CreateReportRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CreateReportRequest" } } } }, "responses": { "202": { "description": "Przyjęto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Report" }, "example": { "reportId": "75a25ea7-2e91-4f0b-9042-a3c733f9a492", "reportType": "OFFERS_ALL", "marketplaceIds": [ "allee-pl" ], "dataStartTime": null, "dataEndTime": null, "createdTime": "2026-11-10T11:10:05.616Z", "processingStatus": "IN_QUEUE", "processingStartTime": null, "processingEndTime": null, "reportDocumentId": null, "allee": { "format": "CSV", "rows": null, "personalData": false, "documentExpiresAt": null, "error": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Report" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:reports" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Reports — createReport", "limitGroup": "bulk", "scope": "allee:api:reports", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/reports\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"reportType\": \"OFFERS_ALL\",\n \"reportOptions\": {\n \"format\": \"CSV\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'OFFERS_ALL',\n 'reportOptions' => [\n 'format' => 'CSV',\n ],\n];\n$ch = curl_init($base . '/allee/reports');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/reports (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"reportType\": \"OFFERS_ALL\",\n \"reportOptions\": {\n \"format\": \"CSV\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/allee/reports\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/reports (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"reportType\": \"OFFERS_ALL\",\n \"reportOptions\": {\n \"format\": \"CSV\"\n }\n};\nconst res = await fetch(`${BASE}/allee/reports`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/reports (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/reports\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"reportType\": \"OFFERS_ALL\",\n \"reportOptions\": {\n \"format\": \"CSV\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/reports (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"reportType\": \"OFFERS_ALL\",\n \"reportOptions\": {\n \"format\": \"CSV\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/reports\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/reports (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"reportType\": \"OFFERS_ALL\",\n \"reportOptions\": {\n \"format\": \"CSV\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/reports\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getReports", "summary": "Lista raportów", "tags": [ "Raporty" ], "description": "Raporty tej aplikacji (klucza) u sprzedawcy, najnowsze pierwsze.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Reports — getReports.\n**Uprawnienie:** zakres `allee:api:reports`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "reportTypes", "in": "query", "required": false, "description": "Typy rozdzielone przecinkiem.", "schema": { "type": "string" } }, { "name": "processingStatuses", "in": "query", "required": false, "description": "Statusy rozdzielone przecinkiem.", "schema": { "type": "string" } }, { "name": "pageSize", "in": "query", "required": false, "description": "1–100.", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 10 } }, { "name": "nextToken", "in": "query", "required": false, "description": "Token następnej strony.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Raporty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReportList" }, "example": { "reports": [ { "reportId": "75a25ea7-2e91-4f0b-9042-a3c733f9a492", "reportType": "OFFERS_ALL", "marketplaceIds": [ "allee-pl" ], "dataStartTime": null, "dataEndTime": null, "createdTime": "2026-11-10T11:10:05.616Z", "processingStatus": "DONE", "processingStartTime": "2026-11-10T11:10:05.664Z", "processingEndTime": "2026-11-10T11:10:05.669Z", "reportDocumentId": "a6c80abf-5393-43af-b634-b9ec56eae431", "allee": { "format": "CSV", "rows": 25, "personalData": false, "documentExpiresAt": "2026-11-17T11:10:05.000Z", "error": null } } ], "nextToken": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReportList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:reports" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Reports — getReports", "limitGroup": "read", "scope": "allee:api:reports", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/reports?reportTypes=OFFERS_ALL&pageSize=10\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/reports (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/reports?reportTypes=OFFERS_ALL&pageSize=10\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/reports (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/reports?reportTypes=OFFERS_ALL&pageSize=10`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/reports (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/reports?reportTypes=OFFERS_ALL&pageSize=10\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/reports (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/reports?reportTypes=OFFERS_ALL&pageSize=10\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/reports (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/reports?reportTypes=OFFERS_ALL&pageSize=10\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/reports/{reportId}": { "get": { "operationId": "getReport", "summary": "Raport", "tags": [ "Raporty" ], "description": "Stan raportu.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Reports — getReport.\n**Uprawnienie:** zakres `allee:api:reports`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Identyfikator raportu.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Raport.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Report" }, "example": { "reportId": "75a25ea7-2e91-4f0b-9042-a3c733f9a492", "reportType": "OFFERS_ALL", "marketplaceIds": [ "allee-pl" ], "dataStartTime": null, "dataEndTime": null, "createdTime": "2026-11-10T11:10:05.616Z", "processingStatus": "IN_QUEUE", "processingStartTime": null, "processingEndTime": null, "reportDocumentId": null, "allee": { "format": "CSV", "rows": null, "personalData": false, "documentExpiresAt": null, "error": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Report" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:reports" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Reports — getReport", "limitGroup": "read", "scope": "allee:api:reports", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "cancelReport", "summary": "Anulowanie raportu", "tags": [ "Raporty" ], "description": "Tylko raport w kolejce (`IN_QUEUE`), inaczej 409.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Reports — cancelReport.\n**Uprawnienie:** zakres `allee:api:reports`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Identyfikator raportu.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Anulowano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Report" }, "example": { "reportId": "ee5a5bf7-694e-44bc-9900-05135ea9cf0c", "reportType": "ORDERS_BY_DATE", "marketplaceIds": [ "allee-pl" ], "dataStartTime": "2026-11-03T00:00:00.000Z", "dataEndTime": "2026-11-10T11:10:05.000Z", "createdTime": "2026-11-10T11:10:05.621Z", "processingStatus": "CANCELLED", "processingStartTime": null, "processingEndTime": "2026-11-10T11:10:05.624Z", "reportDocumentId": null, "allee": { "format": "JSON", "rows": null, "personalData": true, "documentExpiresAt": null, "error": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Report" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `REPORT_NOT_CANCELLABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:reports" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Reports — cancelReport", "limitGroup": "write", "scope": "allee:api:reports", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "REPORT_NOT_CANCELLABLE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/allee/reports/ee5a5bf7-694e-44bc-9900-05135ea9cf0c\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/reports/{reportId}/document": { "get": { "operationId": "getReportDocument", "summary": "Adres pobrania raportu", "tags": [ "Raporty" ], "description": "Podpisany adres pliku (ważny 5 min, bez tokenu), plik w gzip. Raport z danymi osobowymi pobierze tylko dostęp z `allee:api:orders:pii`. Dokument jest usuwany po 7 dniach (410).\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Reports — getReportDocument.\n**Uprawnienie:** zakres `allee:api:reports`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "reportId", "in": "path", "required": true, "description": "Identyfikator raportu.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Adres.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ReportDocument" }, "example": { "reportDocumentId": "a6c80abf-5393-43af-b634-b9ec56eae431", "url": "https://api.allee.pl/allee/report-documents/a6c80abf-5393-43af-b634-b9ec56eae431/file?expires=1794309305&mode=test&signature=…", "compressionAlgorithm": "GZIP", "contentType": "text/csv", "expiresAt": "2026-11-10T11:15:05Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ReportDocument" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `REPORT_NOT_READY`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "410": { "description": "Zasób usunięty. Kody: `DOCUMENT_EXPIRED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allee:api:reports" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Reports — getReportDocument", "limitGroup": "read", "scope": "allee:api:reports", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "REPORT_NOT_READY" }, { "status": 410, "code": "DOCUMENT_EXPIRED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/reports/75a25ea7-2e91-4f0b-9042-a3c733f9a492/document\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sandbox": { "get": { "operationId": "getSandbox", "summary": "Konto demo (sandbox)", "tags": [ "Sandbox" ], "description": "Przy pierwszym żądaniu klucza testowego powstaje konto demo: 20 aktywnych ofert, cennik, warunki, GPSR i kupujący demo. Tu dostajesz ich identyfikatory — gotowe do przykładów.\n\nDziała **wyłącznie kluczem testowym** (`allee_sk_test_…`) — klucz produkcyjny dostaje 403 `SANDBOX_ONLY`. Dane są fikcyjne i oddzielone od produkcji (osobna baza); odpowiedzi mają nagłówek `X-Allee-Mode: test`.\n\n**Zgodność:** tylko allee — static sandbox (wariant prosty).\n**Uprawnienie:** dowolny ważny token lub klucz.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Konto demo.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SandboxSummary" }, "example": { "mode": "test", "seller": { "id": "980000001" }, "buyer": { "id": "4000000001" }, "createdAt": "2026-11-10T11:10:02.000Z", "dataVersion": 1, "offers": { "active": 20, "total": 20, "sampleOfferId": "900000000000001" }, "shippingRates": { "id": "154985df-0580-4e6e-91a3-7b23608beb41" }, "returnPolicy": { "id": "42133d83-0ba2-472e-9f21-25f2c35b69e4" }, "impliedWarranty": { "id": "eab748ba-c9ec-444f-8f18-eb3b4174ebca" }, "warranty": { "id": "e0b5c0de-c9d1-4be5-a5be-595e95db67ad" }, "responsibleProducer": { "id": "e157086a-a704-46a9-8922-770c82c9a7d6" }, "responsiblePerson": { "id": "30c5cc4a-ff63-4507-8c9c-e9410008b8f0" }, "simulator": { "orders": "POST /allee/sandbox/orders", "returns": "POST /allee/sandbox/returns", "messages": "POST /allee/sandbox/messages" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/SandboxSummary" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `SANDBOX_ONLY`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "Amazon SP-API: static sandbox (wariant prosty)", "limitGroup": "read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "SANDBOX_ONLY" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sandbox\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/sandbox (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/sandbox\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/sandbox (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/sandbox`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/sandbox (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/sandbox\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/sandbox (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sandbox\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/sandbox (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/sandbox\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sandbox/messages": { "post": { "operationId": "createSandboxMessage", "summary": "Symulacja wiadomości kupującego", "tags": [ "Sandbox" ], "description": "Pytanie kupującego demo o ofertę (`offerId`) albo wiadomość w sprawie zamówienia (`checkoutFormId`). Zakres `messaging`.\n\nDziała **wyłącznie kluczem testowym** (`allee_sk_test_…`) — klucz produkcyjny dostaje 403 `SANDBOX_ONLY`. Dane są fikcyjne i oddzielone od produkcji (osobna baza); odpowiedzi mają nagłówek `X-Allee-Mode: test`.\n\n**Zgodność:** tylko allee — Allegro sandbox: wiadomość testowa.\n**Uprawnienie:** zakres `allegro:api:messaging`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SandboxMessageInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SandboxMessageInput" } } } }, "responses": { "201": { "description": "Wiadomość.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SandboxMessageCreated" }, "example": { "thread": { "id": "900000001" }, "message": { "id": "900000001" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/SandboxMessageCreated" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `SANDBOX_ONLY`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro sandbox: wiadomość testowa", "limitGroup": "write", "scope": "allegro:api:messaging", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "SANDBOX_ONLY" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sandbox/messages\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"offerId\": \"900000000000021\",\n \"text\": \"Czy płyta ma polski lektor?\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " '900000000000021',\n 'text' => 'Czy płyta ma polski lektor?',\n];\n$ch = curl_init($base . '/allee/sandbox/messages');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/sandbox/messages (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"offerId\": \"900000000000021\",\n \"text\": \"Czy płyta ma polski lektor?\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/sandbox/messages\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/sandbox/messages (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"offerId\": \"900000000000021\",\n \"text\": \"Czy płyta ma polski lektor?\"\n};\nconst res = await fetch(`${BASE}/allee/sandbox/messages`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/sandbox/messages (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/sandbox/messages\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"offerId\": \"900000000000021\",\n \"text\": \"Czy płyta ma polski lektor?\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/sandbox/messages (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"offerId\": \"900000000000021\",\n \"text\": \"Czy płyta ma polski lektor?\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sandbox/messages\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/sandbox/messages (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"offerId\": \"900000000000021\",\n \"text\": \"Czy płyta ma polski lektor?\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/sandbox/messages\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sandbox/orders": { "post": { "operationId": "createSandboxOrder", "summary": "Symulacja zamówienia kupującego", "tags": [ "Sandbox" ], "description": "Kupujący demo kupuje Twoją ofertę z sandboxu. Zamówienie pojawia się w `/order/checkout-forms`, `/order/events` i w powiadomieniach `ORDER_CHANGE`. Zakres `orders:write`.\n\nDziała **wyłącznie kluczem testowym** (`allee_sk_test_…`) — klucz produkcyjny dostaje 403 `SANDBOX_ONLY`. Dane są fikcyjne i oddzielone od produkcji (osobna baza); odpowiedzi mają nagłówek `X-Allee-Mode: test`.\n\n**Zgodność:** tylko allee — Allegro sandbox: zamówienie testowe.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SandboxOrderInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SandboxOrderInput" } } } }, "responses": { "201": { "description": "Zamówienie (jak GET /order/checkout-forms/{id}).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Location": { "$ref": "#/components/headers/Location" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CheckoutForm" }, "example": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "status": "READY_FOR_PROCESSING", "updatedAt": "2026-11-10T11:10:05.412Z", "revision": "3", "marketplace": { "id": "allee-pl" }, "messageToSeller": "Proszę o staranne zapakowanie.", "buyer": { "id": "4000000001", "email": "kupujacy-980000001-4816f227@example.invalid", "login": "kupujacy_demo_4816f227", "firstName": null, "lastName": null, "companyName": "Firma Przykładowa", "phoneNumber": "+48 500 000 000", "guest": false }, "payment": { "id": "sandbox-9ba7f15b-69a9-43f0-96dd-6fa7cfffc7cc", "type": "ONLINE", "provider": "SANDBOX", "finishedAt": "2026-11-10T11:10:05.000Z", "paidAmount": { "amount": "98.79", "currency": "PLN" } }, "fulfillment": { "status": "NEW", "shipmentSummary": { "lineItemsSent": "NONE" } }, "delivery": { "method": { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f", "name": "InPost Paczkomat 24/7" }, "address": { "firstName": "Jan", "lastName": "Przykładowy", "street": "ul. Przykładowa 1", "city": "Warszawa", "zipCode": "00-001", "countryCode": "PL", "companyName": "Firma Przykładowa", "phoneNumber": "+48 500 000 000" }, "pickupPoint": null, "cost": { "amount": "12.99", "currency": "PLN" }, "time": null, "smart": false, "calculatedNumberOfPackages": 1 }, "invoice": { "required": true, "address": { "street": null, "city": null, "zipCode": null, "countryCode": null, "company": { "name": "Firma Przykładowa", "taxId": "1234563218" } } }, "lineItems": [ { "id": "2d9680b4-9cb7-4096-9428-8c1ceb2790c2", "offer": { "id": "900000000000021", "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "external": { "id": "FILM-21ef85-1" } }, "quantity": 2, "originalPrice": { "amount": "44.90", "currency": "PLN" }, "price": { "amount": "42.90", "currency": "PLN" }, "tax": { "rate": "23.00" }, "boughtAt": "2026-11-10T11:10:05.411Z" } ], "summary": { "totalToPay": { "amount": "98.79", "currency": "PLN" } }, "allee": { "test": false, "commission": { "amount": "0.00", "currency": "PLN", "rate": "0.00", "base": "PRODUCTS", "final": true, "priceListVersion": "2026-11-09" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutForm" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `SANDBOX_ONLY`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `DELIVERY_METHOD_NOT_FOUND`, `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro sandbox: zamówienie testowe", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "SANDBOX_ONLY" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "DELIVERY_METHOD_NOT_FOUND" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sandbox/orders\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"offerId\": \"900000000000021\",\n \"quantity\": 2,\n \"paymentType\": \"ONLINE\",\n \"invoice\": true,\n \"messageToSeller\": \"Proszę o staranne zapakowanie.\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " '900000000000021',\n 'quantity' => 2,\n 'paymentType' => 'ONLINE',\n 'invoice' => true,\n 'messageToSeller' => 'Proszę o staranne zapakowanie.',\n];\n$ch = curl_init($base . '/allee/sandbox/orders');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/sandbox/orders (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"offerId\": \"900000000000021\",\n \"quantity\": 2,\n \"paymentType\": \"ONLINE\",\n \"invoice\": True,\n \"messageToSeller\": \"Proszę o staranne zapakowanie.\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/sandbox/orders\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/sandbox/orders (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"offerId\": \"900000000000021\",\n \"quantity\": 2,\n \"paymentType\": \"ONLINE\",\n \"invoice\": true,\n \"messageToSeller\": \"Proszę o staranne zapakowanie.\"\n};\nconst res = await fetch(`${BASE}/allee/sandbox/orders`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/sandbox/orders (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/sandbox/orders\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"offerId\": \"900000000000021\",\n \"quantity\": 2,\n \"paymentType\": \"ONLINE\",\n \"invoice\": true,\n \"messageToSeller\": \"Proszę o staranne zapakowanie.\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/sandbox/orders (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"offerId\": \"900000000000021\",\n \"quantity\": 2,\n \"paymentType\": \"ONLINE\",\n \"invoice\": true,\n \"messageToSeller\": \"Proszę o staranne zapakowanie.\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sandbox/orders\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/sandbox/orders (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"offerId\": \"900000000000021\",\n \"quantity\": 2,\n \"paymentType\": \"ONLINE\",\n \"invoice\": true,\n \"messageToSeller\": \"Proszę o staranne zapakowanie.\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/sandbox/orders\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sandbox/returns": { "post": { "operationId": "createSandboxReturn", "summary": "Symulacja zwrotu kupującego", "tags": [ "Sandbox" ], "description": "Kupujący demo zgłasza zwrot zamówienia — wcześniej oznacz je jako wysłane (`POST …/shipments` + `PUT …/fulfillment` SENT), inaczej 422 `ORDER_NOT_SENT`.\n\nDziała **wyłącznie kluczem testowym** (`allee_sk_test_…`) — klucz produkcyjny dostaje 403 `SANDBOX_ONLY`. Dane są fikcyjne i oddzielone od produkcji (osobna baza); odpowiedzi mają nagłówek `X-Allee-Mode: test`.\n\n**Zgodność:** tylko allee — Allegro sandbox: zwrot testowy.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SandboxReturnInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SandboxReturnInput" } } } }, "responses": { "201": { "description": "Zwrot.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SandboxReturnCreated" }, "example": { "id": "ZW-900000001", "referenceNumber": "ZW-900000001", "orderId": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "status": "CREATED" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SandboxReturnCreated" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `SANDBOX_ONLY`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `ORDER_NOT_SENT`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro sandbox: zwrot testowy", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "SANDBOX_ONLY" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "ORDER_NOT_SENT" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sandbox/returns\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"checkoutFormId\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n \"reason\": \"Nie spełnia oczekiwań\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " '432810d0-4d26-4f39-ba5f-b89def4d4f92',\n 'reason' => 'Nie spełnia oczekiwań',\n];\n$ch = curl_init($base . '/allee/sandbox/returns');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/sandbox/returns (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"checkoutFormId\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n \"reason\": \"Nie spełnia oczekiwań\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/sandbox/returns\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/sandbox/returns (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"checkoutFormId\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n \"reason\": \"Nie spełnia oczekiwań\"\n};\nconst res = await fetch(`${BASE}/allee/sandbox/returns`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/sandbox/returns (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/sandbox/returns\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"checkoutFormId\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n \"reason\": \"Nie spełnia oczekiwań\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/sandbox/returns (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"checkoutFormId\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n \"reason\": \"Nie spełnia oczekiwań\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sandbox/returns\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/sandbox/returns (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"checkoutFormId\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n \"reason\": \"Nie spełnia oczekiwań\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/sandbox/returns\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sellers/account": { "get": { "operationId": "getSellerAccount", "summary": "Konto, plan użycia i ograniczenia", "tags": [ "Konto" ], "description": "Typ konta, weryfikacja firmy, rynek, plan użycia z limitami grup, liczba ofert, kto obsługuje zamówienia i ograniczenia wpływające na API (np. kwarantanna). Działa też dla konta nieaktywnego.\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Sellers — getMarketplaceParticipations + nagłówki limitów.\n**Uprawnienie:** zakres `allegro:api:profile:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Konto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SellerAccount" }, "example": { "sellerId": "980000001", "login": "sklep_przykladowy_0e60e9", "accountType": "BUSINESS", "status": "ACTIVE", "businessVerification": { "status": "NOT_STARTED", "checkedAt": null, "taxId": null, "companyName": null }, "createdAt": "2026-11-10T11:10:02.000Z", "marketplace": { "id": "allee-pl", "countryCode": "PL", "currency": "PLN", "language": "pl-PL" }, "usagePlan": { "name": "pro", "perMinute": 9000, "groups": { "read": { "rate": 50, "burst": 150 }, "write": { "rate": 10, "burst": 60 }, "bulk": { "rate": 2, "burst": 10 } } }, "rateLimitHeader": "plan=pro; group=read; rate=50; burst=150", "credential": { "type": "PERSONAL_API_KEY", "keyId": "9800000", "scopes": [ "allee:api:billing:read", "allee:api:disputes", "allee:api:messaging", "allee:api:notifications", "allee:api:orders:pii", "allee:api:orders:read", "allee:api:orders:write", "allee:api:profile:read", "allee:api:reports", "allee:api:sale:offers:read", "allee:api:sale:offers:write", "allee:api:sale:settings:read", "allee:api:sale:settings:write", "allee:api:shipments:read", "allee:api:shipments:write" ], "expiresAt": "2026-12-10T11:10:02.000Z" }, "offers": { "active": 20, "all": 20 }, "ordersIntegration": { "owner": "THIS_APPLICATION" }, "restrictions": [ { "code": "ADULT_CONTENT_NOT_CONFIRMED", "message": "Konto nie potwierdziło ukończenia 18 lat — kategorie 18+ są niedostępne." } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/SellerAccount" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:profile:read" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Sellers — getMarketplaceParticipations + nagłówki limitów", "limitGroup": "read", "scope": "allegro:api:profile:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/account\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/sellers/account (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/sellers/account\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/sellers/account (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/sellers/account`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/sellers/account (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/sellers/account\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/sellers/account (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sellers/account\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/sellers/account (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/sellers/account\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sellers/compliance": { "get": { "operationId": "getSellerCompliance", "summary": "Stan zgodności: statusy, braki, blokady", "tags": [ "Zgodność sprzedawcy" ], "description": "Jedno miejsce, z którego integrator wie, czego brakuje sprzedawcy:\n\n- `status`: `ACTIVE` (brak braków ERROR), `INCOMPLETE`, `RESTRICTED` (blokada ofert lub wypłat), `SUSPENDED`, `CLOSED`;\n- `statuses`: niezależne obszary `identity`, `business`, `tax`, `productCompliance`, `payment`, `dac7` (`VERIFIED`, `PENDING`, `NOT_STARTED`, `REJECTED`, `NOT_REQUIRED`, `NOT_AVAILABLE`);\n- `missing[]`: braki w kształcie błędów ofert (`code`, `path`, `message`, `severity` ERROR/WARNING, `area`) — wymagania zależą od rodzaju sprzedawcy;\n- `restrictions`: trzy poziomy blokady (oferty / wypłaty / sprzedaż) z uzasadnieniem;\n- `enforcement.active`: czy braki ERROR już blokują nowe oferty (dziś `false`).\n\nZmiana stanu = webhook `SELLER_COMPLIANCE_CHANGED`.\n\n**Zgodność:** tylko allee — Account Health (część).\n**Uprawnienie:** zakres `allegro:api:profile:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Stan.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SellerCompliance" }, "example": { "sellerId": "980000001", "status": "INCOMPLETE", "sellerType": "SOLE_TRADER", "sellerTypeConfirmed": true, "statuses": { "identity": { "status": "PENDING", "reason": "Poziom kontaktowy: e-mail potwierdzony przez Google/Litfas i telefon. Weryfikacja dokumentem ruszy z operatorem płatności." }, "business": { "status": "NOT_STARTED", "reason": "Sprawdzimy NIP w Białej liście VAT, VIES i REGON (raz na dobę).", "checkedAt": null }, "payment": { "status": "NOT_AVAILABLE", "reason": "Wypłaty przez allee ruszą po podłączeniu operatora płatności (KYC/KYB po jego stronie)." }, "tax": { "status": "NOT_STARTED", "reason": null, "vatStatus": null }, "dac7": { "status": "NOT_AVAILABLE", "reason": "Liczniki DAC7 (progi 30 transakcji / 2000 EUR) — w przygotowaniu." }, "productCompliance": { "status": "NOT_STARTED", "reason": null, "activeOffers": 20 } }, "restrictions": { "offers": { "blocked": false, "since": null }, "payouts": { "blocked": false, "since": null }, "selling": { "suspended": false, "since": null }, "reason": null }, "missing": [ { "code": "COMPANY_NAME_MISSING", "path": "companyName", "message": "Podaj nazwę firmy (tak jak w CEIDG albo KRS).", "userMessage": "Podaj nazwę firmy (tak jak w CEIDG albo KRS).", "severity": "ERROR", "area": "business" }, { "code": "BUSINESS_ADDRESS_MISSING", "path": "address", "message": "Podaj adres siedziby firmy (ulica, kod, miejscowość).", "userMessage": "Podaj adres siedziby firmy (ulica, kod, miejscowość).", "severity": "ERROR", "area": "business" }, { "code": "PERSON_NAME_MISSING", "path": "personName", "message": "Podaj imię i nazwisko właściciela działalności.", "userMessage": "Podaj imię i nazwisko właściciela działalności.", "severity": "ERROR", "area": "identity" }, { "code": "DECLARATION_REQUIRED", "path": "declarations.AUTHENTIC_GOODS", "message": "Złóż oświadczenie: „Sprzedaję oryginalne towary z legalnego źródła”.", "userMessage": "Złóż oświadczenie: „Sprzedaję oryginalne towary z legalnego źródła”.", "severity": "ERROR", "area": "identity", "details": { "code": "AUTHENTIC_GOODS", "version": "2026-11-10" } }, { "code": "DECLARATION_REQUIRED", "path": "declarations.DATA_TRUE", "message": "Złóż oświadczenie: „Moje dane są prawdziwe i aktualne”.", "userMessage": "Złóż oświadczenie: „Moje dane są prawdziwe i aktualne”.", "severity": "ERROR", "area": "identity", "details": { "code": "DATA_TRUE", "version": "2026-11-10" } }, { "code": "DECLARATION_REQUIRED", "path": "declarations.IMAGE_RIGHTS", "message": "Złóż oświadczenie: „Mam prawa do zdjęć i opisów”.", "userMessage": "Złóż oświadczenie: „Mam prawa do zdjęć i opisów”.", "severity": "ERROR", "area": "identity", "details": { "code": "IMAGE_RIGHTS", "version": "2026-11-10" } }, { "code": "RETURN_ADDRESS_MISSING", "path": "returnAddress", "message": "Ustaw adres zwrotów (panel → Ustawienia → Dane firmy).", "userMessage": "Ustaw adres zwrotów (panel → Ustawienia → Dane firmy).", "severity": "ERROR", "area": "productCompliance" }, { "code": "TAX_ID_INVALID", "path": "taxId", "message": "Podaj poprawny NIP (10 cyfr).", "userMessage": "Podaj poprawny NIP (10 cyfr).", "severity": "ERROR", "area": "tax" }, { "code": "REGON_MISSING", "path": "registrationNumbers.regon", "message": "Podaj REGON firmy (9 cyfr) — uzupełnisz go jednym kliknięciem z rejestru w panelu.", "userMessage": "Podaj REGON firmy (9 cyfr) — uzupełnisz go jednym kliknięciem z rejestru w panelu.", "severity": "WARNING", "area": "business" } ], "summary": { "errors": 8, "warnings": 1 }, "declarations": [ { "code": "AUTHENTIC_GOODS", "version": "2026-11-10", "title": "Sprzedaję oryginalne towary z legalnego źródła", "required": true, "accepted": false, "acceptedAt": null, "previousVersionAccepted": false }, { "code": "DATA_TRUE", "version": "2026-11-10", "title": "Moje dane są prawdziwe i aktualne", "required": true, "accepted": false, "acceptedAt": null, "previousVersionAccepted": false }, { "code": "DSA_LEGAL_PRODUCTS", "version": "2026-11-10", "title": "Oferuję wyłącznie produkty i usługi zgodne z prawem", "required": true, "accepted": true, "acceptedAt": "2026-11-10T11:10:03.000Z", "previousVersionAccepted": false }, { "code": "IMAGE_RIGHTS", "version": "2026-11-10", "title": "Mam prawa do zdjęć i opisów", "required": true, "accepted": false, "acceptedAt": null, "previousVersionAccepted": false }, { "code": "PRIVATE_NOT_TRADER", "version": "2026-11-10", "title": "Sprzedaję jako osoba prywatna, nie w ramach działalności", "required": false, "accepted": false, "acceptedAt": null, "previousVersionAccepted": false }, { "code": "UNREGISTERED_LIMIT", "version": "2026-11-10", "title": "Działalność nierejestrowana mieści się w limicie", "required": false, "accepted": false, "acceptedAt": null, "previousVersionAccepted": false } ], "enforcement": { "active": false, "description": "Braki są informacją — dziś niczego nie blokują. O włączeniu blokady uprzedzimy z wyprzedzeniem." } } }, "application/json": { "schema": { "$ref": "#/components/schemas/SellerCompliance" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:profile:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Amazon SP-API: Account Health (część)", "limitGroup": "read", "scope": "allegro:api:profile:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/compliance\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/sellers/compliance (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/sellers/compliance\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/sellers/compliance (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/sellers/compliance`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/sellers/compliance (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/sellers/compliance\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/sellers/compliance (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sellers/compliance\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/sellers/compliance (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/sellers/compliance\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sellers/declarations": { "post": { "operationId": "acceptDeclaration", "summary": "Złożenie oświadczenia", "tags": [ "Zgodność sprzedawcy" ], "description": "Akceptacja aktualnej wersji. Zapisujemy wersję, czas, kanał `API`, aplikację i adres IP. Pokaż sprzedawcy treść z GET /allee/declarations, zanim to wyślesz — oświadczenie składa sprzedawca, nie integrator.\n\nPowtórna akceptacja tej samej wersji → 200 (bez zmian). Starsza wersja → 409 `DECLARATION_VERSION_OUTDATED` z `details.currentVersion`.\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DeclarationAcceptRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/DeclarationAcceptRequest" } } } }, "responses": { "200": { "description": "Już złożone wcześniej.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DeclarationAcceptResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/DeclarationAcceptResponse" } } } }, "201": { "description": "Złożono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DeclarationAcceptResponse" }, "example": { "code": "DSA_LEGAL_PRODUCTS", "version": "2026-11-10", "accepted": true, "compliance": { "status": "INCOMPLETE" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/DeclarationAcceptResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `DECLARATION_VERSION_OUTDATED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "DECLARATION_VERSION_OUTDATED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/declarations\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"code\": \"DSA_LEGAL_PRODUCTS\",\n \"version\": \"2026-11-10\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DSA_LEGAL_PRODUCTS',\n 'version' => '2026-11-10',\n];\n$ch = curl_init($base . '/allee/sellers/declarations');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/sellers/declarations (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"code\": \"DSA_LEGAL_PRODUCTS\",\n \"version\": \"2026-11-10\",\n}\nr = requests.request(\"POST\", BASE + \"/allee/sellers/declarations\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/sellers/declarations (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"code\": \"DSA_LEGAL_PRODUCTS\",\n \"version\": \"2026-11-10\"\n};\nconst res = await fetch(`${BASE}/allee/sellers/declarations`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/sellers/declarations (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/sellers/declarations\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"code\": \"DSA_LEGAL_PRODUCTS\",\n \"version\": \"2026-11-10\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/sellers/declarations (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"code\": \"DSA_LEGAL_PRODUCTS\",\n \"version\": \"2026-11-10\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sellers/declarations\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/sellers/declarations (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"code\": \"DSA_LEGAL_PRODUCTS\",\n \"version\": \"2026-11-10\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/sellers/declarations\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sellers/legal-profile": { "get": { "operationId": "getSellerLegalProfile", "summary": "Profil prawny sprzedawcy", "tags": [ "Zgodność sprzedawcy" ], "description": "Rodzaj sprzedawcy (`PRIVATE_PERSON`, `SOLE_TRADER`, `COMPANY`, `UNREGISTERED_ACTIVITY`), kraj, język kontaktu, telefon w formacie E.164, imię i nazwisko oraz — dla firm — dane przedsiębiorcy (nazwa, NIP, REGON/KRS/BDO, adres siedziby, kontakt dla kupujących).\n\n`sellerTypeConfirmed: false` = rodzaj zgadnięty z konta (prywatne/firmowe); potwierdź go przez PUT.\n\n**Zgodność:** tylko allee — Sellers — getAccount (businessType, primaryContact).\n**Uprawnienie:** zakres `allegro:api:profile:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Profil.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfile" }, "example": { "sellerId": "980000001", "sellerType": "SOLE_TRADER", "sellerTypeConfirmed": false, "sellerTypeLabel": "Jednoosobowa działalność gospodarcza", "country": "PL", "contactLanguage": "pl", "phone": null, "personName": null, "company": { "companyName": null, "legalName": null, "taxId": null, "registrationNumbers": { "regon": null, "krs": null, "bdo": null }, "address": { "street": null, "postalCode": null, "city": null, "countryCode": "PL" }, "contact": { "email": "demo-980000001@example.invalid", "phone": null }, "publicDataVisible": false }, "updatedAt": null } }, "application/json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfile" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:profile:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Amazon SP-API: Sellers — getAccount (businessType, primaryContact)", "limitGroup": "read", "scope": "allegro:api:profile:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/legal-profile\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/sellers/legal-profile (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/sellers/legal-profile\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/sellers/legal-profile (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/sellers/legal-profile`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/sellers/legal-profile (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/sellers/legal-profile\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/sellers/legal-profile (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sellers/legal-profile\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/sellers/legal-profile (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/sellers/legal-profile\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "putSellerLegalProfile", "summary": "Zmiana profilu prawnego", "tags": [ "Zgodność sprzedawcy" ], "description": "Pola, których nie wyślesz, zostają bez zmian (możesz też odesłać to, co zwrócił GET — pola tylko do odczytu pomijamy). Dane firmy sprawdzamy tymi samymi regułami co panel (NIP z cyfrą kontrolną, kod pocztowy, KRS…); błędy mają `path` pola API, np. `address.postalCode`.\n\n- Konto prywatne → `SOLE_TRADER`/`COMPANY`: w tym samym żądaniu podaj `companyName` i `taxId` (i adres siedziby).\n- Konto firmowe → osoba prywatna: **409** `SELLER_TYPE_CHANGE_NOT_ALLOWED` (NIP jest na fakturach — zmiana przez pomoc allee).\n- Każda zmiana trafia do historii (GET …/history) z kanałem `API` i Twoją aplikacją.\n\n**Zgodność:** tylko allee — — (allee).\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfileUpdate" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfileUpdate" } } } }, "responses": { "200": { "description": "Profil po zmianie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfile" }, "example": { "sellerId": "980000001", "sellerType": "SOLE_TRADER", "sellerTypeConfirmed": true, "sellerTypeLabel": "Jednoosobowa działalność gospodarcza", "country": "PL", "contactLanguage": "pl", "phone": "+48601234567", "personName": null, "company": { "companyName": null, "legalName": null, "taxId": null, "registrationNumbers": { "regon": null, "krs": null, "bdo": null }, "address": { "street": null, "postalCode": null, "city": null, "countryCode": "PL" }, "contact": { "email": "demo-980000001@example.invalid", "phone": null }, "publicDataVisible": false }, "updatedAt": "2026-11-10T11:10:03.492Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfile" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `SELLER_TYPE_CHANGE_NOT_ALLOWED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `MISSING_REQUIRED`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Amazon SP-API: — (allee)", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "SELLER_TYPE_CHANGE_NOT_ALLOWED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "MISSING_REQUIRED" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/legal-profile\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"phone\": \"+48 601 234 567\",\n \"contactLanguage\": \"pl\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " '+48 601 234 567',\n 'contactLanguage' => 'pl',\n];\n$ch = curl_init($base . '/allee/sellers/legal-profile');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /allee/sellers/legal-profile (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"phone\": \"+48 601 234 567\",\n \"contactLanguage\": \"pl\",\n}\nr = requests.request(\"PUT\", BASE + \"/allee/sellers/legal-profile\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /allee/sellers/legal-profile (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"phone\": \"+48 601 234 567\",\n \"contactLanguage\": \"pl\"\n};\nconst res = await fetch(`${BASE}/allee/sellers/legal-profile`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /allee/sellers/legal-profile (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/allee/sellers/legal-profile\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"phone\": \"+48 601 234 567\",\n \"contactLanguage\": \"pl\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /allee/sellers/legal-profile (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"phone\": \"+48 601 234 567\",\n \"contactLanguage\": \"pl\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sellers/legal-profile\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /allee/sellers/legal-profile (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"phone\": \"+48 601 234 567\",\n \"contactLanguage\": \"pl\"\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/allee/sellers/legal-profile\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/sellers/legal-profile/history": { "get": { "operationId": "getSellerLegalProfileHistory", "summary": "Historia zmian danych prawnych", "tags": [ "Zgodność sprzedawcy" ], "description": "Każda zmiana pola osobno (było → jest), najnowsze pierwsze: z panelu (`PANEL`), API (`API`, z identyfikatorem aplikacji), od allee (`ADMIN` — np. blokada) i automatyczne (`SYSTEM`). Oświadczenia jako `declaration.{KOD}`.\n\n**Zgodność:** tylko allee.\n**Uprawnienie:** zakres `allegro:api:profile:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "limit", "in": "query", "required": false, "description": "Ile zmian.", "schema": { "type": "integer", "description": "1–200, domyślnie 50." } }, { "name": "offset", "in": "query", "required": false, "description": "Przesunięcie.", "schema": { "type": "integer", "description": "Od której (domyślnie 0)." } } ], "responses": { "200": { "description": "Zmiany.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfileHistory" }, "example": { "changes": [ { "field": "declaration.DSA_LEGAL_PRODUCTS", "before": null, "after": "2026-11-10", "channel": "API", "applicationId": "98000", "changedAt": "2026-11-10T11:10:03.502Z" }, { "field": "phone", "before": null, "after": "+48601234567", "channel": "API", "applicationId": "98000", "changedAt": "2026-11-10T11:10:03.493Z" }, { "field": "contactLanguage", "before": null, "after": "pl", "channel": "API", "applicationId": "98000", "changedAt": "2026-11-10T11:10:03.493Z" }, { "field": "country", "before": null, "after": "PL", "channel": "API", "applicationId": "98000", "changedAt": "2026-11-10T11:10:03.492Z" }, { "field": "sellerType", "before": null, "after": "SOLE_TRADER", "channel": "API", "applicationId": "98000", "changedAt": "2026-11-10T11:10:03.492Z" } ], "limit": 20, "offset": 0 } }, "application/json": { "schema": { "$ref": "#/components/schemas/SellerLegalProfileHistory" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:profile:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "read", "scope": "allegro:api:profile:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/legal-profile/history?limit=20\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /allee/sellers/legal-profile/history (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/allee/sellers/legal-profile/history?limit=20\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /allee/sellers/legal-profile/history (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/allee/sellers/legal-profile/history?limit=20`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /allee/sellers/legal-profile/history (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/allee/sellers/legal-profile/history?limit=20\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /allee/sellers/legal-profile/history (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/sellers/legal-profile/history?limit=20\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /allee/sellers/legal-profile/history (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/allee/sellers/legal-profile/history?limit=20\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/allee/uploads": { "post": { "operationId": "createUploadDestination", "summary": "Miejsce wgrania zdjęcia (wprost do magazynu)", "tags": [ "Zdjęcia" ], "description": "Zwraca podpisany adres `PUT` (ważny 5 min). Wyślij tam plik **wprost** (serwer allee go nie dotyka) z nagłówkami z `headers`, potem użyj `location` w `images` oferty.\n\nTypy: JPEG, PNG, WEBP; do 15 MB; najwyżej 600 miejsc na godzinę na sprzedawcę. W sandboxie → 403 `SANDBOX_UNSUPPORTED` (podawaj adresy URL).\n\n**Zgodność:** wzorowana na Amazon Selling Partner API — Uploads — createUploadDestinationForResource.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "contentType": { "type": "string", "enum": [ "image/jpeg", "image/png", "image/webp" ] }, "contentLength": { "type": "integer", "description": "Rozmiar pliku w bajtach (1–15 MB)." }, "resource": { "type": "string", "enum": [ "OFFER_IMAGE" ] } }, "required": [ "contentType" ] } }, "application/json": { "schema": { "type": "object", "properties": { "contentType": { "type": "string", "enum": [ "image/jpeg", "image/png", "image/webp" ] }, "contentLength": { "type": "integer", "description": "Rozmiar pliku w bajtach (1–15 MB)." }, "resource": { "type": "string", "enum": [ "OFFER_IMAGE" ] } }, "required": [ "contentType" ] } } } }, "responses": { "201": { "description": "Miejsce wgrania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/UploadDestination" }, "example": { "uploadId": "ffd13428-40ab-428a-bada-af4de043ce90", "method": "PUT", "url": "https://0e31a0c8a001f9f8df521110ca4f3f6e.r2.cloudflarestorage.com/allee/api/980000001/ffd13428-40ab-428a-bada-af4de043ce90.jpg?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=0136e1e8b4bd3d8e11870c33177d2879%2F20261110%2Fauto%2Fs3%2Faws4_request&X-Amz-Date=20261110T111004Z&X-Amz-Expires=300&X-Amz-SignedHeaders=content-type%3Bhost&X-Amz-Signature=…", "headers": { "Content-Type": "image/jpeg" }, "location": "https://cdn.allee.pl/api/980000001/ffd13428-40ab-428a-bada-af4de043ce90.jpg", "expiresAt": "2026-11-10T11:15:04.000Z", "maxBytes": 245760 } }, "application/json": { "schema": { "$ref": "#/components/schemas/UploadDestination" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `SANDBOX_UNSUPPORTED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`, `STORAGE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "amazon", "equivalent": "Amazon SP-API: Uploads — createUploadDestinationForResource", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "SANDBOX_UNSUPPORTED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" }, { "status": 503, "code": "STORAGE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/allee/uploads\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"contentType\": \"image/jpeg\",\n \"contentLength\": 245760\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'image/jpeg',\n 'contentLength' => 245760,\n];\n$ch = curl_init($base . '/allee/uploads');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /allee/uploads (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"contentType\": \"image/jpeg\",\n \"contentLength\": 245760,\n}\nr = requests.request(\"POST\", BASE + \"/allee/uploads\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /allee/uploads (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"contentType\": \"image/jpeg\",\n \"contentLength\": 245760\n};\nconst res = await fetch(`${BASE}/allee/uploads`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /allee/uploads (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/allee/uploads\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"contentType\": \"image/jpeg\",\n \"contentLength\": 245760\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /allee/uploads (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"contentType\": \"image/jpeg\",\n \"contentLength\": 245760\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/allee/uploads\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /allee/uploads (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"contentType\": \"image/jpeg\",\n \"contentLength\": 245760\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/allee/uploads\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/auth/oauth/authorize": { "get": { "operationId": "oauthAuthorize", "summary": "Autoryzacja: przekierowanie sprzedawcy", "tags": [ "OAuth" ], "description": "Adres, na który aplikacja kieruje **przeglądarkę** sprzedawcy (Authorization Code + PKCE, tylko S256). Poprawne żądanie → 302 na stronę zgody allee.pl; sprzedawca loguje się i klika „Zezwól” → 302 na `redirect_uri?code=…&state=…`.\n\n- `redirect_uri` porównujemy 1:1 z zarejestrowanym (bajt w bajt).\n- Zły `client_id`, nieaktywna aplikacja albo obcy `redirect_uri` → strona błędu 400 **bez** przekierowania (ochrona przed otwartym przekierowaniem).\n- Błąd po potwierdzeniu `redirect_uri` → 302 `redirect_uri?error=invalid_request|invalid_scope|unsupported_response_type&state=…`.\n- Zakresy: nazwy Allegro (`allegro:api:…`) albo allee (`allee:api:…`); nieznane są pomijane.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET https://allegro.pl/auth/oauth/authorize.\n**Uwierzytelnienie:** brak.", "parameters": [ { "name": "response_type", "in": "query", "required": true, "description": "Zawsze code.", "schema": { "type": "string", "enum": [ "code" ] } }, { "name": "client_id", "in": "query", "required": true, "description": "client_id aplikacji.", "schema": { "type": "string" } }, { "name": "redirect_uri", "in": "query", "required": true, "description": "Zarejestrowany adres powrotu.", "schema": { "type": "string", "format": "uri" } }, { "name": "state", "in": "query", "required": false, "description": "Wartość ochronna (CSRF) — wraca bez zmian.", "schema": { "type": "string", "maxLength": 500 } }, { "name": "code_challenge", "in": "query", "required": true, "description": "BASE64URL(SHA256(code_verifier)).", "schema": { "type": "string", "pattern": "^[A-Za-z0-9_-]{43,128}$" } }, { "name": "code_challenge_method", "in": "query", "required": true, "description": "Tylko S256.", "schema": { "type": "string", "enum": [ "S256" ] } }, { "name": "scope", "in": "query", "required": false, "description": "Zakresy rozdzielone spacją.", "schema": { "type": "string" } } ], "responses": { "302": { "description": "Przekierowanie na stronę zgody (albo na redirect_uri z błędem).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "Location": { "$ref": "#/components/headers/Location" } } }, "400": { "description": "Strona błędu (zły klient lub adres powrotu).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "text/html": { "schema": { "type": "string" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET https://allegro.pl/auth/oauth/authorize", "limitGroup": "auth", "errors": [ { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/auth/oauth/authorize?response_type=code&client_id=36d6ed33acd3fc480a9270abe6421e9c&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&state=st-7f3a9c&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=allegro%3Aapi%3Aprofile%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Awrite\" \\\n -H \"Accept: text/html\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Accept: text/html',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /auth/oauth/authorize (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"text/html\",\n}\nr = requests.request(\"GET\", BASE + \"/auth/oauth/authorize?response_type=code&client_id=36d6ed33acd3fc480a9270abe6421e9c&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&state=st-7f3a9c&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=allegro%3Aapi%3Aprofile%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Awrite\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /auth/oauth/authorize (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/auth/oauth/authorize?response_type=code&client_id=36d6ed33acd3fc480a9270abe6421e9c&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&state=st-7f3a9c&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=allegro%3Aapi%3Aprofile%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Awrite`, {\n method: \"GET\",\n headers: {\n \"Accept\": \"text/html\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /auth/oauth/authorize (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/auth/oauth/authorize?response_type=code&client_id=36d6ed33acd3fc480a9270abe6421e9c&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&state=st-7f3a9c&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=allegro%3Aapi%3Aprofile%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Awrite\");\nreq.Headers.Accept.ParseAdd(\"text/html\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /auth/oauth/authorize (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/auth/oauth/authorize?response_type=code&client_id=36d6ed33acd3fc480a9270abe6421e9c&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&state=st-7f3a9c&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=allegro%3Aapi%3Aprofile%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Awrite\"))\n .header(\"Accept\", \"text/html\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /auth/oauth/authorize (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/auth/oauth/authorize?response_type=code&client_id=36d6ed33acd3fc480a9270abe6421e9c&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&state=st-7f3a9c&code_challenge=E9Melhoa2OwvFrEMTJguCHaoeK1t8URWbuGJSstw-cM&code_challenge_method=S256&scope=allegro%3Aapi%3Aprofile%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Aread%20allegro%3Aapi%3Asale%3Aoffers%3Awrite\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"text/html\")\n\t// nie podążamy za przekierowaniami (authorize odpowiada 302)\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/auth/oauth/revoke": { "post": { "operationId": "oauthRevoke", "summary": "Odwołanie tokenu", "tags": [ "OAuth" ], "description": "Odwołanie access albo refresh tokenu (refresh → cała rodzina tokenów pary). Zawsze 200 po poprawnym uwierzytelnieniu klienta — nie zdradzamy, czy token istniał ani czyj był.\n\n**Zgodność:** tylko allee — RFC 7009 (Allegro: brak).\n**Uwierzytelnienie:** klient OAuth — `Authorization: Basic base64(client_id:client_secret)`.", "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "token": { "type": "string", "description": "Token do odwołania." }, "token_type_hint": { "type": "string", "enum": [ "access_token", "refresh_token" ] } }, "required": [ "token" ] } } } }, "responses": { "200": { "description": "Odwołano (albo nic do odwołania).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RevokeResponse" }, "example": { "revoked": true } } } }, "400": { "description": "Brak parametru token.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "401": { "description": "invalid_client.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } } }, "security": [ { "clientBasic": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "RFC 7009 (Allegro: brak)", "limitGroup": "auth", "errors": [ { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/auth/oauth/revoke\" \\\n -u \"$ALLEE_CLIENT_ID:$ALLEE_CLIENT_SECRET\" \\\n -H \"Accept: application/json\" \\\n --data-urlencode \"token={refresh_token}\" \\\n --data-urlencode \"token_type_hint=refresh_token\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/json',\n ],\n CURLOPT_USERPWD => getenv('ALLEE_CLIENT_ID') . ':' . getenv('ALLEE_CLIENT_SECRET'),\n CURLOPT_POSTFIELDS => http_build_query([\n 'token' => '{refresh_token}',\n 'token_type_hint' => 'refresh_token',\n ]),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /auth/oauth/revoke (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/json\",\n}\nform = {\n \"token\": \"{refresh_token}\",\n \"token_type_hint\": \"refresh_token\",\n}\nr = requests.request(\"POST\", BASE + \"/auth/oauth/revoke\", headers=headers, data=form, auth=(os.environ[\"ALLEE_CLIENT_ID\"], os.environ[\"ALLEE_CLIENT_SECRET\"]), timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /auth/oauth/revoke (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst form = new URLSearchParams({\n \"token\": \"{refresh_token}\",\n \"token_type_hint\": \"refresh_token\"\n});\nconst res = await fetch(`${BASE}/auth/oauth/revoke`, {\n method: \"POST\",\n headers: {\n Authorization: \"Basic \" + Buffer.from(`${process.env.ALLEE_CLIENT_ID}:${process.env.ALLEE_CLIENT_SECRET}`).toString(\"base64\"),\n \"Accept\": \"application/json\",\n },\n body: form,\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /auth/oauth/revoke (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/auth/oauth/revoke\");\nvar klient = Environment.GetEnvironmentVariable(\"ALLEE_CLIENT_ID\") + \":\" + Environment.GetEnvironmentVariable(\"ALLEE_CLIENT_SECRET\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Basic\", Convert.ToBase64String(Encoding.UTF8.GetBytes(klient)));\nreq.Headers.Accept.ParseAdd(\"application/json\");\nreq.Content = new FormUrlEncodedContent(new Dictionary\n{\n [\"token\"] = \"{refresh_token}\",\n [\"token_type_hint\"] = \"refresh_token\",\n});\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /auth/oauth/revoke (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String form = \"token=%7Brefresh_token%7D&token_type_hint=refresh_token\";\n String klient = System.getenv(\"ALLEE_CLIENT_ID\") + \":\" + System.getenv(\"ALLEE_CLIENT_SECRET\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/auth/oauth/revoke\"))\n .header(\"Authorization\", \"Basic \" + Base64.getEncoder().encodeToString(klient.getBytes(StandardCharsets.UTF_8)))\n .header(\"Accept\", \"application/json\")\n .header(\"Content-Type\", \"application/x-www-form-urlencoded\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(form))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /auth/oauth/revoke (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tform := url.Values{}\n\tform.Set(\"token\", \"{refresh_token}\")\n\tform.Set(\"token_type_hint\", \"refresh_token\")\n\treq, err := http.NewRequest(\"POST\", base+\"/auth/oauth/revoke\", strings.NewReader(form.Encode()))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.SetBasicAuth(os.Getenv(\"ALLEE_CLIENT_ID\"), os.Getenv(\"ALLEE_CLIENT_SECRET\"))\n\treq.Header.Set(\"Accept\", \"application/json\")\n\treq.Header.Set(\"Content-Type\", \"application/x-www-form-urlencoded\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/auth/oauth/token": { "post": { "operationId": "oauthToken", "summary": "Token: kod, odświeżenie, token aplikacji", "tags": [ "OAuth" ], "description": "Wywołanie serwer–serwer. Uwierzytelnienie klienta: `Authorization: Basic base64(client_id:client_secret)`. Ciało `application/x-www-form-urlencoded`.\n\n| grant_type | pola | wynik |\n|---|---|---|\n| `authorization_code` | `code`, `redirect_uri`, `code_verifier` | para tokenów (access 12 h, refresh 90 dni) |\n| `refresh_token` | `refresh_token`, opcjonalnie `scope` (zawężenie) | **nowa para** — stary refresh przestaje działać (rotacja; ponowne użycie poza 60-sekundowym oknem łaski odwołuje całą rodzinę tokenów) |\n| `client_credentials` | — | token aplikacji bez sprzedawcy: tylko dane publiczne (kategorie, parametry, metody dostawy, przewoźnicy) |\n\nKod autoryzacyjny jest jednorazowy (10 min) — nieudana wymiana też go zużywa. Odświeżaj **pojedynczo** i zapisuj nową parę atomowo. Błędy w formacie OAuth (`error`, `error_description`).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST https://allegro.pl/auth/oauth/token.\n**Uwierzytelnienie:** klient OAuth — `Authorization: Basic base64(client_id:client_secret)`.", "requestBody": { "required": true, "content": { "application/x-www-form-urlencoded": { "schema": { "type": "object", "properties": { "grant_type": { "type": "string", "enum": [ "authorization_code", "refresh_token", "client_credentials" ] }, "code": { "type": "string" }, "redirect_uri": { "type": "string" }, "code_verifier": { "type": "string", "description": "43–128 znaków." }, "refresh_token": { "type": "string" }, "scope": { "type": "string", "description": "Zawężenie zakresów przy odświeżaniu." } }, "required": [ "grant_type" ] } } } }, "responses": { "200": { "description": "Tokeny.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenResponse" }, "example": { "access_token": "{access_token}", "token_type": "bearer", "refresh_token": "{refresh_token}", "expires_in": 43200, "scope": "allegro:api:profile:read allegro:api:sale:offers:read allegro:api:sale:offers:write" } } } }, "400": { "description": "invalid_request, invalid_grant, unsupported_grant_type.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "401": { "description": "invalid_client (zły client_id/sekret albo aplikacja nieaktywna).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "429": { "description": "slow_down — zbyt wiele nieudanych uwierzytelnień (blokada narasta 1 → 15 → 60 min).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } } }, "security": [ { "clientBasic": [] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST https://allegro.pl/auth/oauth/token", "limitGroup": "auth", "errors": [ { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/auth/oauth/token\" \\\n -u \"$ALLEE_CLIENT_ID:$ALLEE_CLIENT_SECRET\" \\\n -H \"Accept: application/json\" \\\n --data-urlencode \"grant_type=authorization_code\" \\\n --data-urlencode \"code={kod_z_przekierowania}\" \\\n --data-urlencode \"redirect_uri=https://integrator.example.com/allee/powrot\" \\\n --data-urlencode \"code_verifier={code_verifier}\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/json',\n ],\n CURLOPT_USERPWD => getenv('ALLEE_CLIENT_ID') . ':' . getenv('ALLEE_CLIENT_SECRET'),\n CURLOPT_POSTFIELDS => http_build_query([\n 'grant_type' => 'authorization_code',\n 'code' => '{kod_z_przekierowania}',\n 'redirect_uri' => 'https://integrator.example.com/allee/powrot',\n 'code_verifier' => '{code_verifier}',\n ]),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /auth/oauth/token (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/json\",\n}\nform = {\n \"grant_type\": \"authorization_code\",\n \"code\": \"{kod_z_przekierowania}\",\n \"redirect_uri\": \"https://integrator.example.com/allee/powrot\",\n \"code_verifier\": \"{code_verifier}\",\n}\nr = requests.request(\"POST\", BASE + \"/auth/oauth/token\", headers=headers, data=form, auth=(os.environ[\"ALLEE_CLIENT_ID\"], os.environ[\"ALLEE_CLIENT_SECRET\"]), timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /auth/oauth/token (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst form = new URLSearchParams({\n \"grant_type\": \"authorization_code\",\n \"code\": \"{kod_z_przekierowania}\",\n \"redirect_uri\": \"https://integrator.example.com/allee/powrot\",\n \"code_verifier\": \"{code_verifier}\"\n});\nconst res = await fetch(`${BASE}/auth/oauth/token`, {\n method: \"POST\",\n headers: {\n Authorization: \"Basic \" + Buffer.from(`${process.env.ALLEE_CLIENT_ID}:${process.env.ALLEE_CLIENT_SECRET}`).toString(\"base64\"),\n \"Accept\": \"application/json\",\n },\n body: form,\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /auth/oauth/token (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/auth/oauth/token\");\nvar klient = Environment.GetEnvironmentVariable(\"ALLEE_CLIENT_ID\") + \":\" + Environment.GetEnvironmentVariable(\"ALLEE_CLIENT_SECRET\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Basic\", Convert.ToBase64String(Encoding.UTF8.GetBytes(klient)));\nreq.Headers.Accept.ParseAdd(\"application/json\");\nreq.Content = new FormUrlEncodedContent(new Dictionary\n{\n [\"grant_type\"] = \"authorization_code\",\n [\"code\"] = \"{kod_z_przekierowania}\",\n [\"redirect_uri\"] = \"https://integrator.example.com/allee/powrot\",\n [\"code_verifier\"] = \"{code_verifier}\",\n});\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /auth/oauth/token (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.charset.StandardCharsets;\nimport java.util.Base64;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String form = \"grant_type=authorization_code&code=%7Bkod_z_przekierowania%7D&redirect_uri=https%3A%2F%2Fintegrator.example.com%2Fallee%2Fpowrot&code_verifier=%7Bcode_verifier%7D\";\n String klient = System.getenv(\"ALLEE_CLIENT_ID\") + \":\" + System.getenv(\"ALLEE_CLIENT_SECRET\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/auth/oauth/token\"))\n .header(\"Authorization\", \"Basic \" + Base64.getEncoder().encodeToString(klient.getBytes(StandardCharsets.UTF_8)))\n .header(\"Accept\", \"application/json\")\n .header(\"Content-Type\", \"application/x-www-form-urlencoded\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(form))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /auth/oauth/token (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"net/url\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tform := url.Values{}\n\tform.Set(\"grant_type\", \"authorization_code\")\n\tform.Set(\"code\", \"{kod_z_przekierowania}\")\n\tform.Set(\"redirect_uri\", \"https://integrator.example.com/allee/powrot\")\n\tform.Set(\"code_verifier\", \"{code_verifier}\")\n\treq, err := http.NewRequest(\"POST\", base+\"/auth/oauth/token\", strings.NewReader(form.Encode()))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.SetBasicAuth(os.Getenv(\"ALLEE_CLIENT_ID\"), os.Getenv(\"ALLEE_CLIENT_SECRET\"))\n\treq.Header.Set(\"Accept\", \"application/json\")\n\treq.Header.Set(\"Content-Type\", \"application/x-www-form-urlencoded\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/billing/billing-entries": { "get": { "operationId": "getBillingEntries", "summary": "Operacje rozliczeniowe", "tags": [ "Rozliczenia" ], "description": "Operacje na koncie rozliczeniowym sprzedawcy (dla allee.pl).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /billing/billing-entries.\n**Uprawnienie:** zakres `allegro:api:billing:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "maximum": 10000, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–100, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 } }, { "name": "id.gt", "in": "query", "required": false, "description": "Po tym id.", "schema": { "type": "string" } }, { "name": "occurredAt.gte", "in": "query", "required": false, "description": "Od.", "schema": { "type": "string", "format": "date-time" } }, { "name": "occurredAt.lte", "in": "query", "required": false, "description": "Do.", "schema": { "type": "string", "format": "date-time" } }, { "name": "type.id", "in": "query", "required": false, "description": "Typ operacji.", "schema": { "type": "string" } }, { "name": "order.id", "in": "query", "required": false, "description": "Zamówienie.", "schema": { "type": "string", "format": "uuid" } }, { "name": "offer.id", "in": "query", "required": false, "description": "Oferta.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Operacje.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/BillingEntryList" }, "example": { "billingEntries": [], "count": 0, "totalCount": 0 } }, "application/json": { "schema": { "$ref": "#/components/schemas/BillingEntryList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:billing:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /billing/billing-entries", "limitGroup": "read", "scope": "allegro:api:billing:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /billing/billing-entries (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /billing/billing-entries (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /billing/billing-entries (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /billing/billing-entries (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /billing/billing-entries (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/billing/billing-entries?occurredAt.gte=2026-10-11T00%3A00%3A00Z&limit=50\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/billing/billing-types": { "get": { "operationId": "getBillingTypes", "summary": "Typy operacji rozliczeniowych", "tags": [ "Rozliczenia" ], "description": "Dziś pusta lista — allee.pl nie pobiera opłat ani prowizji.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /billing/billing-types.\n**Uprawnienie:** zakres `allegro:api:billing:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Typy.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/BillingTypeList" }, "example": [] }, "application/json": { "schema": { "$ref": "#/components/schemas/BillingTypeList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:billing:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /billing/billing-types", "limitGroup": "read", "scope": "allegro:api:billing:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/billing/billing-types\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /billing/billing-types (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/billing/billing-types\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /billing/billing-types (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/billing/billing-types`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /billing/billing-types (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/billing/billing-types\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /billing/billing-types (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/billing/billing-types\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /billing/billing-types (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/billing/billing-types\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/docs": { "get": { "operationId": "getDocumentation", "summary": "Dokumentacja (przekierowanie)", "tags": [ "Stan usługi" ], "description": "301 na portal dla deweloperów: https://allee.pl/dla-deweloperow/\n\n**Zgodność:** tylko allee.\n**Uwierzytelnienie:** brak.", "responses": { "301": { "description": "Przekierowanie na portal.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "Location": { "$ref": "#/components/headers/Location" } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "read", "errors": [ { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/docs\" \\\n -H \"Accept: text/html\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Accept: text/html',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /docs (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"text/html\",\n}\nr = requests.request(\"GET\", BASE + \"/docs\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /docs (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/docs`, {\n method: \"GET\",\n headers: {\n \"Accept\": \"text/html\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /docs (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/docs\");\nreq.Headers.Accept.ParseAdd(\"text/html\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /docs (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/docs\"))\n .header(\"Accept\", \"text/html\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /docs (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/docs\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"text/html\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/marketplaces": { "get": { "operationId": "getMarketplaces", "summary": "Rynki", "tags": [ "Rynki" ], "description": "Jedyny rynek: `allee-pl` (PLN, pl-PL).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /marketplaces.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Rynki.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MarketplaceList" }, "example": { "marketplaces": [ { "id": "allee-pl", "name": "allee.pl", "languages": { "base": "pl-PL", "extra": [] }, "currencies": { "base": "PLN", "extra": [] } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/MarketplaceList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /marketplaces", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/marketplaces\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /marketplaces (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/marketplaces\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /marketplaces (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/marketplaces`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /marketplaces (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/marketplaces\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /marketplaces (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/marketplaces\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /marketplaces (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/marketplaces\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/me": { "get": { "operationId": "getMe", "summary": "Konto sprzedawcy", "tags": [ "Konto" ], "description": "Dane konta, do którego należy token lub klucz. Konto nieaktywne → 403 `ACCOUNT_INACTIVE` z `details: {id, login}`.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /me.\n**Uprawnienie:** zakres `allegro:api:profile:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Konto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Me" }, "example": { "id": "980000001", "login": "sklep_przykladowy_0e60e9", "email": "demo-980000001@example.invalid", "firstName": null, "lastName": null, "company": { "name": null, "taxId": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Me" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:profile:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /me", "limitGroup": "read", "scope": "allegro:api:profile:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/me\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /me (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/me\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /me (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/me`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /me (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/me\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /me (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/me\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /me (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/me\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/me/token": { "get": { "operationId": "getTokenInfo", "summary": "Co może ten token lub klucz", "tags": [ "Konto" ], "description": "Rodzaj poświadczenia, aplikacja, konto, zakresy, termin ważności, plan użycia i limity. Bez sekretów. Działa też dla konta nieaktywnego (diagnoza 403).\n\n**Zgodność:** tylko allee — Stripe/Amazon: introspekcja poświadczenia.\n**Uprawnienie:** dowolny ważny token lub klucz.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Poświadczenie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/TokenInfo" }, "example": { "type": "PERSONAL_API_KEY", "key": { "id": "9800000" }, "application": { "clientId": "3d743966faa5ca12c71b3923ad45ea99", "name": "Klucze osobiste — sklep_przykladowy_0e60e9" }, "user": { "id": "980000001", "login": "sklep_przykladowy_0e60e9", "active": true }, "scopes": [ "allee:api:billing:read", "allee:api:disputes", "allee:api:messaging", "allee:api:notifications", "allee:api:orders:pii", "allee:api:orders:read", "allee:api:orders:write", "allee:api:profile:read", "allee:api:reports", "allee:api:sale:offers:read", "allee:api:sale:offers:write", "allee:api:sale:settings:read", "allee:api:sale:settings:write", "allee:api:shipments:read", "allee:api:shipments:write" ], "expiresAt": "2026-12-10T11:10:02.000Z", "usagePlan": { "name": "pro", "perMinute": 1200, "groups": { "read": { "rate": 50, "burst": 150 }, "write": { "rate": 10, "burst": 60 }, "bulk": { "rate": 2, "burst": 10 } } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/TokenInfo" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allee", "equivalent": "Stripe/Amazon: introspekcja poświadczenia", "limitGroup": "read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/me/token\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /me/token (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/me/token\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /me/token (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/me/token`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /me/token (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/me/token\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /me/token (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/me/token\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /me/token (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/me/token\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/message-attachments": { "post": { "operationId": "newAttachmentDeclaration", "summary": "Załącznik wiadomości (nieobsługiwany)", "tags": [ "Wiadomości" ], "description": "allee nie przyjmuje załączników w wiadomościach — zawsze **422 `ATTACHMENTS_NOT_SUPPORTED`**. Trasa istnieje, by klient Allegro dostał czytelny błąd zamiast 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /messaging/message-attachments.\n**Uprawnienie:** zakres `allegro:api:messaging:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "additionalProperties": true, "description": "Dowolne (pomijane)." } }, "application/json": { "schema": { "type": "object", "additionalProperties": true, "description": "Dowolne (pomijane)." } } } }, "responses": { "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Załączniki nieobsługiwane. Kody błędów: `ATTACHMENTS_NOT_SUPPORTED`, `JsonMappingException`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "errors": [ { "code": "ATTACHMENTS_NOT_SUPPORTED", "message": "allee nie przyjmuje załączników w wiadomościach — wyślij sam tekst.", "details": null, "path": null, "userMessage": "Załączniki w wiadomościach nie są dostępne na allee.pl." } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /messaging/message-attachments", "limitGroup": "write", "scope": "allegro:api:messaging:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "ATTACHMENTS_NOT_SUPPORTED" }, { "status": 422, "code": "JsonMappingException" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/message-attachments\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"filename\": \"zdjecie.jpg\",\n \"size\": 102400\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'zdjecie.jpg',\n 'size' => 102400,\n];\n$ch = curl_init($base . '/messaging/message-attachments');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /messaging/message-attachments (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"filename\": \"zdjecie.jpg\",\n \"size\": 102400,\n}\nr = requests.request(\"POST\", BASE + \"/messaging/message-attachments\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /messaging/message-attachments (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"filename\": \"zdjecie.jpg\",\n \"size\": 102400\n};\nconst res = await fetch(`${BASE}/messaging/message-attachments`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /messaging/message-attachments (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/messaging/message-attachments\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"filename\": \"zdjecie.jpg\",\n \"size\": 102400\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /messaging/message-attachments (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"filename\": \"zdjecie.jpg\",\n \"size\": 102400\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/message-attachments\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /messaging/message-attachments (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"filename\": \"zdjecie.jpg\",\n \"size\": 102400\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/messaging/message-attachments\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/messages": { "post": { "operationId": "newMessage", "summary": "Nowa rozmowa w sprawie zamówienia", "tags": [ "Wiadomości" ], "description": "Na allee.pl sprzedawca zaczyna rozmowę tylko w sprawie zamówienia allee.pl (`order.id`). Najwyżej 5 nowych rozmów na dobę (429 `THREAD_LIMIT`).\n\nTreść: bez linków zewnętrznych (422 `EXTERNAL_LINK`), filtr jak w panelu, najwyżej 20 wiadomości na godzinę wspólnie z panelem (429 `MESSAGE_LIMIT`). Bez załączników.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST /messaging/messages.\n**Uprawnienie:** zakres `allegro:api:messaging:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/NewMessageInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/NewMessageInput" } } } }, "responses": { "201": { "description": "Wysłano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Message" }, "example": { "id": "900000003", "status": "DELIVERED", "type": "MESSAGE_CENTER", "createdAt": "2026-11-10T11:10:05.504Z", "thread": { "id": "900000002" }, "author": { "login": "sklep_przykladowy_0e60e9", "isInterlocutor": false }, "text": "Dziękujemy za zamówienie — wyślemy je dziś.", "subject": null, "relatesTo": { "offer": null, "order": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92" } }, "hasAdditionalAttachments": false, "attachments": [], "allee": { "sender": "SELLER", "reported": false } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `CARD_DATA`, `CHANNEL_MESSAGING`, `EXTERNAL_LINK`, `JsonMappingException`, `ORDER_REQUIRED`, `PROFANITY`, `RECIPIENT_MISMATCH`, `SENSITIVE_REQUEST`, `TEXT_EMPTY`, `TEXT_INVALID`, `TEXT_TOO_LONG`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `BUSY`, `MESSAGE_LIMIT`, `THREAD_LIMIT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST /messaging/messages", "limitGroup": "write", "scope": "allegro:api:messaging:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "CARD_DATA" }, { "status": 422, "code": "CHANNEL_MESSAGING" }, { "status": 422, "code": "EXTERNAL_LINK" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "ORDER_REQUIRED" }, { "status": 422, "code": "PROFANITY" }, { "status": 422, "code": "RECIPIENT_MISMATCH" }, { "status": 422, "code": "SENSITIVE_REQUEST" }, { "status": 422, "code": "TEXT_EMPTY" }, { "status": 422, "code": "TEXT_INVALID" }, { "status": 422, "code": "TEXT_TOO_LONG" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "BUSY" }, { "status": 429, "code": "MESSAGE_LIMIT" }, { "status": 429, "code": "THREAD_LIMIT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/messages\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"recipient\": {\n \"login\": \"kupujacy_demo_4816f227\"\n },\n \"text\": \"Dziękujemy za zamówienie — wyślemy je dziś.\",\n \"order\": {\n \"id\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'login' => 'kupujacy_demo_4816f227',\n ],\n 'text' => 'Dziękujemy za zamówienie — wyślemy je dziś.',\n 'order' => [\n 'id' => '432810d0-4d26-4f39-ba5f-b89def4d4f92',\n ],\n];\n$ch = curl_init($base . '/messaging/messages');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /messaging/messages (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"recipient\": {\n \"login\": \"kupujacy_demo_4816f227\",\n },\n \"text\": \"Dziękujemy za zamówienie — wyślemy je dziś.\",\n \"order\": {\n \"id\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/messaging/messages\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /messaging/messages (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"recipient\": {\n \"login\": \"kupujacy_demo_4816f227\"\n },\n \"text\": \"Dziękujemy za zamówienie — wyślemy je dziś.\",\n \"order\": {\n \"id\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\"\n }\n};\nconst res = await fetch(`${BASE}/messaging/messages`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /messaging/messages (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/messaging/messages\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"recipient\": {\n \"login\": \"kupujacy_demo_4816f227\"\n },\n \"text\": \"Dziękujemy za zamówienie — wyślemy je dziś.\",\n \"order\": {\n \"id\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /messaging/messages (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"recipient\": {\n \"login\": \"kupujacy_demo_4816f227\"\n },\n \"text\": \"Dziękujemy za zamówienie — wyślemy je dziś.\",\n \"order\": {\n \"id\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/messages\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /messaging/messages (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"recipient\": {\n \"login\": \"kupujacy_demo_4816f227\"\n },\n \"text\": \"Dziękujemy za zamówienie — wyślemy je dziś.\",\n \"order\": {\n \"id\": \"432810d0-4d26-4f39-ba5f-b89def4d4f92\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/messaging/messages\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/messages/{messageId}": { "get": { "operationId": "getMessage", "summary": "Wiadomość", "tags": [ "Wiadomości" ], "description": "Jedna wiadomość (np. po powiadomieniu `MESSAGE_RECEIVED`).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /messaging/messages/{messageId}.\n**Uprawnienie:** zakres `allegro:api:messaging:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "messageId", "in": "path", "required": true, "description": "Identyfikator wiadomości.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wiadomość.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Message" }, "example": { "id": "900000002", "status": "DELIVERED", "type": "ASK_QUESTION", "createdAt": "2026-11-10T11:10:05.492Z", "thread": { "id": "900000001" }, "author": { "login": "sklep_przykladowy_0e60e9", "isInterlocutor": false }, "text": "Dzień dobry, tak — wydanie ma polskiego lektora i napisy.", "subject": null, "relatesTo": { "offer": { "id": "900000000000021" }, "order": null }, "hasAdditionalAttachments": false, "attachments": [], "allee": { "sender": "SELLER", "reported": false } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /messaging/messages/{messageId}", "limitGroup": "read", "scope": "allegro:api:messaging:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/messages/900000002\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /messaging/messages/900000002 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/messaging/messages/900000002\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /messaging/messages/900000002 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/messaging/messages/900000002`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /messaging/messages/900000002 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/messaging/messages/900000002\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /messaging/messages/900000002 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/messages/900000002\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /messaging/messages/900000002 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/messaging/messages/900000002\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/threads": { "get": { "operationId": "listThreads", "summary": "Wątki wiadomości", "tags": [ "Wiadomości" ], "description": "Rozmowy z kupującymi (pytania o oferty, zamówienia, zwroty), najnowsza pierwsza. Reklamacje i dyskusje są w `/sale/issues/{id}/chat`.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /messaging/threads.\n**Uprawnienie:** zakres `allegro:api:messaging:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "maximum": 4980, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–20, domyślnie 20).", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } } ], "responses": { "200": { "description": "Wątki.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MessageThreadList" }, "example": { "threads": [ { "id": "900000001", "read": false, "lastMessageDateTime": "2026-11-10T11:10:05.479Z", "interlocutor": { "login": "kupujacy_demo_4816f227", "avatarUrl": null }, "allee": { "kind": "QUESTION", "subject": "Pytanie o ofertę", "unreadCount": 1, "order": null, "offer": { "id": "900000000000021" }, "createdAt": "2026-11-10T11:10:05.478Z" } } ], "offset": 0, "limit": 20 } }, "application/json": { "schema": { "$ref": "#/components/schemas/MessageThreadList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /messaging/threads", "limitGroup": "read", "scope": "allegro:api:messaging:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/threads?limit=20&offset=0\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /messaging/threads (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/messaging/threads?limit=20&offset=0\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /messaging/threads (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/messaging/threads?limit=20&offset=0`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /messaging/threads (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/messaging/threads?limit=20&offset=0\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /messaging/threads (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/threads?limit=20&offset=0\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /messaging/threads (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/messaging/threads?limit=20&offset=0\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/threads/{threadId}": { "get": { "operationId": "getThread", "summary": "Wątek", "tags": [ "Wiadomości" ], "description": "Jeden wątek. Cudzy i nieistniejący → ta sama odpowiedź 404.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /messaging/threads/{threadId}.\n**Uprawnienie:** zakres `allegro:api:messaging:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "description": "Identyfikator wątku.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wątek.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MessageThread" }, "example": { "id": "900000001", "read": false, "lastMessageDateTime": "2026-11-10T11:10:05.479Z", "interlocutor": { "login": "kupujacy_demo_4816f227", "avatarUrl": null }, "allee": { "kind": "QUESTION", "subject": "Pytanie o ofertę", "unreadCount": 1, "order": null, "offer": { "id": "900000000000021" }, "createdAt": "2026-11-10T11:10:05.478Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/MessageThread" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /messaging/threads/{threadId}", "limitGroup": "read", "scope": "allegro:api:messaging:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/threads/900000001\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /messaging/threads/900000001 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/messaging/threads/900000001\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /messaging/threads/900000001 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/messaging/threads/900000001`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /messaging/threads/900000001 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/messaging/threads/900000001\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /messaging/threads/900000001 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/threads/900000001\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /messaging/threads/900000001 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/messaging/threads/900000001\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/threads/{threadId}/messages": { "get": { "operationId": "listMessages", "summary": "Wiadomości wątku", "tags": [ "Wiadomości" ], "description": "Najnowsza pierwsza.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /messaging/threads/{threadId}/messages.\n**Uprawnienie:** zakres `allegro:api:messaging:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "description": "Identyfikator wątku.", "schema": { "type": "string" } }, { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "maximum": 4980, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–20, domyślnie 20).", "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 20 } }, { "name": "before", "in": "query", "required": false, "description": "Wysłane przed.", "schema": { "type": "string", "format": "date-time" } }, { "name": "after", "in": "query", "required": false, "description": "Wysłane po.", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "Wiadomości.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MessageList" }, "example": { "messages": [ { "id": "900000001", "status": "DELIVERED", "type": "ASK_QUESTION", "createdAt": "2026-11-10T11:10:05.479Z", "thread": { "id": "900000001" }, "author": { "login": "kupujacy_demo_4816f227", "isInterlocutor": true }, "text": "Czy płyta ma polski lektor?", "subject": null, "relatesTo": { "offer": { "id": "900000000000021" }, "order": null }, "hasAdditionalAttachments": false, "attachments": [], "allee": { "sender": "BUYER", "reported": false } } ], "offset": 0, "limit": 20 } }, "application/json": { "schema": { "$ref": "#/components/schemas/MessageList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /messaging/threads/{threadId}/messages", "limitGroup": "read", "scope": "allegro:api:messaging:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/threads/900000001/messages?limit=20\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /messaging/threads/900000001/messages (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/messaging/threads/900000001/messages?limit=20\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /messaging/threads/900000001/messages (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/messaging/threads/900000001/messages?limit=20`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /messaging/threads/900000001/messages (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/messaging/threads/900000001/messages?limit=20\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /messaging/threads/900000001/messages (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/threads/900000001/messages?limit=20\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /messaging/threads/900000001/messages (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/messaging/threads/900000001/messages?limit=20\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "newMessageInThread", "summary": "Odpowiedź w wątku", "tags": [ "Wiadomości" ], "description": "Wysłanie odpowiedzi oznacza wątek jako przeczytany.\n\nTreść: bez linków zewnętrznych (422 `EXTERNAL_LINK`), filtr jak w panelu, najwyżej 20 wiadomości na godzinę wspólnie z panelem (429 `MESSAGE_LIMIT`). Bez załączników.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /messaging/threads/{threadId}/messages.\n**Uprawnienie:** zakres `allegro:api:messaging:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "description": "Identyfikator wątku.", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MessageInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/MessageInput" } } } }, "responses": { "201": { "description": "Wysłano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Message" }, "example": { "id": "900000002", "status": "DELIVERED", "type": "ASK_QUESTION", "createdAt": "2026-11-10T11:10:05.492Z", "thread": { "id": "900000001" }, "author": { "login": "sklep_przykladowy_0e60e9", "isInterlocutor": false }, "text": "Dzień dobry, tak — wydanie ma polskiego lektora i napisy.", "subject": null, "relatesTo": { "offer": { "id": "900000000000021" }, "order": null }, "hasAdditionalAttachments": false, "attachments": [], "allee": { "sender": "SELLER", "reported": false } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `ATTACHMENTS_NOT_SUPPORTED`, `CARD_DATA`, `EXTERNAL_LINK`, `JsonMappingException`, `PROFANITY`, `SENSITIVE_REQUEST`, `TEXT_EMPTY`, `TEXT_INVALID`, `TEXT_TOO_LONG`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `BUSY`, `MESSAGE_LIMIT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /messaging/threads/{threadId}/messages", "limitGroup": "write", "scope": "allegro:api:messaging:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "ATTACHMENTS_NOT_SUPPORTED" }, { "status": 422, "code": "CARD_DATA" }, { "status": 422, "code": "EXTERNAL_LINK" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "PROFANITY" }, { "status": 422, "code": "SENSITIVE_REQUEST" }, { "status": 422, "code": "TEXT_EMPTY" }, { "status": 422, "code": "TEXT_INVALID" }, { "status": 422, "code": "TEXT_TOO_LONG" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "BUSY" }, { "status": 429, "code": "MESSAGE_LIMIT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/threads/900000001/messages\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"text\": \"Dzień dobry, tak — wydanie ma polskiego lektora i napisy.\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Dzień dobry, tak — wydanie ma polskiego lektora i napisy.',\n];\n$ch = curl_init($base . '/messaging/threads/900000001/messages');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /messaging/threads/900000001/messages (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"text\": \"Dzień dobry, tak — wydanie ma polskiego lektora i napisy.\",\n}\nr = requests.request(\"POST\", BASE + \"/messaging/threads/900000001/messages\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /messaging/threads/900000001/messages (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"text\": \"Dzień dobry, tak — wydanie ma polskiego lektora i napisy.\"\n};\nconst res = await fetch(`${BASE}/messaging/threads/900000001/messages`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /messaging/threads/900000001/messages (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/messaging/threads/900000001/messages\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"text\": \"Dzień dobry, tak — wydanie ma polskiego lektora i napisy.\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /messaging/threads/900000001/messages (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"text\": \"Dzień dobry, tak — wydanie ma polskiego lektora i napisy.\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/threads/900000001/messages\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /messaging/threads/900000001/messages (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"text\": \"Dzień dobry, tak — wydanie ma polskiego lektora i napisy.\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/messaging/threads/900000001/messages\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/messaging/threads/{threadId}/read": { "put": { "operationId": "changeReadFlagOnThread", "summary": "Oznaczenie wątku jako przeczytany", "tags": [ "Wiadomości" ], "description": "Tylko `{\"read\": true}`.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /messaging/threads/{threadId}/read.\n**Uprawnienie:** zakres `allegro:api:messaging:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "threadId", "in": "path", "required": true, "description": "Identyfikator wątku.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "read": { "type": "boolean", "enum": [ true ] } }, "required": [ "read" ] } }, "application/json": { "schema": { "type": "object", "properties": { "read": { "type": "boolean", "enum": [ true ] } }, "required": [ "read" ] } } } }, "responses": { "200": { "description": "Wątek.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MessageThread" }, "example": { "id": "900000001", "read": true, "lastMessageDateTime": "2026-11-10T11:10:05.492Z", "interlocutor": { "login": "kupujacy_demo_4816f227", "avatarUrl": null }, "allee": { "kind": "QUESTION", "subject": "Pytanie o ofertę", "unreadCount": 0, "order": null, "offer": { "id": "900000000000021" }, "createdAt": "2026-11-10T11:10:05.478Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/MessageThread" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:messaging:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /messaging/threads/{threadId}/read", "limitGroup": "write", "scope": "allegro:api:messaging:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/messaging/threads/900000001/read\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"read\": true\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " true,\n];\n$ch = curl_init($base . '/messaging/threads/900000001/read');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /messaging/threads/900000001/read (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"read\": True,\n}\nr = requests.request(\"PUT\", BASE + \"/messaging/threads/900000001/read\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /messaging/threads/900000001/read (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"read\": true\n};\nconst res = await fetch(`${BASE}/messaging/threads/900000001/read`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /messaging/threads/900000001/read (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/messaging/threads/900000001/read\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"read\": true\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /messaging/threads/900000001/read (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"read\": true\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/messaging/threads/900000001/read\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /messaging/threads/900000001/read (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"read\": true\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/messaging/threads/900000001/read\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/openapi.json": { "get": { "operationId": "getOpenApiSpecification", "summary": "Specyfikacja OpenAPI 3.1", "tags": [ "Stan usługi" ], "description": "Ten dokument — opis wszystkich operacji, schematów, błędów, zakresów i limitów w formacie OpenAPI 3.1 (z przykładami kodu `x-codeSamples` w 7 językach). Zaimportuj go do Postmana, Insomnii albo generatora klientów (openapi-generator).\n\nBez tokenu. `ETag` + `If-None-Match` → 304; gzip, gdy klient go przyjmuje. Ten sam plik jest w portalu dla deweloperów.\n\n**Zgodność:** tylko allee.\n**Uwierzytelnienie:** brak.", "responses": { "200": { "description": "Specyfikacja.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "ETag": { "$ref": "#/components/headers/ETag" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "additionalProperties": true, "description": "Dokument OpenAPI 3.1." } }, "application/json": { "schema": { "type": "object", "additionalProperties": true, "description": "Dokument OpenAPI 3.1." } } } }, "304": { "description": "Bez zmian (If-None-Match).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "allee", "equivalent": "—", "limitGroup": "read", "errors": [ { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/openapi.json\" \\\n -H \"Accept: application/json\" \\\n -o openapi.json -w 'HTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\n$kod = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);\nif ($kod === 200) file_put_contents('openapi.json', $odp);\necho 'HTTP ', $kod, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /openapi.json (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/json\",\n}\nr = requests.request(\"GET\", BASE + \"/openapi.json\", headers=headers, timeout=60, allow_redirects=False)\nif r.status_code == 200:\n with open(\"openapi.json\", \"wb\") as f:\n f.write(r.content)\nprint(\"HTTP\", r.status_code)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /openapi.json (Node.js 18+, wbudowany fetch; plik .mjs)\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/openapi.json`, {\n method: \"GET\",\n headers: {\n \"Accept\": \"application/json\",\n },\n redirect: \"manual\",\n});\nif (res.status === 200) await writeFile(\"openapi.json\", Buffer.from(await res.arrayBuffer()));\nconsole.log(\"HTTP\", res.status);\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /openapi.json (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/openapi.json\");\nreq.Headers.Accept.ParseAdd(\"application/json\");\nusing var res = await http.SendAsync(req);\nif ((int)res.StatusCode == 200) File.WriteAllBytes(\"openapi.json\", await res.Content.ReadAsByteArrayAsync());\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /openapi.json (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.file.Path;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/openapi.json\"))\n .header(\"Accept\", \"application/json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofFile(Path.of(\"openapi.json\")));\n System.out.println(\"HTTP \" + res.statusCode());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /openapi.json (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/openapi.json\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"application/json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tif res.StatusCode == 200 {\n\t\tf, err := os.Create(\"openapi.json\")\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t\tdefer f.Close()\n\t\tif _, err := f.ReadFrom(res.Body); err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n}\n" } ] } }, "/order/carriers": { "get": { "operationId": "getOrdersCarriers", "summary": "Przewoźnicy", "tags": [ "Przesyłki" ], "description": "Stała lista kodów przewoźników do `POST …/shipments`. `ALLEGRO` i `OTHER` wymagają `carrierName`.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /order/carriers.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Przewoźnicy.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CarrierList" }, "example": { "carriers": [ { "id": "DPD", "name": "DPD" }, { "id": "INPOST", "name": "InPost" }, { "id": "ALLEGRO_PACZKOMATY", "name": "Allegro Paczkomaty InPost" }, { "id": "DHL", "name": "DHL" }, { "id": "GLS", "name": "GLS" }, { "id": "UPS", "name": "UPS" }, { "id": "FEDEX", "name": "FedEx" }, { "id": "TNT", "name": "TNT" }, { "id": "ORLEN_PACZKA", "name": "ORLEN Paczka" }, { "id": "POCZTEX", "name": "Pocztex" }, { "id": "POCZTA_POLSKA", "name": "Poczta Polska" }, { "id": "RUCH", "name": "Ruch" }, { "id": "ALLEGRO", "name": "Allegro (inny przewoźnik)" }, { "id": "OTHER", "name": "Inny przewoźnik" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CarrierList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /order/carriers", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/carriers\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/carriers (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/carriers\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/carriers (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/carriers`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/carriers (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/carriers\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/carriers (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/carriers\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/carriers (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/carriers\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/carriers/{carrierId}/tracking": { "get": { "operationId": "getOrdersCarriersTracking", "summary": "Śledzenie przesyłek", "tags": [ "Przesyłki" ], "description": "Historia statusów przesyłek Twoich zamówień (do 20 numerów naraz). Zakres `orders:read` albo `shipments:read`. Numer spoza Twoich zamówień → `trackingDetails: null`.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /order/carriers/{carrierId}/tracking.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "carrierId", "in": "path", "required": true, "description": "Kod przewoźnika (GET /order/carriers).", "schema": { "type": "string" } }, { "name": "waybill", "in": "query", "required": true, "description": "Numer przesyłki — powtórz parametr dla kilku (do 20).", "schema": { "type": "array", "items": { "type": "string", "maxLength": 64 }, "maxItems": 20 }, "style": "form", "explode": true } ], "responses": { "200": { "description": "Śledzenie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Tracking" }, "example": { "carrierId": "INPOST", "waybills": [ { "waybill": "620111222333444555495937", "trackingDetails": { "createdAt": "2026-11-10T11:10:05.446Z", "updatedAt": "2026-11-10T11:10:05.446Z", "statuses": [] }, "allee": { "trackingUrl": "https://inpost.pl/sledzenie-przesylek?number=620111222333444555495937" } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/Tracking" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CARRIER_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] }, { "oauth2": [ "allegro:api:shipments:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /order/carriers/{carrierId}/tracking", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "CARRIER_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/carriers/INPOST/tracking?waybill=620111222333444555495937\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/carriers/INPOST/tracking (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/carriers/INPOST/tracking?waybill=620111222333444555495937\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/carriers/INPOST/tracking (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/carriers/INPOST/tracking?waybill=620111222333444555495937`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/carriers/INPOST/tracking (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/carriers/INPOST/tracking?waybill=620111222333444555495937\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/carriers/INPOST/tracking (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/carriers/INPOST/tracking?waybill=620111222333444555495937\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/carriers/INPOST/tracking (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/carriers/INPOST/tracking?waybill=620111222333444555495937\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/checkout-forms": { "get": { "operationId": "getOrdersCheckoutForms", "summary": "Lista zamówień", "tags": [ "Zamówienia" ], "description": "Zamówienia złożone na allee.pl, od statusu `READY_FOR_PROCESSING` (wcześniej zamówienie dla sprzedawcy nie istnieje), najnowsze pierwsze.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Dane osobowe kupującego** (e-mail, telefon, adres) dostają: aplikacje sprzed kluczy (np. SelleeTools) oraz klucze i aplikacje z zakresem `allee:api:orders:pii`. Pozostali dostają te pola jako `null` (kształt odpowiedzi bez zmian).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /order/checkout-forms.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–100, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 } }, { "name": "status", "in": "query", "required": false, "description": "Status zakupu (inny niż READY_FOR_PROCESSING → pusta lista).", "schema": { "type": "string", "enum": [ "BOUGHT", "FILLED_IN", "READY_FOR_PROCESSING", "CANCELLED" ] } }, { "name": "fulfillment.status", "in": "query", "required": false, "description": "Status realizacji.", "schema": { "$ref": "#/components/schemas/FulfillmentStatus" } }, { "name": "updatedAt.gte", "in": "query", "required": false, "description": "Zmienione od (ISO 8601 ze strefą).", "schema": { "type": "string", "format": "date-time" } }, { "name": "updatedAt.lte", "in": "query", "required": false, "description": "Zmienione do.", "schema": { "type": "string", "format": "date-time" } }, { "name": "lineItems.boughtAt.gte", "in": "query", "required": false, "description": "Kupione od.", "schema": { "type": "string", "format": "date-time" } }, { "name": "lineItems.boughtAt.lte", "in": "query", "required": false, "description": "Kupione do.", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "Zamówienia.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CheckoutFormList" }, "example": { "checkoutForms": [ { "id": "718ce396-4940-431f-815e-7a51875c71df", "status": "READY_FOR_PROCESSING", "updatedAt": "2026-11-10T11:10:05.419Z", "revision": "3", "marketplace": { "id": "allee-pl" }, "messageToSeller": null, "buyer": { "id": "4000000001", "email": "kupujacy-980000001-4816f227@example.invalid", "login": "kupujacy_demo_4816f227", "firstName": null, "lastName": null, "companyName": null, "phoneNumber": "+48 500 000 000", "guest": false }, "payment": { "id": null, "type": "CASH_ON_DELIVERY", "provider": null, "finishedAt": null, "paidAmount": null }, "fulfillment": { "status": "NEW", "shipmentSummary": { "lineItemsSent": "NONE" } }, "delivery": { "method": { "id": "b79ba3f7-7782-4521-b863-eae15c6f58a4", "name": "DHL POP (punkt odbioru)" }, "address": { "firstName": "Jan", "lastName": "Przykładowy", "street": "ul. Przykładowa 1", "city": "Warszawa", "zipCode": "00-001", "countryCode": "PL", "companyName": null, "phoneNumber": "+48 500 000 000" }, "pickupPoint": null, "cost": { "amount": "12.99", "currency": "PLN" }, "time": null, "smart": false, "calculatedNumberOfPackages": 1 }, "invoice": { "required": false, "address": null }, "lineItems": [ { "id": "3ce60978-f8b3-45de-9a31-6bf12fdc1417", "offer": { "id": "900000000000001", "name": "Produkt demo 01 – Projekty wnętrz", "external": { "id": "DEMO-01" } }, "quantity": 1, "originalPrice": { "amount": "19.99", "currency": "PLN" }, "price": { "amount": "19.99", "currency": "PLN" }, "tax": { "rate": "23.00" }, "boughtAt": "2026-11-10T11:10:05.418Z" } ], "summary": { "totalToPay": { "amount": "32.98", "currency": "PLN" } }, "allee": { "test": false, "commission": { "amount": "0.00", "currency": "PLN", "rate": "0.00", "base": "PRODUCTS", "final": true, "priceListVersion": "2026-11-09" } } }, { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "status": "READY_FOR_PROCESSING", "updatedAt": "2026-11-10T11:10:05.412Z", "revision": "3", "marketplace": { "id": "allee-pl" }, "messageToSeller": "Proszę o staranne zapakowanie.", "buyer": { "id": "4000000001", "email": "kupujacy-980000001-4816f227@example.invalid", "login": "kupujacy_demo_4816f227", "firstName": null, "lastName": null, "companyName": "Firma Przykładowa", "phoneNumber": "+48 500 000 000", "guest": false }, "payment": { "id": "sandbox-9ba7f15b-69a9-43f0-96dd-6fa7cfffc7cc", "type": "ONLINE", "provider": "SANDBOX", "finishedAt": "2026-11-10T11:10:05.000Z", "paidAmount": { "amount": "98.79", "currency": "PLN" } }, "fulfillment": { "status": "NEW", "shipmentSummary": { "lineItemsSent": "NONE" } }, "delivery": { "method": { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f", "name": "InPost Paczkomat 24/7" }, "address": { "firstName": "Jan", "lastName": "Przykładowy", "street": "ul. Przykładowa 1", "city": "Warszawa", "zipCode": "00-001", "countryCode": "PL", "companyName": "Firma Przykładowa", "phoneNumber": "+48 500 000 000" }, "pickupPoint": null, "cost": { "amount": "12.99", "currency": "PLN" }, "time": null, "smart": false, "calculatedNumberOfPackages": 1 }, "invoice": { "required": true, "address": { "street": null, "city": null, "zipCode": null, "countryCode": null, "company": { "name": "Firma Przykładowa", "taxId": "1234563218" } } }, "lineItems": [ { "id": "2d9680b4-9cb7-4096-9428-8c1ceb2790c2", "offer": { "id": "900000000000021", "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "external": { "id": "FILM-21ef85-1" } }, "quantity": 2, "originalPrice": { "amount": "44.90", "currency": "PLN" }, "price": { "amount": "42.90", "currency": "PLN" }, "tax": { "rate": "23.00" }, "boughtAt": "2026-11-10T11:10:05.411Z" } ], "summary": { "totalToPay": { "amount": "98.79", "currency": "PLN" } }, "allee": { "test": false, "commission": { "amount": "0.00", "currency": "PLN", "rate": "0.00", "base": "PRODUCTS", "final": true, "priceListVersion": "2026-11-09" } } } ], "count": 2, "totalCount": 2 } }, "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutFormList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /order/checkout-forms", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms?status=READY_FOR_PROCESSING&fulfillment.status=NEW&limit=50\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/checkout-forms (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/checkout-forms?status=READY_FOR_PROCESSING&fulfillment.status=NEW&limit=50\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/checkout-forms (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/checkout-forms?status=READY_FOR_PROCESSING&fulfillment.status=NEW&limit=50`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/checkout-forms (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/checkout-forms?status=READY_FOR_PROCESSING&fulfillment.status=NEW&limit=50\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/checkout-forms (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms?status=READY_FOR_PROCESSING&fulfillment.status=NEW&limit=50\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/checkout-forms (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/checkout-forms?status=READY_FOR_PROCESSING&fulfillment.status=NEW&limit=50\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/checkout-forms/{checkoutFormId}": { "get": { "operationId": "getOrdersCheckoutForm", "summary": "Zamówienie", "tags": [ "Zamówienia" ], "description": "Pełne zamówienie. `revision` rośnie przy każdej zmianie statusu. Imię i nazwisko odbiorcy są w `delivery.address` (`buyer.firstName/lastName` zawsze null).\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Dane osobowe kupującego** (e-mail, telefon, adres) dostają: aplikacje sprzed kluczy (np. SelleeTools) oraz klucze i aplikacje z zakresem `allee:api:orders:pii`. Pozostali dostają te pola jako `null` (kształt odpowiedzi bez zmian).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /order/checkout-forms/{id}.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Zamówienie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CheckoutForm" }, "example": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "status": "READY_FOR_PROCESSING", "updatedAt": "2026-11-10T11:10:05.412Z", "revision": "3", "marketplace": { "id": "allee-pl" }, "messageToSeller": "Proszę o staranne zapakowanie.", "buyer": { "id": "4000000001", "email": "kupujacy-980000001-4816f227@example.invalid", "login": "kupujacy_demo_4816f227", "firstName": null, "lastName": null, "companyName": "Firma Przykładowa", "phoneNumber": "+48 500 000 000", "guest": false }, "payment": { "id": "sandbox-9ba7f15b-69a9-43f0-96dd-6fa7cfffc7cc", "type": "ONLINE", "provider": "SANDBOX", "finishedAt": "2026-11-10T11:10:05.000Z", "paidAmount": { "amount": "98.79", "currency": "PLN" } }, "fulfillment": { "status": "NEW", "shipmentSummary": { "lineItemsSent": "NONE" } }, "delivery": { "method": { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f", "name": "InPost Paczkomat 24/7" }, "address": { "firstName": "Jan", "lastName": "Przykładowy", "street": "ul. Przykładowa 1", "city": "Warszawa", "zipCode": "00-001", "countryCode": "PL", "companyName": "Firma Przykładowa", "phoneNumber": "+48 500 000 000" }, "pickupPoint": null, "cost": { "amount": "12.99", "currency": "PLN" }, "time": null, "smart": false, "calculatedNumberOfPackages": 1 }, "invoice": { "required": true, "address": { "street": null, "city": null, "zipCode": null, "countryCode": null, "company": { "name": "Firma Przykładowa", "taxId": "1234563218" } } }, "lineItems": [ { "id": "2d9680b4-9cb7-4096-9428-8c1ceb2790c2", "offer": { "id": "900000000000021", "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "external": { "id": "FILM-21ef85-1" } }, "quantity": 2, "originalPrice": { "amount": "44.90", "currency": "PLN" }, "price": { "amount": "42.90", "currency": "PLN" }, "tax": { "rate": "23.00" }, "boughtAt": "2026-11-10T11:10:05.411Z" } ], "summary": { "totalToPay": { "amount": "98.79", "currency": "PLN" } }, "allee": { "test": false, "commission": { "amount": "0.00", "currency": "PLN", "rate": "0.00", "base": "PRODUCTS", "final": true, "priceListVersion": "2026-11-09" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/CheckoutForm" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /order/checkout-forms/{id}", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/checkout-forms/{checkoutFormId}/fulfillment": { "put": { "operationId": "setOrderFulfillmentStatus", "summary": "Status realizacji zamówienia", "tags": [ "Zamówienia" ], "description": "Zmiana statusu realizacji — **tylko do przodu** (wolno przeskakiwać etapy). `SENT` wymaga wcześniej dodanej przesyłki (`POST …/shipments`). Ten sam status co obecny → 204 bez skutków.\n\n`SUSPENDED` i `RETURNED` ustawia wyłącznie allee (403 `FORBIDDEN_SOURCE`). Anulowanie (`CANCELLED`) tylko przed `SENT`. Opcjonalne `checkoutForm.revision`: inna niż bieżąca → 409 `REVISION_MISMATCH`.\n\n`details.current` = bieżący status przy `FORBIDDEN_SOURCE`, `SHIPMENT_REQUIRED` i `INVALID_STATUS_TRANSITION` (przy `REVISION_MISMATCH` jest `null`).\n\n**409 — dwa różne przypadki:** `INVALID_STATUS_TRANSITION` = zamówienie jest już na tym etapie albo dalej (ustawienie wcześniejszego etapu, np. `PROCESSING` po `SENT`, możesz uznać za osiągnięte; ale `CANCELLED` po `SENT` to **nie** sukces — zamówienia nie da się już anulować); `REVISION_MISMATCH` = zamówienie zmieniło się od pobrania — pobierz je ponownie i zdecyduj jeszcze raz.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /order/checkout-forms/{id}/fulfillment.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } }, { "name": "checkoutForm.revision", "in": "query", "required": false, "description": "Oczekiwana rewizja zamówienia (optymistyczna blokada).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/FulfillmentInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/FulfillmentInput" } } } }, "responses": { "204": { "description": "Zmieniono (albo ten sam status).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `FORBIDDEN_SOURCE`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `INVALID_STATUS_TRANSITION`, `ORDER_NOT_READY`, `REVISION_MISMATCH`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `ConstraintViolationException.MissingRequiredParameters`, `INVALID_STATUS`, `JsonMappingException`, `SHIPMENT_REQUIRED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /order/checkout-forms/{id}/fulfillment", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "FORBIDDEN_SOURCE" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "INVALID_STATUS_TRANSITION" }, { "status": 409, "code": "ORDER_NOT_READY" }, { "status": 409, "code": "REVISION_MISMATCH" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "ConstraintViolationException.MissingRequiredParameters" }, { "status": 422, "code": "INVALID_STATUS" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "SHIPMENT_REQUIRED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"status\": \"PROCESSING\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'PROCESSING',\n];\n$ch = curl_init($base . '/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"status\": \"PROCESSING\",\n}\nr = requests.request(\"PUT\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"status\": \"PROCESSING\"\n};\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"status\": \"PROCESSING\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"status\": \"PROCESSING\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"status\": \"PROCESSING\"\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/fulfillment\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/checkout-forms/{checkoutFormId}/invoices": { "get": { "operationId": "getOrderInvoicesDetails", "summary": "Faktury zamówienia", "tags": [ "Faktury" ], "description": "Faktury dodane do zamówienia (pliki PDF i linki). Plik pobierzesz podpisanym adresem `allee.downloadUrl` (ważny 5 minut). Kupujący widzi „Pobierz fakturę” w swoim koncie.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /order/checkout-forms/{id}/invoices.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Faktury.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/InvoiceList" }, "example": { "invoices": [ { "id": "5551b5a7-3e2e-4cba-b80d-d34fd7e286ae", "invoiceNumber": "FV/1/11/2026", "createdAt": "2026-11-10T11:10:05.457Z", "file": { "id": "5551b5a7-3e2e-4cba-b80d-d34fd7e286ae", "name": "FV-1-11-2026.pdf", "uploadedAt": "2026-11-10T11:10:05.461Z", "securityVerification": { "status": "ACCEPTED", "passedChecks": [ "PDF_HEADER", "PDF_EOF", "NO_ACTIVE_CONTENT", "COMPRESSED_STREAMS_SCANNED", "MAX_SIZE_3MB" ], "failedChecks": [] } }, "allee": { "type": "FILE", "status": "READY", "size": 622, "url": null, "downloadUrl": "https://api.allee.pl/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…", "downloadUrlExpiresAt": "2026-11-10T11:15:05.000Z" } }, { "id": "68df84ab-298c-4fa5-aaf9-30b90f3af67a", "invoiceNumber": "FK/1/11/2026", "createdAt": "2026-11-10T11:10:05.465Z", "file": { "id": "68df84ab-298c-4fa5-aaf9-30b90f3af67a", "name": "2026.pdf", "uploadedAt": "2026-11-10T11:10:05.465Z", "securityVerification": { "status": "ACCEPTED", "passedChecks": [ "PDF_HEADER", "PDF_EOF", "NO_ACTIVE_CONTENT", "COMPRESSED_STREAMS_SCANNED", "MAX_SIZE_3MB" ], "failedChecks": [] } }, "allee": { "type": "FILE", "status": "READY", "size": 622, "url": null, "downloadUrl": "https://api.allee.pl/allee/billing-documents/68df84ab-298c-4fa5-aaf9-30b90f3af67a/file?expires=1794309305&mode=test&signature=…", "downloadUrlExpiresAt": "2026-11-10T11:15:05.000Z" } }, { "id": "269a4823-f164-4ed9-8567-571fda81ad5d", "invoiceNumber": "FV/2/11/2026", "createdAt": "2026-11-10T11:10:05.468Z", "file": null, "allee": { "type": "LINK", "status": "READY", "size": null, "url": "https://faktury.example.com/fv/2-11-2026", "downloadUrl": null, "downloadUrlExpiresAt": null } } ], "hasExternalInvoices": true } }, "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /order/checkout-forms/{id}/invoices", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "addOrderInvoicesMetadata", "summary": "Faktura — zapowiedź (krok 1 z 2)", "tags": [ "Faktury" ], "description": "Jak Allegro: najpierw zapowiedź faktury (nazwa pliku, numer), potem plik `PUT …/invoices/{invoiceId}/file`. Najwyżej 10 faktur na zamówienie.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /order/checkout-forms/{id}/invoices.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/InvoiceCreate" } }, "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceCreate" } } } }, "responses": { "201": { "description": "Zapowiedziano — teraz wgraj plik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/InvoiceCreated" }, "example": { "id": "5551b5a7-3e2e-4cba-b80d-d34fd7e286ae" } }, "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceCreated" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `ConstraintViolationException.MissingRequiredParameters`, `JsonMappingException`, `TOO_MANY_INVOICES`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /order/checkout-forms/{id}/invoices", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "ConstraintViolationException.MissingRequiredParameters" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "TOO_MANY_INVOICES" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"file\": {\n \"name\": \"FV-1-11-2026.pdf\"\n },\n \"invoiceNumber\": \"FV/1/11/2026\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'name' => 'FV-1-11-2026.pdf',\n ],\n 'invoiceNumber' => 'FV/1/11/2026',\n];\n$ch = curl_init($base . '/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"file\": {\n \"name\": \"FV-1-11-2026.pdf\",\n },\n \"invoiceNumber\": \"FV/1/11/2026\",\n}\nr = requests.request(\"POST\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"file\": {\n \"name\": \"FV-1-11-2026.pdf\"\n },\n \"invoiceNumber\": \"FV/1/11/2026\"\n};\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"file\": {\n \"name\": \"FV-1-11-2026.pdf\"\n },\n \"invoiceNumber\": \"FV/1/11/2026\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"file\": {\n \"name\": \"FV-1-11-2026.pdf\"\n },\n \"invoiceNumber\": \"FV/1/11/2026\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"file\": {\n \"name\": \"FV-1-11-2026.pdf\"\n },\n \"invoiceNumber\": \"FV/1/11/2026\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/checkout-forms/{checkoutFormId}/invoices/{invoiceId}/file": { "put": { "operationId": "uploadOrderInvoiceFile", "summary": "Faktura — plik PDF (krok 2 z 2)", "tags": [ "Faktury" ], "description": "Treść żądania = **plik PDF** (`Content-Type: application/pdf`, do 3 MB). Sprawdzamy nagłówek i zakończenie PDF oraz brak treści aktywnych (JavaScript, akcje) — wynik w `file.securityVerification`. Plik trafia do magazynu poza serwerem WWW.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } }, { "name": "invoiceId", "in": "path", "required": true, "description": "Identyfikator faktury z kroku 1.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "description": "Plik PDF faktury.", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } } } }, "responses": { "200": { "description": "Plik przyjęty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Invoice" }, "example": { "id": "5551b5a7-3e2e-4cba-b80d-d34fd7e286ae", "invoiceNumber": "FV/1/11/2026", "createdAt": "2026-11-10T11:10:05.457Z", "file": { "id": "5551b5a7-3e2e-4cba-b80d-d34fd7e286ae", "name": "FV-1-11-2026.pdf", "uploadedAt": "2026-11-10T11:10:05.461Z", "securityVerification": { "status": "ACCEPTED", "passedChecks": [ "PDF_HEADER", "PDF_EOF", "NO_ACTIVE_CONTENT", "COMPRESSED_STREAMS_SCANNED", "MAX_SIZE_3MB" ], "failedChecks": [] } }, "allee": { "type": "FILE", "status": "READY", "size": 622, "url": null, "downloadUrl": "https://api.allee.pl/allee/billing-documents/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file?expires=1794309305&mode=test&signature=…", "downloadUrlExpiresAt": "2026-11-10T11:15:05.000Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Invoice" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `INVOICE_FILE_ALREADY_UPLOADED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `BUSY`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`, `STORAGE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /order/checkout-forms/{id}/invoices/{invoiceId}/file", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "INVOICE_FILE_ALREADY_UPLOADED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "BUSY" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" }, { "status": 503, "code": "STORAGE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/pdf\" \\\n --data-binary @faktura.pdf \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/pdf',\n ],\n CURLOPT_POSTFIELDS => file_get_contents('faktura.pdf'),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/pdf\",\n}\nwith open(\"faktura.pdf\", \"rb\") as f:\n plik = f.read()\nr = requests.request(\"PUT\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file\", headers=headers, data=plik, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Node.js 18+, wbudowany fetch; plik .mjs)\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/pdf\",\n },\n body: await readFile(\"faktura.pdf\"),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nreq.Content = new ByteArrayContent(File.ReadAllBytes(\"faktura.pdf\"));\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/pdf\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.file.Path;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/pdf\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofFile(Path.of(\"faktura.pdf\")))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tplik, err := os.ReadFile(\"faktura.pdf\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq, err := http.NewRequest(\"PUT\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/invoices/5551b5a7-3e2e-4cba-b80d-d34fd7e286ae/file\", bytes.NewReader(plik))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/pdf\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/checkout-forms/{checkoutFormId}/shipments": { "get": { "operationId": "getOrderShipments", "summary": "Przesyłki zamówienia", "tags": [ "Przesyłki" ], "description": "Numery przesyłek dodane do zamówienia.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /order/checkout-forms/{id}/shipments.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Przesyłki.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShipmentList" }, "example": { "shipments": [ { "id": "120b3099-c95e-4765-b44e-8f1e3f67ee8c", "waybill": "620111222333444555495937", "carrierId": "INPOST", "carrierName": "InPost", "lineItems": [ { "id": "2d9680b4-9cb7-4096-9428-8c1ceb2790c2", "quantity": 2 } ], "createdAt": "2026-11-10T11:10:05.446Z", "allee": { "trackingUrl": "https://inpost.pl/sledzenie-przesylek?number=620111222333444555495937", "warnings": [] } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShipmentList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /order/checkout-forms/{id}/shipments", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createOrderShipments", "summary": "Dodanie numeru przesyłki", "tags": [ "Przesyłki" ], "description": "Numer przesyłki (bez zmiany statusu — `SENT` ustawiasz osobno). Brak `lineItems` = całe zamówienie; `lineItems[].quantity` (allee) = część sztuk pozycji.\n\n**Idempotentne:** ta sama para (`carrierId`, `waybill`) w zamówieniu → 200 z istniejącą przesyłką. Paczki InPost allee śledzi samo i ustawia `SENT`/`PICKED_UP`.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST /order/checkout-forms/{id}/shipments.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShipmentInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShipmentInput" } } } }, "responses": { "200": { "description": "Ta przesyłka już była.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Shipment" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Shipment" } } } }, "201": { "description": "Dodano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Shipment" }, "example": { "id": "120b3099-c95e-4765-b44e-8f1e3f67ee8c", "waybill": "620111222333444555495937", "carrierId": "INPOST", "carrierName": "InPost", "lineItems": [ { "id": "2d9680b4-9cb7-4096-9428-8c1ceb2790c2", "quantity": 2 } ], "createdAt": "2026-11-10T11:10:05.446Z", "allee": { "trackingUrl": "https://inpost.pl/sledzenie-przesylek?number=620111222333444555495937", "warnings": [] } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Shipment" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `ORDER_CLOSED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `CARRIER_NAME_REQUIRED`, `CARRIER_NOT_FOUND`, `ConstraintViolationException.MissingRequiredParameters`, `INVALID_QUANTITY`, `INVALID_WAYBILL`, `JsonMappingException`, `LINE_ITEM_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST /order/checkout-forms/{id}/shipments", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "ORDER_CLOSED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "CARRIER_NAME_REQUIRED" }, { "status": 422, "code": "CARRIER_NOT_FOUND" }, { "status": 422, "code": "ConstraintViolationException.MissingRequiredParameters" }, { "status": 422, "code": "INVALID_QUANTITY" }, { "status": 422, "code": "INVALID_WAYBILL" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LINE_ITEM_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"carrierId\": \"INPOST\",\n \"waybill\": \"620111222333444555495937\",\n \"lineItems\": [\n {\n \"id\": \"2d9680b4-9cb7-4096-9428-8c1ceb2790c2\"\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'INPOST',\n 'waybill' => '620111222333444555495937',\n 'lineItems' => [\n [\n 'id' => '2d9680b4-9cb7-4096-9428-8c1ceb2790c2',\n ],\n ],\n];\n$ch = curl_init($base . '/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"carrierId\": \"INPOST\",\n \"waybill\": \"620111222333444555495937\",\n \"lineItems\": [\n {\n \"id\": \"2d9680b4-9cb7-4096-9428-8c1ceb2790c2\",\n },\n ],\n}\nr = requests.request(\"POST\", BASE + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"carrierId\": \"INPOST\",\n \"waybill\": \"620111222333444555495937\",\n \"lineItems\": [\n {\n \"id\": \"2d9680b4-9cb7-4096-9428-8c1ceb2790c2\"\n }\n ]\n};\nconst res = await fetch(`${BASE}/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"carrierId\": \"INPOST\",\n \"waybill\": \"620111222333444555495937\",\n \"lineItems\": [\n {\n \"id\": \"2d9680b4-9cb7-4096-9428-8c1ceb2790c2\"\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"carrierId\": \"INPOST\",\n \"waybill\": \"620111222333444555495937\",\n \"lineItems\": [\n {\n \"id\": \"2d9680b4-9cb7-4096-9428-8c1ceb2790c2\"\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"carrierId\": \"INPOST\",\n \"waybill\": \"620111222333444555495937\",\n \"lineItems\": [\n {\n \"id\": \"2d9680b4-9cb7-4096-9428-8c1ceb2790c2\"\n }\n ]\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/order/checkout-forms/432810d0-4d26-4f39-ba5f-b89def4d4f92/shipments\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/customer-returns": { "get": { "operationId": "getCustomerReturns", "summary": "Zwroty", "tags": [ "Zwroty" ], "description": "Zwroty zamówień allee.pl. Zasób BETA jak w Allegro: `Accept: application/vnd.allegro.beta.v1+json` (przyjmujemy też typ public). E-mail kupującego tylko z zakresem `allee:api:orders:pii`.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /order/customer-returns (BETA).\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "maximum": 10000, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–100, domyślnie 50).", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 50 } }, { "name": "createdAt.gte", "in": "query", "required": false, "description": "Od.", "schema": { "type": "string", "format": "date-time" } }, { "name": "createdAt.lte", "in": "query", "required": false, "description": "Do.", "schema": { "type": "string", "format": "date-time" } }, { "name": "status", "in": "query", "required": false, "description": "Status.", "schema": { "type": "string", "enum": [ "CREATED", "IN_TRANSIT", "DELIVERED", "FINISHED", "REJECTED", "COMMISSION_REFUND_CLAIMED", "COMMISSION_REFUNDED" ] } }, { "name": "orderId", "in": "query", "required": false, "description": "Zamówienie.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Zwroty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturnList" }, "example": { "customerReturns": [ { "id": "ZW-900000001", "createdAt": "2026-11-10T11:10:05.511Z", "referenceNumber": "ZW-900000001", "orderId": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "buyer": { "login": "kupujacy_demo_4816f227", "email": "kupujacy-980000001-4816f227@example.invalid" }, "items": [ { "offerId": "900000000000021", "quantity": 2, "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "price": { "amount": "42.90", "currency": "PLN" }, "reason": { "type": null, "userComment": "Nie spełnia oczekiwań — Zwrot testowy z symulatora sandboxu." } } ], "parcels": [], "marketplaceId": "allee-pl", "status": "CREATED", "refund": null, "rejection": null } ], "count": 1, "totalCount": 1 } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturnList" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReturnList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `SERVICE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /order/customer-returns (BETA)", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "SERVICE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/customer-returns?limit=50\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/customer-returns (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/customer-returns?limit=50\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/customer-returns (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/customer-returns?limit=50`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/customer-returns (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/customer-returns?limit=50\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/customer-returns (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/customer-returns?limit=50\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/customer-returns (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/customer-returns?limit=50\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/customer-returns/{customerReturnId}": { "get": { "operationId": "getCustomerReturn", "summary": "Zwrot", "tags": [ "Zwroty" ], "description": "Jeden zwrot. Cudzy i nieistniejący → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /order/customer-returns/{customerReturnId} (BETA).\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "customerReturnId", "in": "path", "required": true, "description": "Numer zwrotu ZW-…", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Zwrot.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" }, "example": { "id": "ZW-900000001", "createdAt": "2026-11-10T11:10:05.511Z", "referenceNumber": "ZW-900000001", "orderId": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "buyer": { "login": "kupujacy_demo_4816f227", "email": "kupujacy-980000001-4816f227@example.invalid" }, "items": [ { "offerId": "900000000000021", "quantity": 2, "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "price": { "amount": "42.90", "currency": "PLN" }, "reason": { "type": null, "userComment": "Nie spełnia oczekiwań — Zwrot testowy z symulatora sandboxu." } } ], "parcels": [], "marketplaceId": "allee-pl", "status": "CREATED", "refund": null, "rejection": null } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /order/customer-returns/{customerReturnId} (BETA)", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/customer-returns/ZW-900000001\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/customer-returns/ZW-900000001 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/customer-returns/ZW-900000001\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/customer-returns/ZW-900000001 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/customer-returns/ZW-900000001`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/customer-returns/ZW-900000001 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/customer-returns/ZW-900000001\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/customer-returns/ZW-900000001 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/customer-returns/ZW-900000001\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/customer-returns/ZW-900000001 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/customer-returns/ZW-900000001\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateCustomerReturn", "summary": "Zwrot dotarł / deklaracja zwrotu pieniędzy", "tags": [ "Zwroty" ], "description": "`{\"status\": \"DELIVERED\"}` = paczka zwrotna dotarła. `{\"allee\": {\"refund\": {\"value\": {...}}}}` = **deklaracja** zwrotu pieniędzy (kończy zwrot — allee nie przenosi pieniędzy; kwota 0,01 zł … produkty + dostawa). Oba pola naraz: najpierw DELIVERED, potem zakończenie.\n\n**Zgodność:** tylko allee — Rozszerzenie allee (Allegro: /payments/refunds).\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "customerReturnId", "in": "path", "required": true, "description": "Numer zwrotu ZW-…", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturnUpdate" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturnUpdate" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReturnUpdate" } } } }, "responses": { "200": { "description": "Zwrot po zmianie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" }, "example": { "id": "ZW-900000001", "createdAt": "2026-11-10T11:10:05.511Z", "referenceNumber": "ZW-900000001", "orderId": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "buyer": { "login": "kupujacy_demo_4816f227", "email": "kupujacy-980000001-4816f227@example.invalid" }, "items": [ { "offerId": "900000000000021", "quantity": 2, "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "price": { "amount": "42.90", "currency": "PLN" }, "reason": { "type": null, "userComment": "Nie spełnia oczekiwań — Zwrot testowy z symulatora sandboxu." } } ], "parcels": [], "marketplaceId": "allee-pl", "status": "FINISHED", "refund": { "value": { "amount": "89.80", "currency": "PLN" } }, "rejection": null } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `CUSTOMER_RETURN_ALREADY_FINISHED`, `INVALID_STATUS_TRANSITION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Rozszerzenie allee (Allegro: /payments/refunds)", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "CUSTOMER_RETURN_ALREADY_FINISHED" }, { "status": 409, "code": "INVALID_STATUS_TRANSITION" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/order/customer-returns/ZW-900000001\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"status\": \"DELIVERED\",\n \"allee\": {\n \"refund\": {\n \"value\": {\n \"amount\": \"89.80\",\n \"currency\": \"PLN\"\n }\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELIVERED',\n 'allee' => [\n 'refund' => [\n 'value' => [\n 'amount' => '89.80',\n 'currency' => 'PLN',\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/order/customer-returns/ZW-900000001');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /order/customer-returns/ZW-900000001 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"status\": \"DELIVERED\",\n \"allee\": {\n \"refund\": {\n \"value\": {\n \"amount\": \"89.80\",\n \"currency\": \"PLN\",\n },\n },\n },\n}\nr = requests.request(\"PUT\", BASE + \"/order/customer-returns/ZW-900000001\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /order/customer-returns/ZW-900000001 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"status\": \"DELIVERED\",\n \"allee\": {\n \"refund\": {\n \"value\": {\n \"amount\": \"89.80\",\n \"currency\": \"PLN\"\n }\n }\n }\n};\nconst res = await fetch(`${BASE}/order/customer-returns/ZW-900000001`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /order/customer-returns/ZW-900000001 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/order/customer-returns/ZW-900000001\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nvar json = \"\"\"\n{\n \"status\": \"DELIVERED\",\n \"allee\": {\n \"refund\": {\n \"value\": {\n \"amount\": \"89.80\",\n \"currency\": \"PLN\"\n }\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /order/customer-returns/ZW-900000001 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"status\": \"DELIVERED\",\n \"allee\": {\n \"refund\": {\n \"value\": {\n \"amount\": \"89.80\",\n \"currency\": \"PLN\"\n }\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/customer-returns/ZW-900000001\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /order/customer-returns/ZW-900000001 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"status\": \"DELIVERED\",\n \"allee\": {\n \"refund\": {\n \"value\": {\n \"amount\": \"89.80\",\n \"currency\": \"PLN\"\n }\n }\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/order/customer-returns/ZW-900000001\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/customer-returns/{customerReturnId}/rejection": { "post": { "operationId": "rejectCustomerReturnRefund", "summary": "Odrzucenie zwrotu", "tags": [ "Zwroty" ], "description": "Kupujący widzi status „Odrzucony” i uzasadnienie. Ponowne odrzucenie → 409.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /order/customer-returns/{customerReturnId}/rejection (BETA).\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "customerReturnId", "in": "path", "required": true, "description": "Numer zwrotu ZW-…", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturnRejection" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturnRejection" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReturnRejection" } } } }, "responses": { "200": { "description": "Odrzucono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" }, "example": { "id": "ZW-900000002", "createdAt": "2026-11-10T11:10:05.537Z", "referenceNumber": "ZW-900000002", "orderId": "718ce396-4940-431f-815e-7a51875c71df", "buyer": { "login": "kupujacy_demo_4816f227", "email": "kupujacy-980000001-4816f227@example.invalid" }, "items": [ { "offerId": "900000000000001", "quantity": 1, "name": "Produkt demo 01 – Projekty wnętrz", "price": { "amount": "19.99", "currency": "PLN" }, "reason": { "type": null, "userComment": "Inny wariant niż zamówiony — Zwrot testowy z symulatora sandboxu." } } ], "parcels": [], "marketplaceId": "allee-pl", "status": "REJECTED", "refund": null, "rejection": { "reason": "Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem." } } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CustomerReturn" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `CUSTOMER_RETURN_ALREADY_REJECTED`, `INVALID_STATUS_TRANSITION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `CARD_DATA`, `ConstraintViolationException.MissingRequiredParameters`, `EXTERNAL_LINK`, `JsonMappingException`, `PROFANITY`, `SENSITIVE_REQUEST`, `TEXT_EMPTY`, `TEXT_INVALID`, `TEXT_TOO_LONG`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /order/customer-returns/{customerReturnId}/rejection (BETA)", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "CUSTOMER_RETURN_ALREADY_REJECTED" }, { "status": 409, "code": "INVALID_STATUS_TRANSITION" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "CARD_DATA" }, { "status": 422, "code": "ConstraintViolationException.MissingRequiredParameters" }, { "status": 422, "code": "EXTERNAL_LINK" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "PROFANITY" }, { "status": 422, "code": "SENSITIVE_REQUEST" }, { "status": 422, "code": "TEXT_EMPTY" }, { "status": 422, "code": "TEXT_INVALID" }, { "status": 422, "code": "TEXT_TOO_LONG" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/order/customer-returns/ZW-900000002/rejection\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"rejection\": {\n \"code\": \"REFUND_REJECTED\",\n \"reason\": \"Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'code' => 'REFUND_REJECTED',\n 'reason' => 'Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.',\n ],\n];\n$ch = curl_init($base . '/order/customer-returns/ZW-900000002/rejection');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /order/customer-returns/ZW-900000002/rejection (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"rejection\": {\n \"code\": \"REFUND_REJECTED\",\n \"reason\": \"Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/order/customer-returns/ZW-900000002/rejection\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /order/customer-returns/ZW-900000002/rejection (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"rejection\": {\n \"code\": \"REFUND_REJECTED\",\n \"reason\": \"Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.\"\n }\n};\nconst res = await fetch(`${BASE}/order/customer-returns/ZW-900000002/rejection`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /order/customer-returns/ZW-900000002/rejection (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/order/customer-returns/ZW-900000002/rejection\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nvar json = \"\"\"\n{\n \"rejection\": {\n \"code\": \"REFUND_REJECTED\",\n \"reason\": \"Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /order/customer-returns/ZW-900000002/rejection (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"rejection\": {\n \"code\": \"REFUND_REJECTED\",\n \"reason\": \"Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/customer-returns/ZW-900000002/rejection\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /order/customer-returns/ZW-900000002/rejection (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"rejection\": {\n \"code\": \"REFUND_REJECTED\",\n \"reason\": \"Odesłany produkt nosi ślady używania — zwrot pieniędzy pomniejszony zgodnie z regulaminem.\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/order/customer-returns/ZW-900000002/rejection\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/event-stats": { "get": { "operationId": "getOrderEventsStatistics", "summary": "Ostatnie zdarzenie zamówień", "tags": [ "Zamówienia" ], "description": "Id i czas ostatniego zdarzenia — punkt startowy kursora `from`.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /order/event-stats.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Ostatnie zdarzenie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OrderEventStats" }, "example": { "latestEvent": { "id": "60", "occurredAt": "2026-11-10T11:09:55.419Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/OrderEventStats" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /order/event-stats", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/event-stats\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/event-stats (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/event-stats\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/event-stats (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/event-stats`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/event-stats (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/event-stats\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/event-stats (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/event-stats\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/event-stats (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/event-stats\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/events": { "get": { "operationId": "getOrderEvents", "summary": "Zdarzenia zamówień", "tags": [ "Zamówienia" ], "description": "Dziennik zdarzeń zamówień — podstawa synchronizacji przez odpytywanie. Zacznij od `GET /order/event-stats`, potem co ≥ 10 s `GET /order/events?from={ostatnie id}`. Zdarzenia pojawiają się po 5 s (spójność).\n\nDomyślnie typy `READY_FOR_PROCESSING` i `FULFILLMENT_STATUS_CHANGED`; `SHIPMENT_ADDED` i `SHIPMENT_STAGE_CHANGED` (rozszerzenie allee) tylko po jawnym `type`. Zamiast odpytywania możesz zasubskrybować powiadomienie push `ORDER_CHANGE`.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /order/events.\n**Uprawnienie:** zakres `allegro:api:orders:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "from", "in": "query", "required": false, "description": "Kursor: zdarzenia po tym id.", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } }, { "name": "limit", "in": "query", "required": false, "description": "1–1000.", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } }, { "name": "type", "in": "query", "required": false, "description": "Typy (powtórz parametr).", "schema": { "type": "array", "items": { "type": "string", "enum": [ "BOUGHT", "FILLED_IN", "READY_FOR_PROCESSING", "BUYER_CANCELLED", "AUTO_CANCELLED", "BUYER_MODIFIED", "FULFILLMENT_STATUS_CHANGED", "SHIPMENT_ADDED", "SHIPMENT_STAGE_CHANGED" ] } }, "style": "form", "explode": true } ], "responses": { "200": { "description": "Zdarzenia.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OrderEventList" }, "example": { "events": [ { "id": "55", "type": "READY_FOR_PROCESSING", "occurredAt": "2026-11-10T11:09:55.412Z", "changedBy": "ALLEE", "changedByAppId": null, "order": { "seller": { "id": "980000001" }, "checkoutForm": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "revision": "3" }, "lineItems": [ { "id": "2d9680b4-9cb7-4096-9428-8c1ceb2790c2", "offer": { "id": "900000000000021", "external": { "id": "FILM-21ef85-1" } } } ] } }, { "id": "60", "type": "READY_FOR_PROCESSING", "occurredAt": "2026-11-10T11:09:55.419Z", "changedBy": "ALLEE", "changedByAppId": null, "order": { "seller": { "id": "980000001" }, "checkoutForm": { "id": "718ce396-4940-431f-815e-7a51875c71df", "revision": "3" }, "lineItems": [ { "id": "3ce60978-f8b3-45de-9a31-6bf12fdc1417", "offer": { "id": "900000000000001", "external": { "id": "DEMO-01" } } } ] } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/OrderEventList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /order/events", "limitGroup": "read", "scope": "allegro:api:orders:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/order/events?type=READY_FOR_PROCESSING&limit=100\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /order/events (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/order/events?type=READY_FOR_PROCESSING&limit=100\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /order/events (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/events?type=READY_FOR_PROCESSING&limit=100`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /order/events (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/order/events?type=READY_FOR_PROCESSING&limit=100\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /order/events (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/events?type=READY_FOR_PROCESSING&limit=100\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /order/events (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/order/events?type=READY_FOR_PROCESSING&limit=100\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/{checkoutFormId}/billing-documents/files": { "post": { "operationId": "uploadBillingDocumentFile", "summary": "Faktura PDF jednym żądaniem", "tags": [ "Faktury" ], "description": "Plik PDF jednym żądaniem: treść = PDF (`Content-Type: application/pdf`, numer w `?invoiceNumber=`) albo `multipart/form-data` (pole `file` + `invoiceNumber`). Te same kontrole co w kroku 2.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** tylko allee — Rozszerzenie allee (Allegro: dwa kroki).\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } }, { "name": "invoiceNumber", "in": "query", "required": false, "description": "Numer faktury.", "schema": { "type": "string", "maxLength": 100 } }, { "name": "fileName", "in": "query", "required": false, "description": "Nazwa pliku. Domyślnie z numeru faktury, ale tylko ostatni człon po „/” (FK/1/11/2026 daje 2026.pdf) — przy numerach z ukośnikami podaj fileName.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "description": "Plik PDF (albo multipart/form-data z polem file).", "content": { "application/pdf": { "schema": { "type": "string", "format": "binary" } }, "multipart/form-data": { "schema": { "type": "object", "properties": { "file": { "type": "string", "format": "binary", "description": "Plik PDF." }, "invoiceNumber": { "type": "string", "description": "Numer faktury." } }, "required": [ "file" ] } } } }, "responses": { "201": { "description": "Dodano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Invoice" }, "example": { "id": "68df84ab-298c-4fa5-aaf9-30b90f3af67a", "invoiceNumber": "FK/1/11/2026", "createdAt": "2026-11-10T11:10:05.465Z", "file": { "id": "68df84ab-298c-4fa5-aaf9-30b90f3af67a", "name": "2026.pdf", "uploadedAt": "2026-11-10T11:10:05.465Z", "securityVerification": { "status": "ACCEPTED", "passedChecks": [ "PDF_HEADER", "PDF_EOF", "NO_ACTIVE_CONTENT", "COMPRESSED_STREAMS_SCANNED", "MAX_SIZE_3MB" ], "failedChecks": [] } }, "allee": { "type": "FILE", "status": "READY", "size": 622, "url": null, "downloadUrl": "https://api.allee.pl/allee/billing-documents/68df84ab-298c-4fa5-aaf9-30b90f3af67a/file?expires=1794309305&mode=test&signature=…", "downloadUrlExpiresAt": "2026-11-10T11:15:05.000Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Invoice" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `TOO_MANY_INVOICES`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `BUSY`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`, `STORAGE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Rozszerzenie allee (Allegro: dwa kroki)", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "TOO_MANY_INVOICES" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "BUSY" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" }, { "status": 503, "code": "STORAGE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files?invoiceNumber=FK%2F1%2F11%2F2026\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/pdf\" \\\n --data-binary @faktura.pdf \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/pdf',\n ],\n CURLOPT_POSTFIELDS => file_get_contents('faktura.pdf'),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/pdf\",\n}\nwith open(\"faktura.pdf\", \"rb\") as f:\n plik = f.read()\nr = requests.request(\"POST\", BASE + \"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files?invoiceNumber=FK%2F1%2F11%2F2026\", headers=headers, data=plik, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files (Node.js 18+, wbudowany fetch; plik .mjs)\nimport { readFile, writeFile } from \"node:fs/promises\";\n\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files?invoiceNumber=FK%2F1%2F11%2F2026`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/pdf\",\n },\n body: await readFile(\"faktura.pdf\"),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files?invoiceNumber=FK%2F1%2F11%2F2026\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nreq.Content = new ByteArrayContent(File.ReadAllBytes(\"faktura.pdf\"));\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/pdf\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\nimport java.nio.file.Path;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files?invoiceNumber=FK%2F1%2F11%2F2026\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/pdf\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofFile(Path.of(\"faktura.pdf\")))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"bytes\"\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tplik, err := os.ReadFile(\"faktura.pdf\")\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq, err := http.NewRequest(\"POST\", base+\"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/files?invoiceNumber=FK%2F1%2F11%2F2026\", bytes.NewReader(plik))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/pdf\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/order/{checkoutFormId}/billing-documents/links": { "post": { "operationId": "addBillingDocumentLink", "summary": "Faktura jako link", "tags": [ "Faktury" ], "description": "Faktura wystawiona w Twoim systemie — podajesz adres https; kupujący dostaje link.\n\nZamówieniami allee.pl sprzedawcy obsługuje **jedna integracja** naraz (wybór w panelu sprzedaży → Integracje); inna aplikacja dostaje **403 `ORDERS_OWNED_BY_OTHER_INTEGRATION`** (`details.owner`: PANEL, OTHER_APP, BASELINKER).\n\n**Zgodność:** tylko allee — Rozszerzenie allee.\n**Uprawnienie:** zakres `allegro:api:orders:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "checkoutFormId", "in": "path", "required": true, "description": "Identyfikator zamówienia (UUID, checkoutForm.id).", "schema": { "type": "string", "format": "uuid" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/InvoiceLinkInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/InvoiceLinkInput" } } } }, "responses": { "201": { "description": "Dodano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Invoice" }, "example": { "id": "269a4823-f164-4ed9-8567-571fda81ad5d", "invoiceNumber": "FV/2/11/2026", "createdAt": "2026-11-10T11:10:05.468Z", "file": null, "allee": { "type": "LINK", "status": "READY", "size": null, "url": "https://faktury.example.com/fv/2-11-2026", "downloadUrl": null, "downloadUrlExpiresAt": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Invoice" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `ORDERS_OWNED_BY_OTHER_INTEGRATION`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `INVALID_URL`, `JsonMappingException`, `TOO_MANY_INVOICES`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:orders:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Rozszerzenie allee", "limitGroup": "write", "scope": "allegro:api:orders:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "ORDERS_OWNED_BY_OTHER_INTEGRATION" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "INVALID_URL" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "TOO_MANY_INVOICES" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"url\": \"https://faktury.example.com/fv/2-11-2026\",\n \"invoiceNumber\": \"FV/2/11/2026\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'https://faktury.example.com/fv/2-11-2026',\n 'invoiceNumber' => 'FV/2/11/2026',\n];\n$ch = curl_init($base . '/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"url\": \"https://faktury.example.com/fv/2-11-2026\",\n \"invoiceNumber\": \"FV/2/11/2026\",\n}\nr = requests.request(\"POST\", BASE + \"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"url\": \"https://faktury.example.com/fv/2-11-2026\",\n \"invoiceNumber\": \"FV/2/11/2026\"\n};\nconst res = await fetch(`${BASE}/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"url\": \"https://faktury.example.com/fv/2-11-2026\",\n \"invoiceNumber\": \"FV/2/11/2026\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"url\": \"https://faktury.example.com/fv/2-11-2026\",\n \"invoiceNumber\": \"FV/2/11/2026\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"url\": \"https://faktury.example.com/fv/2-11-2026\",\n \"invoiceNumber\": \"FV/2/11/2026\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/order/432810d0-4d26-4f39-ba5f-b89def4d4f92/billing-documents/links\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/pricing/offer-fee-preview": { "post": { "operationId": "getOfferFeePreview", "summary": "Podgląd opłat oferty", "tags": [ "Opłaty" ], "description": "Opłata za wystawienie i prowizja dla istniejącej oferty (`offer.id`) albo dla danych nowej oferty (`sellingMode`, `stock`). Ta sama funkcja licząca co formularz wystawiania.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST /pricing/offer-fee-preview.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "offer": { "type": "object", "properties": { "id": { "type": "string" }, "sellingMode": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "BUY_NOW" ] }, "price": { "$ref": "#/components/schemas/MoneyInput" } }, "required": [ "price" ] }, "stock": { "type": "object", "properties": { "available": { "type": "integer" } }, "required": [ "available" ] } }, "additionalProperties": true }, "marketplaceId": { "type": "string", "enum": [ "allee-pl" ] }, "classifiedsPackages": { "description": "Bez skutku (allee nie ma ogłoszeń płatnych)." } }, "required": [ "offer" ] } }, "application/json": { "schema": { "type": "object", "properties": { "offer": { "type": "object", "properties": { "id": { "type": "string" }, "sellingMode": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "BUY_NOW" ] }, "price": { "$ref": "#/components/schemas/MoneyInput" } }, "required": [ "price" ] }, "stock": { "type": "object", "properties": { "available": { "type": "integer" } }, "required": [ "available" ] } }, "additionalProperties": true }, "marketplaceId": { "type": "string", "enum": [ "allee-pl" ] }, "classifiedsPackages": { "description": "Bez skutku (allee nie ma ogłoszeń płatnych)." } }, "required": [ "offer" ] } } } }, "responses": { "200": { "description": "Opłaty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/FeePreview" }, "example": { "commissions": [ { "name": "Prowizja od sprzedaży", "type": "SUCCESS_COMMISSION", "fee": { "amount": "0.00", "currency": "PLN" } } ], "quotes": [ { "name": "Opłata za wystawienie", "type": "LISTING_FEE", "fee": { "amount": "0.00", "currency": "PLN" }, "cycleDuration": null } ], "allee": { "total": { "amount": "0.00", "currency": "PLN" }, "feeScheduleVersion": "2026-11-09", "note": "allee.pl nie pobiera dziś opłat za wystawienie ani prowizji od sprzedaży." } } }, "application/json": { "schema": { "$ref": "#/components/schemas/FeePreview" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST /pricing/offer-fee-preview", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/pricing/offer-fee-preview\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"offer\": {\n \"id\": \"900000000000021\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'id' => '900000000000021',\n ],\n];\n$ch = curl_init($base . '/pricing/offer-fee-preview');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /pricing/offer-fee-preview (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"offer\": {\n \"id\": \"900000000000021\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/pricing/offer-fee-preview\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /pricing/offer-fee-preview (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"offer\": {\n \"id\": \"900000000000021\"\n }\n};\nconst res = await fetch(`${BASE}/pricing/offer-fee-preview`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /pricing/offer-fee-preview (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/pricing/offer-fee-preview\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"offer\": {\n \"id\": \"900000000000021\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /pricing/offer-fee-preview (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"offer\": {\n \"id\": \"900000000000021\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/pricing/offer-fee-preview\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /pricing/offer-fee-preview (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"offer\": {\n \"id\": \"900000000000021\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/pricing/offer-fee-preview\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/categories": { "get": { "operationId": "getCategories", "summary": "Lista kategorii", "tags": [ "Kategorie" ], "description": "Działy główne albo dzieci wskazanej kategorii (`parent.id` = identyfikator Allegro). Każda kategoria ma oba identyfikatory: `id` (Allegro) i `alleeId`.\n\nWystarczy dowolny ważny token — także token aplikacji (`client_credentials`).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/categories.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "parent.id", "in": "query", "required": false, "description": "Identyfikator kategorii nadrzędnej (Allegro). Brak = działy główne.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Kategorie.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CategoryList" }, "example": { "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": {} } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/categories", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/categories (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/categories (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/categories (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/categories (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/categories (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/categories?parent.id=38d588fd-7e9c-4c42-a4ae-6831775eca45\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/categories/{categoryId}": { "get": { "operationId": "getCategory", "summary": "Kategoria", "tags": [ "Kategorie" ], "description": "Jedna kategoria po identyfikatorze Allegro. `leaf: true` = można w niej wystawiać.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/categories/{categoryId}.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "categoryId", "in": "path", "required": true, "description": "Identyfikator kategorii Allegro (liczba albo UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Kategoria.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Category" }, "example": { "id": "20585", "alleeId": 35, "name": "Filmy", "parent": { "id": "38d588fd-7e9c-4c42-a4ae-6831775eca45", "alleeId": 6 }, "leaf": true, "options": {} } }, "application/json": { "schema": { "$ref": "#/components/schemas/Category" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/categories/{categoryId}", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/categories/20585\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/categories/20585 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/categories/20585\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/categories/20585 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/categories/20585`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/categories/20585 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/categories/20585\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/categories/20585 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/categories/20585\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/categories/20585 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/categories/20585\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/categories/{categoryId}/parameters": { "get": { "operationId": "getCategoryParameters", "summary": "Parametry kategorii", "tags": [ "Kategorie" ], "description": "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.\n\nParametr **Stan (11323)** przyjmujemy w każdej kategorii; wartości obsługiwane przez allee mają `options.alleeSupported: true`. Listy są buforowane 10 minut.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/categories/{categoryId}/parameters.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "categoryId", "in": "path", "required": true, "description": "Identyfikator kategorii Allegro.", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Parametry.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CategoryParameterList" }, "example": { "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_1797517", "alleeId": 258696, "value": "westerny", "dependsOnValueIds": [] }, { "id": "250077_1797518", "alleeId": 258697, "value": "wojenne", "dependsOnValueIds": [] }, { "id": "250077_1797519", "alleeId": 258698, "value": "zestawy, pakiety", "dependsOnValueIds": [] }, { "id": "250077_1797509", "alleeId": 258699, "value": "inny", "dependsOnValueIds": [] } ] }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "type": "string", "required": true, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "minLength": 8, "maxLength": 14, "allowedNumberOfValues": 1 } }, { "id": "237218", "alleeId": 7939, "name": "Tytuł", "type": "string", "required": true, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "minLength": 1, "maxLength": 100, "allowedNumberOfValues": 1 } }, { "id": "10524", "alleeId": 586, "name": "Rodzaj wydania", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "10524_3", "alleeId": 5952, "value": "Wydanie - część kolekcji", "dependsOnValueIds": [] }, { "id": "10524_1", "alleeId": 5953, "value": "Wydanie pełne", "dependsOnValueIds": [] }, { "id": "10524_4", "alleeId": 5954, "value": "Wydanie specjalne, limitowane", "dependsOnValueIds": [] }, { "id": "10524_2", "alleeId": 5955, "value": "Wydanie z gazety", "dependsOnValueIds": [] } ] }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "229205_340245", "alleeId": 60427, "value": "oryginalne", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340249", "alleeId": 60428, "value": "otwarte", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340253", "alleeId": 60429, "value": "uszkodzone", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340257", "alleeId": 60430, "value": "zastępcze", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] }, { "id": "229205_340261", "alleeId": 60431, "value": "brak opakowania", "dependsOnValueIds": [ "11323_253798", "11323_246534", "11323_1223636", "11323_1223462", "11323_2036072", "11323_246510", "11323_253802", "11323_852680", "11323_246514", "11323_253806", "11323_246466", "11323_2", "11323_1223635", "11323_238066", "11323_238058", "11323_246462", "11323_238062", "11323_246538", "11323_1223453", "11323_238070" ] } ] }, { "id": "7037", "alleeId": 443, "name": "Region producenta filmu", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "7037_1", "alleeId": 4954, "value": "Afryka", "dependsOnValueIds": [] }, { "id": "7037_3", "alleeId": 4955, "value": "Ameryka Północna", "dependsOnValueIds": [] }, { "id": "7037_2", "alleeId": 4956, "value": "Ameryka Południowa", "dependsOnValueIds": [] }, { "id": "7037_4", "alleeId": 4957, "value": "Australia", "dependsOnValueIds": [] }, { "id": "7037_5", "alleeId": 4958, "value": "Azja", "dependsOnValueIds": [] }, { "id": "7037_6", "alleeId": 4959, "value": "Europa", "dependsOnValueIds": [] }, { "id": "7037_7", "alleeId": 4960, "value": "Produkcja mieszana", "dependsOnValueIds": [] } ] }, { "id": "249816", "alleeId": 10734, "name": "Język dubbingu", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": true }, "dictionary": [ { "id": "249816_1743449", "alleeId": 243265, "value": "angielski", "dependsOnValueIds": [] }, { "id": "249816_1743468", "alleeId": 243266, "value": "arabski", "dependsOnValueIds": [] }, { "id": "249816_1743469", "alleeId": 243267, "value": "chiński (mandaryński)", "dependsOnValueIds": [] }, { "id": "249816_1743450", "alleeId": 243268, "value": "czeski", "dependsOnValueIds": [] }, { "id": "249816_1743466", "alleeId": 243269, "value": "duński", "dependsOnValueIds": [] }, { "id": "249816_1743459", "alleeId": 243270, "value": "fiński", "dependsOnValueIds": [] }, { "id": "249816_1743455", "alleeId": 243271, "value": "francuski", "dependsOnValueIds": [] }, { "id": "249816_1743465", "alleeId": 243272, "value": "grecki", "dependsOnValueIds": [] }, { "id": "249816_1743472", "alleeId": 243273, "value": "hindi", "dependsOnValueIds": [] }, { "id": "249816_1743460", "alleeId": 243274, "value": "hiszpański", "dependsOnValueIds": [] }, { "id": "249816_1743470", "alleeId": 243275, "value": "japoński", "dependsOnValueIds": [] }, { "id": "249816_1743471", "alleeId": 243276, "value": "koreański", "dependsOnValueIds": [] }, { "id": "249816_1743467", "alleeId": 243277, "value": "niderlandzki", "dependsOnValueIds": [] }, { "id": "249816_1743456", "alleeId": 243278, "value": "niemiecki", "dependsOnValueIds": [] }, { "id": "249816_1743458", "alleeId": 243279, "value": "norweski", "dependsOnValueIds": [] }, { "id": "249816_1743448", "alleeId": 243280, "value": "polski", "dependsOnValueIds": [] }, { "id": "249816_1743452", "alleeId": 243281, "value": "portugalski", "dependsOnValueIds": [] }, { "id": "249816_1743462", "alleeId": 243282, "value": "rosyjski", "dependsOnValueIds": [] }, { "id": "249816_1743453", "alleeId": 243283, "value": "rumuński", "dependsOnValueIds": [] }, { "id": "249816_1743454", "alleeId": 243284, "value": "słowacki", "dependsOnValueIds": [] }, { "id": "249816_1743457", "alleeId": 243285, "value": "szwedzki", "dependsOnValueIds": [] }, { "id": "249816_1743464", "alleeId": 243286, "value": "turecki", "dependsOnValueIds": [] }, { "id": "249816_1743463", "alleeId": 243287, "value": "ukraiński", "dependsOnValueIds": [] }, { "id": "249816_1743451", "alleeId": 243288, "value": "węgierski", "dependsOnValueIds": [] }, { "id": "249816_1743461", "alleeId": 243289, "value": "włoski", "dependsOnValueIds": [] } ] }, { "id": "249815", "alleeId": 10733, "name": "Język lektora", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": true }, "dictionary": [ { "id": "249815_1743424", "alleeId": 243240, "value": "angielski", "dependsOnValueIds": [] }, { "id": "249815_1743443", "alleeId": 243241, "value": "arabski", "dependsOnValueIds": [] }, { "id": "249815_1743444", "alleeId": 243242, "value": "chiński (mandaryński)", "dependsOnValueIds": [] }, { "id": "249815_1743425", "alleeId": 243243, "value": "czeski", "dependsOnValueIds": [] }, { "id": "249815_1743441", "alleeId": 243244, "value": "duński", "dependsOnValueIds": [] }, { "id": "249815_1743434", "alleeId": 243245, "value": "fiński", "dependsOnValueIds": [] }, { "id": "249815_1743430", "alleeId": 243246, "value": "francuski", "dependsOnValueIds": [] }, { "id": "249815_1743440", "alleeId": 243247, "value": "grecki", "dependsOnValueIds": [] }, { "id": "249815_1743447", "alleeId": 243248, "value": "hindi", "dependsOnValueIds": [] }, { "id": "249815_1743435", "alleeId": 243249, "value": "hiszpański", "dependsOnValueIds": [] }, { "id": "249815_1743445", "alleeId": 243250, "value": "japoński", "dependsOnValueIds": [] }, { "id": "249815_1743446", "alleeId": 243251, "value": "koreański", "dependsOnValueIds": [] }, { "id": "249815_1743442", "alleeId": 243252, "value": "niderlandzki", "dependsOnValueIds": [] }, { "id": "249815_1743431", "alleeId": 243253, "value": "niemiecki", "dependsOnValueIds": [] }, { "id": "249815_1743433", "alleeId": 243254, "value": "norweski", "dependsOnValueIds": [] }, { "id": "249815_1743423", "alleeId": 243255, "value": "polski", "dependsOnValueIds": [] }, { "id": "249815_1743427", "alleeId": 243256, "value": "portugalski", "dependsOnValueIds": [] }, { "id": "249815_1743437", "alleeId": 243257, "value": "rosyjski", "dependsOnValueIds": [] }, { "id": "249815_1743428", "alleeId": 243258, "value": "rumuński", "dependsOnValueIds": [] }, { "id": "249815_1743429", "alleeId": 243259, "value": "słowacki", "dependsOnValueIds": [] }, { "id": "249815_1743432", "alleeId": 243260, "value": "szwedzki", "dependsOnValueIds": [] }, { "id": "249815_1743439", "alleeId": 243261, "value": "turecki", "dependsOnValueIds": [] }, { "id": "249815_1743438", "alleeId": 243262, "value": "ukraiński", "dependsOnValueIds": [] }, { "id": "249815_1743426", "alleeId": 243263, "value": "węgierski", "dependsOnValueIds": [] }, { "id": "249815_1743436", "alleeId": 243264, "value": "włoski", "dependsOnValueIds": [] } ] }, { "id": "249814", "alleeId": 10732, "name": "Język napisów", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": true }, "dictionary": [ { "id": "249814_1743397", "alleeId": 243215, "value": "angielski", "dependsOnValueIds": [] }, { "id": "249814_1743416", "alleeId": 243216, "value": "arabski", "dependsOnValueIds": [] }, { "id": "249814_1743417", "alleeId": 243217, "value": "chiński (mandaryński)", "dependsOnValueIds": [] }, { "id": "249814_1743398", "alleeId": 243218, "value": "czeski", "dependsOnValueIds": [] }, { "id": "249814_1743414", "alleeId": 243219, "value": "duński", "dependsOnValueIds": [] }, { "id": "249814_1743407", "alleeId": 243220, "value": "fiński", "dependsOnValueIds": [] }, { "id": "249814_1743403", "alleeId": 243221, "value": "francuski", "dependsOnValueIds": [] }, { "id": "249814_1743413", "alleeId": 243222, "value": "grecki", "dependsOnValueIds": [] }, { "id": "249814_1743420", "alleeId": 243223, "value": "hindi", "dependsOnValueIds": [] }, { "id": "249814_1743408", "alleeId": 243224, "value": "hiszpański", "dependsOnValueIds": [] }, { "id": "249814_1743418", "alleeId": 243225, "value": "japoński", "dependsOnValueIds": [] }, { "id": "249814_1743419", "alleeId": 243226, "value": "koreański", "dependsOnValueIds": [] }, { "id": "249814_1743415", "alleeId": 243227, "value": "niderlandzki", "dependsOnValueIds": [] }, { "id": "249814_1743404", "alleeId": 243228, "value": "niemiecki", "dependsOnValueIds": [] }, { "id": "249814_1743406", "alleeId": 243229, "value": "norweski", "dependsOnValueIds": [] }, { "id": "249814_1743396", "alleeId": 243230, "value": "polski", "dependsOnValueIds": [] }, { "id": "249814_1743400", "alleeId": 243231, "value": "portugalski", "dependsOnValueIds": [] }, { "id": "249814_1743410", "alleeId": 243232, "value": "rosyjski", "dependsOnValueIds": [] }, { "id": "249814_1743401", "alleeId": 243233, "value": "rumuński", "dependsOnValueIds": [] }, { "id": "249814_1743402", "alleeId": 243234, "value": "słowacki", "dependsOnValueIds": [] }, { "id": "249814_1743405", "alleeId": 243235, "value": "szwedzki", "dependsOnValueIds": [] }, { "id": "249814_1743412", "alleeId": 243236, "value": "turecki", "dependsOnValueIds": [] }, { "id": "249814_1743411", "alleeId": 243237, "value": "ukraiński", "dependsOnValueIds": [] }, { "id": "249814_1743399", "alleeId": 243238, "value": "węgierski", "dependsOnValueIds": [] }, { "id": "249814_1743409", "alleeId": 243239, "value": "włoski", "dependsOnValueIds": [] } ] }, { "id": "249777", "alleeId": 10701, "name": "Wytwórnia filmowa", "type": "dictionary", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "multipleChoices": false }, "dictionary": [ { "id": "249777_1930418", "alleeId": 239006, "value": "20th Century Fox", "dependsOnValueIds": [] }, { "id": "249777_1930415", "alleeId": 239007, "value": "20th Century Studios", "dependsOnValueIds": [] }, { "id": "249777_1737231", "alleeId": 239008, "value": "A.k.a. Cartoon", "dependsOnValueIds": [] }, { "id": "249777_1737232", "alleeId": 239009, "value": "Aardman Animations", "dependsOnValueIds": [] }, { "id": "249777_1737234", "alleeId": 239010, "value": "Atéliery Bonton Zlín", "dependsOnValueIds": [] }, { "id": "249777_1737235", "alleeId": 239011, "value": "Biełaruśfilm", "dependsOnValueIds": [] }, { "id": "249777_1737236", "alleeId": 239012, "value": "Bratři v triku", "dependsOnValueIds": [] }, { "id": "249777_1737237", "alleeId": 239013, "value": "Bridge (studio)", "dependsOnValueIds": [] }, { "id": "249777_1737238", "alleeId": 239014, "value": "Burbank Films Australia", "dependsOnValueIds": [] }, { "id": "249777_1930416", "alleeId": 239015, "value": "Cass film", "dependsOnValueIds": [] }, { "id": "249777_1737239", "alleeId": 239016, "value": "CinéGroupe", "dependsOnValueIds": [] }, { "id": "249777_1737240", "alleeId": 239017, "value": "CloverWorks", "dependsOnValueIds": [] }, { "id": "249777_1930412", "alleeId": 239018, "value": "Columbia Pictures", "dependsOnValueIds": [] }, { "id": "249777_2035720", "alleeId": 239019, "value": "Concorde Video", "dependsOnValueIds": [] }, { "id": "249777_1737241", "alleeId": 239020, "value": "Diomedéa", "dependsOnValueIds": [] }, { "id": "249777_1737242", "alleeId": 239021, "value": "Doga Kobo", "dependsOnValueIds": [] }, { "id": "249777_1737243", "alleeId": 239022, "value": "DreamWorks Animation", "dependsOnValueIds": [] }, { "id": "249777_1737244", "alleeId": 239023, "value": "Felix Film", "dependsOnValueIds": [] }, { "id": "249777_1737245", "alleeId": 239024, "value": "Frederator Studios", "dependsOnValueIds": [] }, { "id": "249777_1737246", "alleeId": 239025, "value": "Fresh TV", "dependsOnValueIds": [] }, { "id": "249777_1737247", "alleeId": 239026, "value": "Gaumont", "dependsOnValueIds": [] }, { "id": "249777_1737248", "alleeId": 239027, "value": "Geek Toys", "dependsOnValueIds": [] }, { "id": "249777_1737249", "alleeId": 239028, "value": "Geno Studio", "dependsOnValueIds": [] }, { "id": "249777_1737250", "alleeId": 239029, "value": "Golden Films", "dependsOnValueIds": [] }, { "id": "249777_1737252", "alleeId": 239030, "value": "Hanna-Barbera", "dependsOnValueIds": [] }, { "id": "249777_1737253", "alleeId": 239031, "value": "ImageMovers", "dependsOnValueIds": [] }, { "id": "249777_1737254", "alleeId": 239032, "value": "ImageMovers Digital", "dependsOnValueIds": [] }, { "id": "249777_1737256", "alleeId": 239033, "value": "Kinema Citrus", "dependsOnValueIds": [] }, { "id": "249777_1930413", "alleeId": 239034, "value": "Kino Świat", "dependsOnValueIds": [] }, { "id": "249777_1737257", "alleeId": 239035, "value": "Klasky Csupo, Inc.", "dependsOnValueIds": [] }, { "id": "249777_1737258", "alleeId": 239036, "value": "Lay-duce", "dependsOnValueIds": [] }, { "id": "249777_1930409", "alleeId": 239037, "value": "LEONINE Distribution", "dependsOnValueIds": [] }, { "id": "249777_1737260", "alleeId": 239038, "value": "Mainframe Entertainment", "dependsOnValueIds": [] }, { "id": "249777_1737261", "alleeId": 239039, "value": "MAPPA", "dependsOnValueIds": [] }, { "id": "249777_1737262", "alleeId": 239040, "value": "Marathon Media Group", "dependsOnValueIds": [] }, { "id": "249777_1737263", "alleeId": 239041, "value": "Marvel Animation", "dependsOnValueIds": [] }, { "id": "249777_2055003", "alleeId": 239042, "value": "Mayfly", "dependsOnValueIds": [] }, { "id": "249777_1737264", "alleeId": 239043, "value": "Metro-Goldwyn-Mayer", "dependsOnValueIds": [] }, { "id": "249777_1930421", "alleeId": 239044, "value": "MGM Studios", "dependsOnValueIds": [] }, { "id": "249777_1737266", "alleeId": 239045, "value": "Mongolkino", "dependsOnValueIds": [] }, { "id": "249777_1737267", "alleeId": 239046, "value": "NAZ", "dependsOnValueIds": [] }, { "id": "249777_1737268", "alleeId": 239047, "value": "Nelvana", "dependsOnValueIds": [] }, { "id": "249777_1737269", "alleeId": 239048, "value": "Neptuno Films", "dependsOnValueIds": [] }, { "id": "249777_1737270", "alleeId": 239049, "value": "Nerd Corps Entertainment", "dependsOnValueIds": [] }, { "id": "249777_2081635", "alleeId": 239050, "value": "New Abra", "dependsOnValueIds": [] }, { "id": "249777_1737271", "alleeId": 239051, "value": "NUT (studio)", "dependsOnValueIds": [] }, { "id": "249777_1737272", "alleeId": 239052, "value": "Orange (studio)", "dependsOnValueIds": [] }, { "id": "249777_1737273", "alleeId": 239053, "value": "Pacific Data Images", "dependsOnValueIds": [] }, { "id": "249777_1737274", "alleeId": 239054, "value": "Pannonia Film Studio", "dependsOnValueIds": [] }, { "id": "249777_1930422", "alleeId": 239055, "value": "Paramount", "dependsOnValueIds": [] }, { "id": "249777_1930420", "alleeId": 239056, "value": "Paramount Pictures", "dependsOnValueIds": [] }, { "id": "249777_1737275", "alleeId": 239057, "value": "Passione", "dependsOnValueIds": [] }, { "id": "249777_1737276", "alleeId": 239058, "value": "Pine Jam", "dependsOnValueIds": [] }, { "id": "249777_1737277", "alleeId": 239059, "value": "Pixar", "dependsOnValueIds": [] }, { "id": "249777_1930417", "alleeId": 239060, "value": "Plaion Pictures", "dependsOnValueIds": [] }, { "id": "249777_1737278", "alleeId": 239061, "value": "Platige Image", "dependsOnValueIds": [] }, { "id": "249777_1737279", "alleeId": 239062, "value": "Platinum Vision", "dependsOnValueIds": [] }, { "id": "249777_1928589", "alleeId": 239063, "value": "Prosveta", "dependsOnValueIds": [] }, { "id": "249777_1737280", "alleeId": 239064, "value": "Rainbow", "dependsOnValueIds": [] }, { "id": "249777_1737281", "alleeId": 239065, "value": "Renegade Animation", "dependsOnValueIds": [] }, { "id": "249777_1737282", "alleeId": 239066, "value": "Revoroot", "dependsOnValueIds": [] }, { "id": "249777_1737283", "alleeId": 239067, "value": "Se-ma-for", "dependsOnValueIds": [] }, { "id": "249777_1737285", "alleeId": 239068, "value": "Silver Link", "dependsOnValueIds": [] }, { "id": "249777_1737286", "alleeId": 239069, "value": "Sojuzmultfilm", "dependsOnValueIds": [] }, { "id": "249777_1737287", "alleeId": 239070, "value": "Sony Pictures Animation", "dependsOnValueIds": [] }, { "id": "249777_1737288", "alleeId": 239071, "value": "SPInka Film Studio", "dependsOnValueIds": [] }, { "id": "249777_1737289", "alleeId": 239072, "value": "Stoopid Buddy Studios", "dependsOnValueIds": [] }, { "id": "249777_1737290", "alleeId": 239073, "value": "Studio Bind", "dependsOnValueIds": [] }, { "id": "249777_1930414", "alleeId": 239074, "value": "Studiocanal", "dependsOnValueIds": [] }, { "id": "249777_1737291", "alleeId": 239075, "value": "Studio Ekran", "dependsOnValueIds": [] }, { "id": "249777_1737292", "alleeId": 239076, "value": "Studio Filmów Animowanych", "dependsOnValueIds": [] }, { "id": "249777_1737233", "alleeId": 239077, "value": "Studio Filmowe Anima-Pol", "dependsOnValueIds": [] }, { "id": "249777_1737293", "alleeId": 239078, "value": "Studio Miniatur Filmowych", "dependsOnValueIds": [] }, { "id": "249777_1737294", "alleeId": 239079, "value": "Teletoon", "dependsOnValueIds": [] }, { "id": "249777_2076447", "alleeId": 239080, "value": "TELEWIZJA POLSKA SA", "dependsOnValueIds": [] }, { "id": "249777_1737295", "alleeId": 239081, "value": "Trigger", "dependsOnValueIds": [] }, { "id": "249777_1737296", "alleeId": 239082, "value": "Troyca", "dependsOnValueIds": [] }, { "id": "249777_1737298", "alleeId": 239083, "value": "TV Studio Filmów Animowanych", "dependsOnValueIds": [] }, { "id": "249777_1930419", "alleeId": 239084, "value": "Universal Pictures", "dependsOnValueIds": [] }, { "id": "249777_1930410", "alleeId": 239085, "value": "Universal Pictures Video", "dependsOnValueIds": [] }, { "id": "249777_1926942", "alleeId": 239086, "value": "VICTOR 11", "dependsOnValueIds": [] }, { "id": "249777_1737299", "alleeId": 239087, "value": "Walt Disney Animation Studios", "dependsOnValueIds": [] }, { "id": "249777_1930411", "alleeId": 239088, "value": "Warner Bros.", "dependsOnValueIds": [] }, { "id": "249777_1737300", "alleeId": 239089, "value": "Warner Bros. Animation", "dependsOnValueIds": [] }, { "id": "249777_2010823", "alleeId": 239090, "value": "WFDiF", "dependsOnValueIds": [] }, { "id": "249777_1737301", "alleeId": 239091, "value": "WildBrain", "dependsOnValueIds": [] }, { "id": "249777_1737302", "alleeId": 239092, "value": "Wit Studio", "dependsOnValueIds": [] }, { "id": "249777_1737303", "alleeId": 239093, "value": "Wołgogradtielefilm", "dependsOnValueIds": [] }, { "id": "249777_1737304", "alleeId": 239094, "value": "World Events Productions", "dependsOnValueIds": [] }, { "id": "249777_1737305", "alleeId": 239095, "value": "Zagreb Film", "dependsOnValueIds": [] }, { "id": "249777_1737306", "alleeId": 239096, "value": "Zero-G", "dependsOnValueIds": [] }, { "id": "249777_1737307", "alleeId": 239097, "value": "Zodiac Entertainment", "dependsOnValueIds": [] } ] }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "type": "string", "required": false, "requiredForProduct": false, "unit": null, "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "minLength": 8, "maxLength": 14, "allowedNumberOfValues": 20 } }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "type": "float", "required": false, "requiredForProduct": false, "unit": "kg", "options": { "customValuesEnabled": false, "ambiguousValueId": null }, "restrictions": { "min": 0, "max": 1000000, "range": false, "precision": 3 } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryParameterList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `CATEGORY_NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/categories/{categoryId}/parameters", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "CATEGORY_NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/categories/20585/parameters\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/categories/20585/parameters (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/categories/20585/parameters\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/categories/20585/parameters (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/categories/20585/parameters`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/categories/20585/parameters (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/categories/20585/parameters\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/categories/20585/parameters (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/categories/20585/parameters\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/categories/20585/parameters (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/categories/20585/parameters\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/category-events": { "get": { "operationId": "getCategoryEvents", "summary": "Zmiany w drzewie kategorii", "tags": [ "Kategorie" ], "description": "Utworzenie, zmiana nazwy, przeniesienie i usunięcie kategorii. Odpytuj z kursorem `from` = `id` ostatniego zdarzenia.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/category-events.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "from", "in": "query", "required": false, "description": "Zdarzenia po tym identyfikatorze.", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } }, { "name": "limit", "in": "query", "required": false, "description": "1–1000.", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } }, { "name": "type", "in": "query", "required": false, "description": "Filtr typów (można powtórzyć albo rozdzielić przecinkiem).", "schema": { "type": "array", "items": { "type": "string", "enum": [ "CATEGORY_CREATED", "CATEGORY_RENAMED", "CATEGORY_MOVED", "CATEGORY_DELETED" ] } }, "style": "form", "explode": true } ], "responses": { "200": { "description": "Zdarzenia.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CategoryEventList" }, "example": { "categoryEvents": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CategoryEventList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/category-events", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/category-events?limit=10\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/category-events (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/category-events?limit=10\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/category-events (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/category-events?limit=10`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/category-events (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/category-events?limit=10\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/category-events (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/category-events?limit=10\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/category-events (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/category-events?limit=10\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/delivery-methods": { "get": { "operationId": "getDeliveryMethods", "summary": "Metody dostawy", "tags": [ "Dostawa" ], "description": "Słownik **własny allee** (identyfikatory Allegro tu nie obowiązują). Identyfikatory są stałe. `paymentPolicy`: przedpłata albo pobranie; `allee.carrierId` = kod przewoźnika do `POST …/shipments`.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/delivery-methods.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Metody.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/DeliveryMethodList" }, "example": { "deliveryMethods": [ { "id": "b79ba3f7-7782-4521-b863-eae15c6f58a4", "name": "DHL POP (punkt odbioru)", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "DHL" } }, { "id": "2981fc14-cd5e-4d8b-a35b-627dc5ad5b33", "name": "Dostawa elektroniczna (e-mail)", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "ELEKTRONICZNA" } }, { "id": "ea4ee0a3-803a-4e34-ac32-2bc8c097d242", "name": "DPD Pickup (punkt odbioru)", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "DPD" } }, { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f", "name": "InPost Paczkomat 24/7", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "INPOST" } }, { "id": "5c76d200-c6db-46a7-9b78-7d067e8cfb2d", "name": "InPost Paczkomat 24/7 pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "INPOST" } }, { "id": "4b09b683-3f36-4d41-96a8-fc295b0b4aed", "name": "Kurier (inny przewoźnik)", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "OTHER" } }, { "id": "c2861209-80d2-4c77-83dc-fc9c038bdf35", "name": "Kurier (inny przewoźnik) pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "OTHER" } }, { "id": "52fdc4c3-d33b-4eeb-8ee3-b1faf813d595", "name": "Kurier DHL", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "DHL" } }, { "id": "af3fe346-005d-4452-8355-9cfacff12234", "name": "Kurier DHL pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "DHL" } }, { "id": "5aeef32d-c3ba-4beb-9ded-2f5c4f5ca98f", "name": "Kurier DPD", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "DPD" } }, { "id": "31f771d1-251f-4aef-8cab-3be9a123c527", "name": "Kurier DPD pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "DPD" } }, { "id": "5857ec8a-81c4-46cc-8aaa-a4e724596dda", "name": "Kurier FedEx", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "FEDEX" } }, { "id": "9c407b47-c8d9-445a-8d0f-9eaadd2eacc2", "name": "Kurier GLS", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "GLS" } }, { "id": "9a278b1b-68ff-4a85-850e-72a4fc9843e9", "name": "Kurier GLS pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "GLS" } }, { "id": "c0d5f4be-8793-469d-8438-d1c097f622e5", "name": "Kurier InPost", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "INPOST" } }, { "id": "5016ab78-3462-48e5-aaff-2dfe2b7a1304", "name": "Kurier InPost pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "INPOST" } }, { "id": "53f19e0d-0d96-436e-833b-0f07fdf51b7c", "name": "Kurier UPS", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "UPS" } }, { "id": "93278785-250d-4094-82af-47c0e43bac7e", "name": "Kurier UPS pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "UPS" } }, { "id": "6eab1b1e-208b-4424-804c-e1184f27696b", "name": "Odbiór osobisty (płatność przy odbiorze)", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "ODBIOR_OSOBISTY" } }, { "id": "725db263-57e9-4128-a1f4-802920cbe84b", "name": "Odbiór osobisty (przedpłata)", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "ODBIOR_OSOBISTY" } }, { "id": "5deebabb-6064-4c4e-af7d-2f7734276798", "name": "ORLEN Paczka", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "ORLEN_PACZKA" } }, { "id": "025144a5-e5e5-440e-82c3-37d237eb0e9f", "name": "ORLEN Paczka pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "ORLEN_PACZKA" } }, { "id": "b1f92de5-2504-4e72-a3d4-0ebfe87910ea", "name": "Poczta Polska — paczka", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "POCZTA_POLSKA" } }, { "id": "5ab5d86c-0992-43e8-a0bd-9c8b659f0f8e", "name": "Poczta Polska — paczka pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "POCZTA_POLSKA" } }, { "id": "b40ec70b-17be-41fc-aff0-e1c3be6689b1", "name": "Pocztex Kurier", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "POCZTEX" } }, { "id": "c7de5480-2421-4158-8a6c-f99b50defedd", "name": "Pocztex Kurier pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "POCZTEX" } }, { "id": "eabc5c15-2560-4c29-8342-5bc1ce8c0bf7", "name": "Przesyłka gabarytowa / transport", "paymentPolicy": "IN_ADVANCE", "allee": { "carrierId": "OTHER" } }, { "id": "918a4e56-1372-49eb-8b7d-e5280a763d6b", "name": "Przesyłka gabarytowa / transport pobranie", "paymentPolicy": "CASH_ON_DELIVERY", "allee": { "carrierId": "OTHER" } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/DeliveryMethodList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/delivery-methods", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/delivery-methods\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/delivery-methods (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/delivery-methods\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/delivery-methods (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/delivery-methods`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/delivery-methods (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/delivery-methods\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/delivery-methods (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/delivery-methods\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/delivery-methods (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/delivery-methods\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/images": { "post": { "operationId": "uploadOfferImage", "summary": "Zdjęcie z adresu", "tags": [ "Zdjęcia" ], "description": "Ciało JSON `{\"url\": \"https://…\"}` — adres sprawdzamy od razu (SSRF: tylko publiczne https/http, porty 80/443), plik pobiera allee w tle.\nZwrócone `location` wpisz do `images` oferty. Plik binarny w treści → 415: użyj `POST /allee/uploads` (wgranie wprost do magazynu).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /sale/images.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Publiczny adres zdjęcia.", "format": "uri" } }, "required": [ "url" ] } }, "application/json": { "schema": { "type": "object", "properties": { "url": { "type": "string", "description": "Publiczny adres zdjęcia.", "format": "uri" } }, "required": [ "url" ] } } } }, "responses": { "201": { "description": "Przyjęto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ImageUploaded" }, "example": { "location": "https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp", "expiresAt": "2026-11-17T11:10:04.000Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ImageUploaded" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `IMAGE_DOWNLOAD_FAILED`, `JsonMappingException`, `UnknownJSONProperty`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /sale/images", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "IMAGE_DOWNLOAD_FAILED" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/images\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"url\": \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp',\n];\n$ch = curl_init($base . '/sale/images');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/images (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"url\": \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\",\n}\nr = requests.request(\"POST\", BASE + \"/sale/images\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/images (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"url\": \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n};\nconst res = await fetch(`${BASE}/sale/images`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/images (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/images\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"url\": \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/images (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"url\": \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/images\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/images (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"url\": \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/images\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/issues": { "get": { "operationId": "getIssues", "summary": "Reklamacje i dyskusje", "tags": [ "Dyskusje i reklamacje" ], "description": "Sprawy posprzedażowe. `allee.responseDeadline` = termin ustawowy (14 dni, art. 7a ustawy o prawach konsumenta) — brak odpowiedzi w terminie oznacza uznanie reklamacji.\n\nKupujący: id i login (bez danych kontaktowych).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/issues (BETA).\n**Uprawnienie:** zakres `allegro:api:disputes:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "maximum": 10000, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–100, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 100 } }, { "name": "type", "in": "query", "required": false, "description": "Rodzaj.", "schema": { "type": "string", "enum": [ "CLAIM", "DISPUTE" ] } }, { "name": "status", "in": "query", "required": false, "description": "Status.", "schema": { "type": "string", "enum": [ "CLAIM_SUBMITTED", "CLAIM_ACCEPTED", "CLAIM_REJECTED", "DISPUTE_ONGOING", "DISPUTE_CLOSED" ] } }, { "name": "checkoutForm.id", "in": "query", "required": false, "description": "Zamówienie.", "schema": { "type": "string", "format": "uuid" } }, { "name": "createdAt.gte", "in": "query", "required": false, "description": "Od.", "schema": { "type": "string", "format": "date-time" } }, { "name": "createdAt.lte", "in": "query", "required": false, "description": "Do.", "schema": { "type": "string", "format": "date-time" } } ], "responses": { "200": { "description": "Sprawy.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/IssueList" }, "example": { "issues": [ { "id": "RK-900000001", "type": "CLAIM", "referenceNumber": "RK-900000001", "status": "CLAIM_SUBMITTED", "subject": "Reklamacja (niezgodność towaru z umową)", "description": "Płyta nie odtwarza się od 40. minuty filmu.", "buyer": { "id": "4000000001", "login": "kupujacy_demo_4816f227" }, "checkoutForm": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "createdAt": "2026-11-10T11:10:05.411Z" }, "offer": { "id": "900000000000021" }, "expectations": [ "EXCHANGE" ], "openedDate": "2026-11-10T11:10:05.548Z", "createdAt": "2026-11-10T11:10:05.548Z", "decisionDueDate": "2026-11-24T11:10:05.000Z", "chat": { "messagesCount": 2, "lastMessageDateTime": "2026-11-10T11:10:05.549Z" }, "allee": { "responseDeadline": "2026-11-24T11:10:05.000Z", "deadlinePassed": false, "legalBasis": "art. 7a ustawy o prawach konsumenta (14 dni)", "demand": "Wymiana na nowy", "result": null, "resolution": null, "closedAt": null } } ], "count": 1, "totalCount": 1 } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/IssueList" } }, "application/json": { "schema": { "$ref": "#/components/schemas/IssueList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:disputes:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/issues (BETA)", "limitGroup": "read", "scope": "allegro:api:disputes:read", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/issues?type=CLAIM&limit=50\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/issues (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/issues?type=CLAIM&limit=50\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/issues (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/issues?type=CLAIM&limit=50`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/issues (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/issues?type=CLAIM&limit=50\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/issues (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/issues?type=CLAIM&limit=50\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/issues (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/issues?type=CLAIM&limit=50\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/issues/{issueId}": { "get": { "operationId": "getIssue", "summary": "Sprawa", "tags": [ "Dyskusje i reklamacje" ], "description": "Reklamacja albo dyskusja.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/issues/{issueId} (BETA).\n**Uprawnienie:** zakres `allegro:api:disputes:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "issueId", "in": "path", "required": true, "description": "Numer sprawy: RK-… (reklamacja) albo DS-… (dyskusja).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Sprawa.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/Issue" }, "example": { "id": "RK-900000001", "type": "CLAIM", "referenceNumber": "RK-900000001", "status": "CLAIM_SUBMITTED", "subject": "Reklamacja (niezgodność towaru z umową)", "description": "Płyta nie odtwarza się od 40. minuty filmu.", "buyer": { "id": "4000000001", "login": "kupujacy_demo_4816f227" }, "checkoutForm": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "createdAt": "2026-11-10T11:10:05.411Z" }, "offer": { "id": "900000000000021" }, "expectations": [ "EXCHANGE" ], "openedDate": "2026-11-10T11:10:05.548Z", "createdAt": "2026-11-10T11:10:05.548Z", "decisionDueDate": "2026-11-24T11:10:05.000Z", "chat": { "messagesCount": 2, "lastMessageDateTime": "2026-11-10T11:10:05.549Z" }, "allee": { "responseDeadline": "2026-11-24T11:10:05.000Z", "deadlinePassed": false, "legalBasis": "art. 7a ustawy o prawach konsumenta (14 dni)", "demand": "Wymiana na nowy", "result": null, "resolution": null, "closedAt": null } } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Issue" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Issue" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:disputes:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/issues/{issueId} (BETA)", "limitGroup": "read", "scope": "allegro:api:disputes:read", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/issues/RK-900000001\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/issues/RK-900000001 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/issues/RK-900000001\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/issues/RK-900000001 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/issues/RK-900000001`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/issues/RK-900000001 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/issues/RK-900000001\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/issues/RK-900000001 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/issues/RK-900000001\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/issues/RK-900000001 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/issues/RK-900000001\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/issues/{issueId}/chat": { "get": { "operationId": "getIssueChat", "summary": "Rozmowa w sprawie", "tags": [ "Dyskusje i reklamacje" ], "description": "Wiadomości sprawy, najstarsza pierwsza (do 200 ostatnich).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/issues/{issueId}/chat (BETA).\n**Uprawnienie:** zakres `allegro:api:disputes:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "issueId", "in": "path", "required": true, "description": "Numer sprawy: RK-… (reklamacja) albo DS-… (dyskusja).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Rozmowa.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/IssueChat" }, "example": { "chat": [ { "id": "900000011", "text": "Kupujący złożył reklamację RK-900000001 (niezgodność towaru z umową). Żądanie: Wymiana na nowy. Sprzedawca odpowiada do 24.11.2026 — brak odpowiedzi w 14 dni oznacza uznanie reklamacji (art. 7a ustawy o prawach konsumenta).", "type": "REGULAR", "createdAt": "2026-11-10T11:10:05.549Z", "author": { "login": "allee", "role": "ADMIN" }, "attachments": [], "allee": { "sender": "SYSTEM" } }, { "id": "900000012", "text": "Opis kupującego: Płyta nie odtwarza się od 40. minuty filmu.", "type": "REGULAR", "createdAt": "2026-11-10T11:10:05.549Z", "author": { "login": "allee", "role": "ADMIN" }, "attachments": [], "allee": { "sender": "SYSTEM" } } ] } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/IssueChat" } }, "application/json": { "schema": { "$ref": "#/components/schemas/IssueChat" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:disputes:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/issues/{issueId}/chat (BETA)", "limitGroup": "read", "scope": "allegro:api:disputes:read", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/issues/RK-900000001/chat\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/issues/RK-900000001/chat (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/issues/RK-900000001/chat\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/issues/RK-900000001/chat (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/issues/RK-900000001/chat`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/issues/RK-900000001/chat (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/issues/RK-900000001/chat\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/issues/RK-900000001/chat (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/issues/RK-900000001/chat\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/issues/RK-900000001/chat (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/issues/RK-900000001/chat\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/issues/{issueId}/message": { "post": { "operationId": "postIssueMessage", "summary": "Wiadomość w sprawie", "tags": [ "Dyskusje i reklamacje" ], "description": "Sprawa pozostaje otwarta (zamknięcie: `POST …/status`).\n\nTreść: bez linków zewnętrznych (422 `EXTERNAL_LINK`), filtr jak w panelu, najwyżej 20 wiadomości na godzinę wspólnie z panelem (429 `MESSAGE_LIMIT`). Bez załączników.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /sale/issues/{issueId}/message (BETA).\n**Uprawnienie:** zakres `allegro:api:disputes:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "issueId", "in": "path", "required": true, "description": "Numer sprawy: RK-… (reklamacja) albo DS-… (dyskusja).", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/IssueMessageInput" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/IssueMessageInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/IssueMessageInput" } } } }, "responses": { "201": { "description": "Wysłano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/IssueChatMessage" }, "example": { "id": "900000015", "text": "Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.", "type": "REGULAR", "createdAt": "2026-11-10T11:10:05.563Z", "author": { "login": "sklep_przykladowy_0e60e9", "role": "SELLER" }, "attachments": [], "allee": { "sender": "SELLER" } } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/IssueChatMessage" } }, "application/json": { "schema": { "$ref": "#/components/schemas/IssueChatMessage" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `NO_THREAD`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `CARD_DATA`, `EXTERNAL_LINK`, `JsonMappingException`, `PROFANITY`, `SENSITIVE_REQUEST`, `TEXT_EMPTY`, `TEXT_INVALID`, `TEXT_TOO_LONG`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `BUSY`, `MESSAGE_LIMIT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:disputes:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /sale/issues/{issueId}/message (BETA)", "limitGroup": "write", "scope": "allegro:api:disputes:write", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "NO_THREAD" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "CARD_DATA" }, { "status": 422, "code": "EXTERNAL_LINK" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "PROFANITY" }, { "status": 422, "code": "SENSITIVE_REQUEST" }, { "status": 422, "code": "TEXT_EMPTY" }, { "status": 422, "code": "TEXT_INVALID" }, { "status": 422, "code": "TEXT_TOO_LONG" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "BUSY" }, { "status": 429, "code": "MESSAGE_LIMIT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/issues/RK-900000001/message\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"text\": \"Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.\",\n \"type\": \"REGULAR\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.',\n 'type' => 'REGULAR',\n];\n$ch = curl_init($base . '/sale/issues/RK-900000001/message');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/issues/RK-900000001/message (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"text\": \"Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.\",\n \"type\": \"REGULAR\",\n}\nr = requests.request(\"POST\", BASE + \"/sale/issues/RK-900000001/message\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/issues/RK-900000001/message (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"text\": \"Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.\",\n \"type\": \"REGULAR\"\n};\nconst res = await fetch(`${BASE}/sale/issues/RK-900000001/message`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/issues/RK-900000001/message (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/issues/RK-900000001/message\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nvar json = \"\"\"\n{\n \"text\": \"Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.\",\n \"type\": \"REGULAR\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/issues/RK-900000001/message (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"text\": \"Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.\",\n \"type\": \"REGULAR\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/issues/RK-900000001/message\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/issues/RK-900000001/message (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"text\": \"Przepraszamy za kłopot. Prosimy odesłać płytę — wyślemy nowy egzemplarz.\",\n \"type\": \"REGULAR\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/issues/RK-900000001/message\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/issues/{issueId}/status": { "post": { "operationId": "changeIssueStatus", "summary": "Decyzja w sprawie", "tags": [ "Dyskusje i reklamacje" ], "description": "Reklamacja: `ACCEPTED` (uznana) albo `REJECTED` (nieuznana). Dyskusja: `RESOLVED`. `message` = odpowiedź do kupującego (wymagana), `solution` = krótko, jak rozwiązano.\n\nPo terminie ustawowym reklamację można już tylko uznać (409 `DEADLINE_PASSED`).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST /sale/issues/{issueId}/status (BETA).\n**Uprawnienie:** zakres `allegro:api:disputes:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "issueId", "in": "path", "required": true, "description": "Numer sprawy: RK-… (reklamacja) albo DS-… (dyskusja).", "schema": { "type": "string" } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/IssueStatusInput" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/IssueStatusInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/IssueStatusInput" } } } }, "responses": { "200": { "description": "Sprawa po decyzji.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/Issue" }, "example": { "id": "RK-900000001", "type": "CLAIM", "referenceNumber": "RK-900000001", "status": "CLAIM_ACCEPTED", "subject": "Reklamacja (niezgodność towaru z umową)", "description": "Płyta nie odtwarza się od 40. minuty filmu.", "buyer": { "id": "4000000001", "login": "kupujacy_demo_4816f227" }, "checkoutForm": { "id": "432810d0-4d26-4f39-ba5f-b89def4d4f92", "createdAt": "2026-11-10T11:10:05.411Z" }, "offer": { "id": "900000000000021" }, "expectations": [ "EXCHANGE" ], "openedDate": "2026-11-10T11:10:05.548Z", "createdAt": "2026-11-10T11:10:05.548Z", "decisionDueDate": null, "chat": { "messagesCount": 5, "lastMessageDateTime": "2026-11-10T11:10:05.567Z" }, "allee": { "responseDeadline": "2026-11-24T11:10:05.000Z", "deadlinePassed": false, "legalBasis": "art. 7a ustawy o prawach konsumenta (14 dni)", "demand": "Wymiana na nowy", "result": "ACCEPTED", "resolution": "Rozwiązanie: Wymiana na nowy egzemplarz.\nReklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.", "closedAt": "2026-11-10T11:10:05.566Z" } } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Issue" } }, "application/json": { "schema": { "$ref": "#/components/schemas/Issue" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `DEADLINE_PASSED`, `ISSUE_ALREADY_CLOSED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `CARD_DATA`, `EXTERNAL_LINK`, `INVALID_STATUS_FOR_TYPE`, `JsonMappingException`, `PROFANITY`, `SENSITIVE_REQUEST`, `TEXT_EMPTY`, `TEXT_INVALID`, `TEXT_TOO_LONG`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.beta.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:disputes:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST /sale/issues/{issueId}/status (BETA)", "limitGroup": "write", "scope": "allegro:api:disputes:write", "appTokenAllowed": false, "beta": true, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "DEADLINE_PASSED" }, { "status": 409, "code": "ISSUE_ALREADY_CLOSED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "CARD_DATA" }, { "status": 422, "code": "EXTERNAL_LINK" }, { "status": 422, "code": "INVALID_STATUS_FOR_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "PROFANITY" }, { "status": 422, "code": "SENSITIVE_REQUEST" }, { "status": 422, "code": "TEXT_EMPTY" }, { "status": 422, "code": "TEXT_INVALID" }, { "status": 422, "code": "TEXT_TOO_LONG" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/issues/RK-900000001/status\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.beta.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"status\": \"ACCEPTED\",\n \"message\": \"Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.\",\n \"solution\": \"Wymiana na nowy egzemplarz\"\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'ACCEPTED',\n 'message' => 'Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.',\n 'solution' => 'Wymiana na nowy egzemplarz',\n];\n$ch = curl_init($base . '/sale/issues/RK-900000001/status');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.beta.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/issues/RK-900000001/status (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"status\": \"ACCEPTED\",\n \"message\": \"Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.\",\n \"solution\": \"Wymiana na nowy egzemplarz\",\n}\nr = requests.request(\"POST\", BASE + \"/sale/issues/RK-900000001/status\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/issues/RK-900000001/status (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"status\": \"ACCEPTED\",\n \"message\": \"Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.\",\n \"solution\": \"Wymiana na nowy egzemplarz\"\n};\nconst res = await fetch(`${BASE}/sale/issues/RK-900000001/status`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.beta.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/issues/RK-900000001/status (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/issues/RK-900000001/status\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.beta.v1+json\");\nvar json = \"\"\"\n{\n \"status\": \"ACCEPTED\",\n \"message\": \"Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.\",\n \"solution\": \"Wymiana na nowy egzemplarz\"\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/issues/RK-900000001/status (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"status\": \"ACCEPTED\",\n \"message\": \"Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.\",\n \"solution\": \"Wymiana na nowy egzemplarz\"\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/issues/RK-900000001/status\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/issues/RK-900000001/status (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"status\": \"ACCEPTED\",\n \"message\": \"Reklamację uznajemy — nowy egzemplarz wyślemy po otrzymaniu płyty.\",\n \"solution\": \"Wymiana na nowy egzemplarz\"\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/issues/RK-900000001/status\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.beta.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/matching-categories": { "get": { "operationId": "getMatchingCategories", "summary": "Podpowiedź kategorii dla nazwy", "tags": [ "Kategorie" ], "description": "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ść.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/matching-categories.\n**Uprawnienie:** dowolny ważny token lub klucz (działa też token aplikacji `client_credentials`).\n**Grupa limitu:** `read`.", "parameters": [ { "name": "name", "in": "query", "required": true, "description": "Nazwa produktu albo tytuł oferty, np. „film dvd” (2–200 znaków).", "schema": { "type": "string", "minLength": 2, "maxLength": 200 } } ], "responses": { "200": { "description": "Podpowiedzi.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/MatchingCategoryList" }, "example": { "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": { "id": "257260", "alleeId": 636, "name": "Napędy optyczne i nośniki", "leaf": false, "parent": { "id": "2", "alleeId": 51, "name": "Komputery", "leaf": false, "parent": { "id": "42540aec-367a-4e5e-b411-17c09b08e41f", "alleeId": 3, "name": "Elektronika", "leaf": false, "parent": null } } } }, "allee": { "score": 3 } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/MatchingCategoryList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/matching-categories", "limitGroup": "read", "appTokenAllowed": true, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/matching-categories?name=film%20dvd\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/matching-categories (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/matching-categories?name=film%20dvd\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/matching-categories (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/matching-categories?name=film%20dvd`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/matching-categories (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/matching-categories?name=film%20dvd\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/matching-categories (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/matching-categories?name=film%20dvd\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/matching-categories (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/matching-categories?name=film%20dvd\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-bulk-modification-commands": { "post": { "operationId": "createBulkModificationCommand", "summary": "Wsad cen i stanów (kształt Allegro)", "tags": [ "Polecenia wsadowe" ], "description": "Ceny i liczby sztuk wielu ofert (do 10 000) w kształcie zbliżonym do poleceń Allegro: ofertę wskazujesz przez `id` albo `external.id` (SKU). Pod spodem to wsad `PARTIAL_UPDATE` — odpowiedź jak `POST /allee/feeds`.\n\n**Zgodność:** tylko allee — allee: alias wsadu JSON_LISTINGS_FEED.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/BulkModificationRequest" } }, "application/json": { "schema": { "$ref": "#/components/schemas/BulkModificationRequest" } } } }, "responses": { "202": { "description": "Przyjęto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Feed" }, "example": { "feedId": "bc37f1f9-1e46-4824-a7e1-3e298893f79e", "feedType": "JSON_LISTINGS_FEED", "marketplaceIds": [ "allee-pl" ], "createdTime": "2026-11-10T11:10:05.392Z", "processingStatus": "DONE", "processingStartTime": "2026-11-10T11:10:05.397Z", "processingEndTime": "2026-11-10T11:10:05.404Z", "resultFeedDocumentId": "bc37f1f9-1e46-4824-a7e1-3e298893f79e", "allee": { "source": "POLECENIE", "messages": { "total": 2, "processed": 2, "accepted": 2, "invalid": 0, "withWarnings": 0 }, "fatalError": null } } }, "application/json": { "schema": { "$ref": "#/components/schemas/Feed" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`, `QUEUE_UNAVAILABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "allee: alias wsadu JSON_LISTINGS_FEED", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" }, { "status": 503, "code": "QUEUE_UNAVAILABLE" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-bulk-modification-commands\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"offers\": [\n {\n \"external\": {\n \"id\": \"FILM-21ef85-5\"\n },\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 20\n }\n },\n {\n \"external\": {\n \"id\": \"FILM-21ef85-6\"\n },\n \"stock\": {\n \"available\": 18\n }\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n [\n 'external' => [\n 'id' => 'FILM-21ef85-5',\n ],\n 'sellingMode' => [\n 'price' => [\n 'amount' => '39.90',\n 'currency' => 'PLN',\n ],\n ],\n 'stock' => [\n 'available' => 20,\n ],\n ],\n [\n 'external' => [\n 'id' => 'FILM-21ef85-6',\n ],\n 'stock' => [\n 'available' => 18,\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-bulk-modification-commands');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/offer-bulk-modification-commands (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"offers\": [\n {\n \"external\": {\n \"id\": \"FILM-21ef85-5\",\n },\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\",\n },\n },\n \"stock\": {\n \"available\": 20,\n },\n },\n {\n \"external\": {\n \"id\": \"FILM-21ef85-6\",\n },\n \"stock\": {\n \"available\": 18,\n },\n },\n ],\n}\nr = requests.request(\"POST\", BASE + \"/sale/offer-bulk-modification-commands\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/offer-bulk-modification-commands (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"offers\": [\n {\n \"external\": {\n \"id\": \"FILM-21ef85-5\"\n },\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 20\n }\n },\n {\n \"external\": {\n \"id\": \"FILM-21ef85-6\"\n },\n \"stock\": {\n \"available\": 18\n }\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-bulk-modification-commands`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/offer-bulk-modification-commands (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/offer-bulk-modification-commands\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"offers\": [\n {\n \"external\": {\n \"id\": \"FILM-21ef85-5\"\n },\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 20\n }\n },\n {\n \"external\": {\n \"id\": \"FILM-21ef85-6\"\n },\n \"stock\": {\n \"available\": 18\n }\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/offer-bulk-modification-commands (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"offers\": [\n {\n \"external\": {\n \"id\": \"FILM-21ef85-5\"\n },\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 20\n }\n },\n {\n \"external\": {\n \"id\": \"FILM-21ef85-6\"\n },\n \"stock\": {\n \"available\": 18\n }\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-bulk-modification-commands\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/offer-bulk-modification-commands (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"offers\": [\n {\n \"external\": {\n \"id\": \"FILM-21ef85-5\"\n },\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"39.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 20\n }\n },\n {\n \"external\": {\n \"id\": \"FILM-21ef85-6\"\n },\n \"stock\": {\n \"available\": 18\n }\n }\n ]\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/offer-bulk-modification-commands\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-events": { "get": { "operationId": "getOfferEvents", "summary": "Zdarzenia ofert", "tags": [ "Oferty" ], "description": "Dziennik zmian Twoich ofert: aktywacja, zmiana, zakończenie, zmiana stanu i ceny. Bez `from` — ostatnie 24 h; dalej odpytuj z `from` = `id` ostatniego zdarzenia. Zdarzenia pojawiają się po 5 s.\n\n`allee.reason` mówi, dlaczego allee zmieniło ofertę (`MODERATION`, `EMPTY_STOCK`, `IMAGE_FAILED`).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/offer-events.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "from", "in": "query", "required": false, "description": "Kursor: zdarzenia po tym id.", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } }, { "name": "limit", "in": "query", "required": false, "description": "1–1000.", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } }, { "name": "type", "in": "query", "required": false, "description": "Filtr typów (powtórz parametr).", "schema": { "type": "array", "items": { "type": "string", "enum": [ "OFFER_ACTIVATED", "OFFER_CHANGED", "OFFER_ENDED", "OFFER_STOCK_CHANGED", "OFFER_PRICE_CHANGED", "OFFER_ARCHIVED" ] } }, "style": "form", "explode": true } ], "responses": { "200": { "description": "Zdarzenia.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferEventList" }, "example": { "offerEvents": [ { "id": "1", "occurredAt": "2026-11-10T11:09:53.374Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000001", "external": { "id": "DEMO-01" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "2", "occurredAt": "2026-11-10T11:09:53.382Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000002", "external": { "id": "DEMO-02" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "3", "occurredAt": "2026-11-10T11:09:53.385Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000003", "external": { "id": "DEMO-03" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "4", "occurredAt": "2026-11-10T11:09:53.387Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000004", "external": { "id": "DEMO-04" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "5", "occurredAt": "2026-11-10T11:09:53.391Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000005", "external": { "id": "DEMO-05" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "6", "occurredAt": "2026-11-10T11:09:53.398Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000006", "external": { "id": "DEMO-06" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "7", "occurredAt": "2026-11-10T11:09:53.404Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000007", "external": { "id": "DEMO-07" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "8", "occurredAt": "2026-11-10T11:09:53.413Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000008", "external": { "id": "DEMO-08" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "9", "occurredAt": "2026-11-10T11:09:53.417Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000009", "external": { "id": "DEMO-09" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "10", "occurredAt": "2026-11-10T11:09:53.420Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000010", "external": { "id": "DEMO-10" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "11", "occurredAt": "2026-11-10T11:09:53.424Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000011", "external": { "id": "DEMO-11" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "12", "occurredAt": "2026-11-10T11:09:53.429Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000012", "external": { "id": "DEMO-12" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "13", "occurredAt": "2026-11-10T11:09:53.435Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000013", "external": { "id": "DEMO-13" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "14", "occurredAt": "2026-11-10T11:09:53.441Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000014", "external": { "id": "DEMO-14" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "15", "occurredAt": "2026-11-10T11:09:53.446Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000015", "external": { "id": "DEMO-15" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "16", "occurredAt": "2026-11-10T11:09:53.451Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000016", "external": { "id": "DEMO-16" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "17", "occurredAt": "2026-11-10T11:09:53.454Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000017", "external": { "id": "DEMO-17" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "18", "occurredAt": "2026-11-10T11:09:53.457Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000018", "external": { "id": "DEMO-18" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "19", "occurredAt": "2026-11-10T11:09:53.461Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000019", "external": { "id": "DEMO-19" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "20", "occurredAt": "2026-11-10T11:09:53.464Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000020", "external": { "id": "DEMO-20" } }, "allee": { "reason": null, "from": null, "to": "ACTIVE", "source": "app" } }, { "id": "23", "occurredAt": "2026-11-10T11:09:53.766Z", "type": "OFFER_ACTIVATED", "offer": { "id": "900000000000021", "external": { "id": "FILM-21ef85-1" } }, "allee": { "reason": null, "from": "ACTIVATING", "to": "ACTIVE", "source": "system" } }, { "id": "24", "occurredAt": "2026-11-10T11:09:53.778Z", "type": "OFFER_PRICE_CHANGED", "offer": { "id": "900000000000021", "external": { "id": "FILM-21ef85-1" } }, "allee": { "reason": null, "from": "4990", "to": "4490", "source": "app" } }, { "id": "25", "occurredAt": "2026-11-10T11:09:53.778Z", "type": "OFFER_STOCK_CHANGED", "offer": { "id": "900000000000021", "external": { "id": "FILM-21ef85-1" } }, "allee": { "reason": null, "from": "10", "to": "8", "source": "app" } } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferEventList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/offer-events", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-events?type=OFFER_ACTIVATED&type=OFFER_PRICE_CHANGED&type=OFFER_STOCK_CHANGED&limit=100\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-events (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-events?type=OFFER_ACTIVATED&type=OFFER_PRICE_CHANGED&type=OFFER_STOCK_CHANGED&limit=100\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-events (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-events?type=OFFER_ACTIVATED&type=OFFER_PRICE_CHANGED&type=OFFER_STOCK_CHANGED&limit=100`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-events (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-events?type=OFFER_ACTIVATED&type=OFFER_PRICE_CHANGED&type=OFFER_STOCK_CHANGED&limit=100\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-events (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-events?type=OFFER_ACTIVATED&type=OFFER_PRICE_CHANGED&type=OFFER_STOCK_CHANGED&limit=100\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-events (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-events?type=OFFER_ACTIVATED&type=OFFER_PRICE_CHANGED&type=OFFER_STOCK_CHANGED&limit=100\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-modification-commands/{commandId}": { "put": { "operationId": "createModificationCommand", "summary": "Polecenie zmiany ustawień ofert", "tags": [ "Polecenia wsadowe" ], "description": "Do 1000 ofert (`offerCriteria` typu `CONTAINS_OFFERS`). allee wykonuje polecenie **od razu**: odpowiedź 201 ma ostateczne `taskCount`, a zadania mają statusy `SUCCESS`/`FAIL` (bez `NEW`/`RUNNING`).\n\nTen sam `commandId` w poleceniu innego rodzaju → **409 `COMMAND_ID_CONFLICT`**. Oferta cudza albo nieistniejąca → zadanie `FAIL` (reszta się wykonuje). Błąd całego polecenia → 422 i nic się nie wykonuje.\n\nZmieniane pola: tylko `delivery` (handlingTime, shippingRates) i `afterSalesServices`.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — PUT /sale/offer-modification-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ModificationCommand" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ModificationCommand" } } } }, "responses": { "201": { "description": "Wykonano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "47e71c9d-d10c-4f7e-b9b8-14d98b923ced", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.436Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `COMMAND_ID_CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: PUT /sale/offer-modification-commands/{commandId}", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "COMMAND_ID_CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"modification\": {\n \"delivery\": {\n \"handlingTime\": \"P2D\"\n },\n \"afterSalesServices\": {\n \"warranty\": {\n \"id\": \"5be961ca-7c55-4d2a-9332-93d58877d4a2\"\n }\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'delivery' => [\n 'handlingTime' => 'P2D',\n ],\n 'afterSalesServices' => [\n 'warranty' => [\n 'id' => '5be961ca-7c55-4d2a-9332-93d58877d4a2',\n ],\n ],\n ],\n 'offerCriteria' => [\n [\n 'type' => 'CONTAINS_OFFERS',\n 'offers' => [\n [\n 'id' => '900000000000021',\n ],\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"modification\": {\n \"delivery\": {\n \"handlingTime\": \"P2D\",\n },\n \"afterSalesServices\": {\n \"warranty\": {\n \"id\": \"5be961ca-7c55-4d2a-9332-93d58877d4a2\",\n },\n },\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n },\n ],\n },\n ],\n}\nr = requests.request(\"PUT\", BASE + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"modification\": {\n \"delivery\": {\n \"handlingTime\": \"P2D\"\n },\n \"afterSalesServices\": {\n \"warranty\": {\n \"id\": \"5be961ca-7c55-4d2a-9332-93d58877d4a2\"\n }\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"modification\": {\n \"delivery\": {\n \"handlingTime\": \"P2D\"\n },\n \"afterSalesServices\": {\n \"warranty\": {\n \"id\": \"5be961ca-7c55-4d2a-9332-93d58877d4a2\"\n }\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"modification\": {\n \"delivery\": {\n \"handlingTime\": \"P2D\"\n },\n \"afterSalesServices\": {\n \"warranty\": {\n \"id\": \"5be961ca-7c55-4d2a-9332-93d58877d4a2\"\n }\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"modification\": {\n \"delivery\": {\n \"handlingTime\": \"P2D\"\n },\n \"afterSalesServices\": {\n \"warranty\": {\n \"id\": \"5be961ca-7c55-4d2a-9332-93d58877d4a2\"\n }\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getModificationCommandStatus", "summary": "Wynik polecenia zmiany ustawień ofert", "tags": [ "Polecenia wsadowe" ], "description": "Podsumowanie polecenia (liczniki zadań).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-modification-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Wynik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "47e71c9d-d10c-4f7e-b9b8-14d98b923ced", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.436Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-modification-commands/{commandId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-modification-commands/{commandId}/tasks": { "get": { "operationId": "getModificationCommandTasks", "summary": "Zadania polecenia zmiany ustawień ofert", "tags": [ "Polecenia wsadowe" ], "description": "Wynik dla każdej oferty: `SUCCESS` albo `FAIL` z błędami.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-modification-commands/{commandId}/tasks.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } }, { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–1000, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } } ], "responses": { "200": { "description": "Zadania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" }, "example": { "tasks": [ { "offer": { "id": "900000000000021" }, "status": "SUCCESS", "message": "Zmieniono.", "errors": [], "finishedAt": "2026-11-10T11:10:04.436Z" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-modification-commands/{commandId}/tasks", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-modification-commands/47e71c9d-d10c-4f7e-b9b8-14d98b923ced/tasks\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-price-change-commands/{commandId}": { "put": { "operationId": "createPriceChangeCommand", "summary": "Polecenie zmiany ceny", "tags": [ "Polecenia wsadowe" ], "description": "Do 1000 ofert (`offerCriteria` typu `CONTAINS_OFFERS`). allee wykonuje polecenie **od razu**: odpowiedź 201 ma ostateczne `taskCount`, a zadania mają statusy `SUCCESS`/`FAIL` (bez `NEW`/`RUNNING`).\n\nTen sam `commandId` w poleceniu innego rodzaju → **409 `COMMAND_ID_CONFLICT`**. Oferta cudza albo nieistniejąca → zadanie `FAIL` (reszta się wykonuje). Błąd całego polecenia → 422 i nic się nie wykonuje.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — PUT /sale/offer-price-change-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/PriceChangeCommand" } }, "application/json": { "schema": { "$ref": "#/components/schemas/PriceChangeCommand" } } } }, "responses": { "201": { "description": "Wykonano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "12e4b766-0096-4404-9546-167845ebb846", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.426Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `COMMAND_ID_CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: PUT /sale/offer-price-change-commands/{commandId}", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "COMMAND_ID_CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"modification\": {\n \"type\": \"FIXED_PRICE\",\n \"price\": {\n \"amount\": \"42.90\",\n \"currency\": \"PLN\"\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'type' => 'FIXED_PRICE',\n 'price' => [\n 'amount' => '42.90',\n 'currency' => 'PLN',\n ],\n ],\n 'offerCriteria' => [\n [\n 'type' => 'CONTAINS_OFFERS',\n 'offers' => [\n [\n 'id' => '900000000000021',\n ],\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"modification\": {\n \"type\": \"FIXED_PRICE\",\n \"price\": {\n \"amount\": \"42.90\",\n \"currency\": \"PLN\",\n },\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n },\n ],\n },\n ],\n}\nr = requests.request(\"PUT\", BASE + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"modification\": {\n \"type\": \"FIXED_PRICE\",\n \"price\": {\n \"amount\": \"42.90\",\n \"currency\": \"PLN\"\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"modification\": {\n \"type\": \"FIXED_PRICE\",\n \"price\": {\n \"amount\": \"42.90\",\n \"currency\": \"PLN\"\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"modification\": {\n \"type\": \"FIXED_PRICE\",\n \"price\": {\n \"amount\": \"42.90\",\n \"currency\": \"PLN\"\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"modification\": {\n \"type\": \"FIXED_PRICE\",\n \"price\": {\n \"amount\": \"42.90\",\n \"currency\": \"PLN\"\n }\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getPriceChangeCommandStatus", "summary": "Wynik polecenia zmiany ceny", "tags": [ "Polecenia wsadowe" ], "description": "Podsumowanie polecenia (liczniki zadań).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-price-change-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Wynik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "12e4b766-0096-4404-9546-167845ebb846", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.426Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-price-change-commands/{commandId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-price-change-commands/{commandId}/tasks": { "get": { "operationId": "getPriceChangeCommandTasks", "summary": "Zadania polecenia zmiany ceny", "tags": [ "Polecenia wsadowe" ], "description": "Wynik dla każdej oferty: `SUCCESS` albo `FAIL` z błędami.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-price-change-commands/{commandId}/tasks.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } }, { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–1000, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } } ], "responses": { "200": { "description": "Zadania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" }, "example": { "tasks": [ { "offer": { "id": "900000000000021" }, "status": "SUCCESS", "message": "Zmieniono.", "errors": [], "finishedAt": "2026-11-10T11:10:04.426Z" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-price-change-commands/{commandId}/tasks", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-price-change-commands/12e4b766-0096-4404-9546-167845ebb846/tasks\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-publication-commands/{commandId}": { "put": { "operationId": "createPublicationCommand", "summary": "Polecenie publikacji (ACTIVATE / END)", "tags": [ "Polecenia wsadowe" ], "description": "Do 1000 ofert (`offerCriteria` typu `CONTAINS_OFFERS`). allee wykonuje polecenie **od razu**: odpowiedź 201 ma ostateczne `taskCount`, a zadania mają statusy `SUCCESS`/`FAIL` (bez `NEW`/`RUNNING`).\n\nTen sam `commandId` w poleceniu innego rodzaju → **409 `COMMAND_ID_CONFLICT`**. Oferta cudza albo nieistniejąca → zadanie `FAIL` (reszta się wykonuje). Błąd całego polecenia → 422 i nic się nie wykonuje.\n\n`END`: aktywna → `ENDED` (szkicu nie kończymy — zadanie FAIL `INVALID_STATUS_TRANSITION`). `ACTIVATE`: wymaga GPSR, zdjęcia i sztuk.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — PUT /sale/offer-publication-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/PublicationCommand" } }, "application/json": { "schema": { "$ref": "#/components/schemas/PublicationCommand" } } } }, "responses": { "201": { "description": "Wykonano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "c4ef5910-5a7e-4eec-bc50-54280523053e", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.445Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `COMMAND_ID_CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: PUT /sale/offer-publication-commands/{commandId}", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "COMMAND_ID_CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"publication\": {\n \"action\": \"END\"\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'action' => 'END',\n ],\n 'offerCriteria' => [\n [\n 'type' => 'CONTAINS_OFFERS',\n 'offers' => [\n [\n 'id' => '900000000000021',\n ],\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"publication\": {\n \"action\": \"END\",\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n },\n ],\n },\n ],\n}\nr = requests.request(\"PUT\", BASE + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"publication\": {\n \"action\": \"END\"\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"publication\": {\n \"action\": \"END\"\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"publication\": {\n \"action\": \"END\"\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"publication\": {\n \"action\": \"END\"\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getPublicationCommandStatus", "summary": "Wynik polecenia publikacji (ACTIVATE / END)", "tags": [ "Polecenia wsadowe" ], "description": "Podsumowanie polecenia (liczniki zadań).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-publication-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Wynik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "c4ef5910-5a7e-4eec-bc50-54280523053e", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.445Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-publication-commands/{commandId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-publication-commands/{commandId}/tasks": { "get": { "operationId": "getPublicationCommandTasks", "summary": "Zadania polecenia publikacji (ACTIVATE / END)", "tags": [ "Polecenia wsadowe" ], "description": "Wynik dla każdej oferty: `SUCCESS` albo `FAIL` z błędami.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-publication-commands/{commandId}/tasks.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } }, { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–1000, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } } ], "responses": { "200": { "description": "Zadania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" }, "example": { "tasks": [ { "offer": { "id": "900000000000021" }, "status": "SUCCESS", "message": "Oferta zakończona.", "errors": [], "finishedAt": "2026-11-10T11:10:04.445Z" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-publication-commands/{commandId}/tasks", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-publication-commands/c4ef5910-5a7e-4eec-bc50-54280523053e/tasks\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-quantity-change-commands/{commandId}": { "put": { "operationId": "createQuantityChangeCommand", "summary": "Polecenie zmiany liczby sztuk", "tags": [ "Polecenia wsadowe" ], "description": "Do 1000 ofert (`offerCriteria` typu `CONTAINS_OFFERS`). allee wykonuje polecenie **od razu**: odpowiedź 201 ma ostateczne `taskCount`, a zadania mają statusy `SUCCESS`/`FAIL` (bez `NEW`/`RUNNING`).\n\nTen sam `commandId` w poleceniu innego rodzaju → **409 `COMMAND_ID_CONFLICT`**. Oferta cudza albo nieistniejąca → zadanie `FAIL` (reszta się wykonuje). Błąd całego polecenia → 422 i nic się nie wykonuje.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — PUT /sale/offer-quantity-change-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `bulk`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/QuantityChangeCommand" } }, "application/json": { "schema": { "$ref": "#/components/schemas/QuantityChangeCommand" } } } }, "responses": { "201": { "description": "Wykonano.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "ff689dde-05d2-451d-ad17-4673a2939891", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.415Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `COMMAND_ID_CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_CONCURRENT`, `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: PUT /sale/offer-quantity-change-commands/{commandId}", "limitGroup": "bulk", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "COMMAND_ID_CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_CONCURRENT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"modification\": {\n \"changeType\": \"FIXED\",\n \"value\": 12\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'changeType' => 'FIXED',\n 'value' => 12,\n ],\n 'offerCriteria' => [\n [\n 'type' => 'CONTAINS_OFFERS',\n 'offers' => [\n [\n 'id' => '900000000000021',\n ],\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"modification\": {\n \"changeType\": \"FIXED\",\n \"value\": 12,\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n },\n ],\n },\n ],\n}\nr = requests.request(\"PUT\", BASE + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"modification\": {\n \"changeType\": \"FIXED\",\n \"value\": 12\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"modification\": {\n \"changeType\": \"FIXED\",\n \"value\": 12\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"modification\": {\n \"changeType\": \"FIXED\",\n \"value\": 12\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"modification\": {\n \"changeType\": \"FIXED\",\n \"value\": 12\n },\n \"offerCriteria\": [\n {\n \"type\": \"CONTAINS_OFFERS\",\n \"offers\": [\n {\n \"id\": \"900000000000021\"\n }\n ]\n }\n ]\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getQuantityChangeCommandStatus", "summary": "Wynik polecenia zmiany liczby sztuk", "tags": [ "Polecenia wsadowe" ], "description": "Podsumowanie polecenia (liczniki zadań).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-quantity-change-commands/{commandId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Wynik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandResult" }, "example": { "id": "ff689dde-05d2-451d-ad17-4673a2939891", "taskCount": { "total": 1, "success": 1, "failed": 0 }, "createdAt": "2026-11-10T11:10:04.415Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandResult" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-quantity-change-commands/{commandId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-quantity-change-commands/{commandId}/tasks": { "get": { "operationId": "getQuantityChangeCommandTasks", "summary": "Zadania polecenia zmiany liczby sztuk", "tags": [ "Polecenia wsadowe" ], "description": "Wynik dla każdej oferty: `SUCCESS` albo `FAIL` z błędami.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offer-quantity-change-commands/{commandId}/tasks.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "commandId", "in": "path", "required": true, "description": "Twój identyfikator polecenia (UUID) — powtórzony PUT zwraca zapisany wynik i niczego nie wykonuje drugi raz.", "schema": { "type": "string", "format": "uuid" } }, { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–1000, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } } ], "responses": { "200": { "description": "Zadania.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" }, "example": { "tasks": [ { "offer": { "id": "900000000000021" }, "status": "SUCCESS", "message": "Zmieniono.", "errors": [], "finishedAt": "2026-11-10T11:10:04.415Z" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/CommandTaskList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offer-quantity-change-commands/{commandId}/tasks", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks?limit=100&offset=0\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks?limit=100&offset=0\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks?limit=100&offset=0`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks?limit=100&offset=0\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks?limit=100&offset=0\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-quantity-change-commands/ff689dde-05d2-451d-ad17-4673a2939891/tasks?limit=100&offset=0\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-variants": { "post": { "operationId": "createOfferVariantSet", "summary": "Utworzenie zestawu wariantów (identyfikator nadaje allee)", "tags": [ "Warianty ofert" ], "description": "To samo co PUT, ale `setId` nadaje allee — odpowiedź 201 z nagłówkiem `Location`. Obsługuje `Idempotency-Key` (powtórka nie tworzy drugiego zestawu).\n\nZasady (jak Allegro): nazwa 1–50 znaków; 1–2 parametry wyboru (`id` parametru Allegro, `{\"alleeId\": …}` albo `color/pattern`); 2–500 ofert TEGO SAMEGO sprzedawcy, z tej samej kategorii-liścia, Kup Teraz; oferta w najwyżej jednym zestawie; każda oferta z inną kombinacją wartości. Wartość parametru każdej oferty bierzemy Z OFERTY (zestaw jej nie zmienia); `colorPattern` (≤ 64 znaki) podajesz przy ofercie. Błędy — wszystkie naraz (422, `path` = `offers[i].id`).\n\nPo zmianie oferty (PATCH parametru, kategorii, usunięcie szkicu) zestaw sprawdza się sam: oferta, która przestała pasować, wypada z zestawu (zdarzenie `OFFER_CHANGED`, `allee.reason` = `variant_set_detached:…`), a zestaw z jedną ofertą jest rozwiązywany.\n\n**Zgodność:** tylko allee — PUT /sale/offer-variants/{setId} (tu setId nadaje serwer).\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferVariantSetInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferVariantSetInput" } } } }, "responses": { "201": { "description": "Utworzono (nagłówek Location = /sale/offer-variants/{setId}).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Location": { "$ref": "#/components/headers/Location" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferVariantSet" }, "example": { "id": "2acf7981-8d96-48bb-8eb0-c6f4267e1eec", "name": "Podróż na Księżyc — wydania", "parameters": [ { "id": "color/pattern" } ], "offers": [ { "id": "900000000000021", "colorPattern": "DVD" }, { "id": "900000000000023", "colorPattern": "Blu-ray" } ], "allee": { "setId": 1, "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "color/pattern", "alleeId": 0, "name": "Kolor" } ], "offers": [ { "id": "900000000000021", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "DVD", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 8 }, "sellingMode": { "price": { "amount": "44.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-1" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021" }, { "id": "900000000000023", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "Blu-ray", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 10 }, "sellingMode": { "price": { "amount": "49.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-WAR" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-blu-ray-wydanie-kolekcjonerskie-900000000000023" } ], "createdAt": "2026-11-10T11:10:04.000Z", "updatedAt": "2026-11-10T11:10:04.000Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferVariantSet" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `VARIANT_SET_CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VARIANT_SET_COLOR_PATTERN_REQUIRED`, `VARIANT_SET_COLOR_PATTERN_TOO_LONG`, `VARIANT_SET_DIFFERENT_CATEGORIES`, `VARIANT_SET_DUPLICATED_OFFER`, `VARIANT_SET_DUPLICATED_VARIANT`, `VARIANT_SET_NAME_INVALID`, `VARIANT_SET_OFFER_AMBIGUOUS_PARAMETER`, `VARIANT_SET_OFFER_IN_OTHER_SET`, `VARIANT_SET_OFFER_MISSING_PARAMETER`, `VARIANT_SET_OFFER_NOT_BUY_NOW`, `VARIANT_SET_OFFER_NOT_FOUND`, `VARIANT_SET_PARAMETERS_INVALID`, `VARIANT_SET_PARAMETER_NOT_IN_CATEGORY`, `VARIANT_SET_TOO_FEW_OFFERS`, `VARIANT_SET_TOO_MANY_OFFERS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Allegro: PUT /sale/offer-variants/{setId} (tu setId nadaje serwer)", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "VARIANT_SET_CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VARIANT_SET_COLOR_PATTERN_REQUIRED" }, { "status": 422, "code": "VARIANT_SET_COLOR_PATTERN_TOO_LONG" }, { "status": 422, "code": "VARIANT_SET_DIFFERENT_CATEGORIES" }, { "status": 422, "code": "VARIANT_SET_DUPLICATED_OFFER" }, { "status": 422, "code": "VARIANT_SET_DUPLICATED_VARIANT" }, { "status": 422, "code": "VARIANT_SET_NAME_INVALID" }, { "status": 422, "code": "VARIANT_SET_OFFER_AMBIGUOUS_PARAMETER" }, { "status": 422, "code": "VARIANT_SET_OFFER_IN_OTHER_SET" }, { "status": 422, "code": "VARIANT_SET_OFFER_MISSING_PARAMETER" }, { "status": 422, "code": "VARIANT_SET_OFFER_NOT_BUY_NOW" }, { "status": 422, "code": "VARIANT_SET_OFFER_NOT_FOUND" }, { "status": 422, "code": "VARIANT_SET_PARAMETERS_INVALID" }, { "status": 422, "code": "VARIANT_SET_PARAMETER_NOT_IN_CATEGORY" }, { "status": 422, "code": "VARIANT_SET_TOO_FEW_OFFERS" }, { "status": 422, "code": "VARIANT_SET_TOO_MANY_OFFERS" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-variants\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Podróż na Księżyc — wydania\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n },\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Podróż na Księżyc — wydania',\n 'parameters' => [\n [\n 'id' => 'color/pattern',\n ],\n ],\n 'offers' => [\n [\n 'id' => '900000000000021',\n 'colorPattern' => 'DVD',\n ],\n [\n 'id' => '900000000000023',\n 'colorPattern' => 'Blu-ray',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-variants');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/offer-variants (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Podróż na Księżyc — wydania\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\",\n },\n ],\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\",\n },\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\",\n },\n ],\n}\nr = requests.request(\"POST\", BASE + \"/sale/offer-variants\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/offer-variants (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Podróż na Księżyc — wydania\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n },\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-variants`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/offer-variants (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/offer-variants\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Podróż na Księżyc — wydania\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n },\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/offer-variants (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Podróż na Księżyc — wydania\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n },\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-variants\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/offer-variants (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Podróż na Księżyc — wydania\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n },\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n }\n ]\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/offer-variants\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getOfferVariantSets", "summary": "Lista zestawów wariantów", "tags": [ "Warianty ofert" ], "description": "Zestawy sprzedawcy od najnowszego. `user.id` (Allegro: wymagany) jest u nas opcjonalny — jeśli podany, musi wskazywać zalogowanego sprzedawcę (inaczej 403). `query` = fragment nazwy.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/offer-variants.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–100, domyślnie 20).", "schema": { "type": "integer", "minimum": 1, "maximum": 100, "default": 20 } }, { "name": "user.id", "in": "query", "required": false, "description": "Identyfikator zalogowanego sprzedawcy (opcjonalny).", "schema": { "type": "string" } }, { "name": "query", "in": "query", "required": false, "description": "Fragment nazwy zestawu.", "schema": { "type": "string", "maxLength": 50 } } ], "responses": { "200": { "description": "Zestawy.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferVariantSetList" }, "example": { "offerVariants": [ { "id": "2acf7981-8d96-48bb-8eb0-c6f4267e1eec", "name": "Podróż na Księżyc — DVD i Blu-ray", "parameters": [ { "id": "color/pattern" } ], "offers": [ { "id": "900000000000023", "colorPattern": "Blu-ray" }, { "id": "900000000000021", "colorPattern": "DVD" } ], "allee": { "setId": 1, "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "color/pattern", "alleeId": 0, "name": "Kolor" } ], "offers": [ { "id": "900000000000023", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "Blu-ray", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 10 }, "sellingMode": { "price": { "amount": "49.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-WAR" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-blu-ray-wydanie-kolekcjonerskie-900000000000023" }, { "id": "900000000000021", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "DVD", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 8 }, "sellingMode": { "price": { "amount": "44.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-1" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021" } ], "createdAt": "2026-11-10T11:10:04.000Z", "updatedAt": "2026-11-10T11:10:04.000Z" } } ], "count": 1, "totalCount": 1 } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferVariantSetList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/offer-variants", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-variants?limit=20\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-variants (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-variants?limit=20\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-variants (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-variants?limit=20`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-variants (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-variants?limit=20\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-variants (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-variants?limit=20\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-variants (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-variants?limit=20\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offer-variants/{setId}": { "put": { "operationId": "putOfferVariantSet", "summary": "Utworzenie albo zmiana zestawu wariantów", "tags": [ "Warianty ofert" ], "description": "Łączy oferty w jeden zestaw wariantów (np. rozmiary 38–44): kupujący widzi przełącznik na stronie każdej oferty, a wyszukiwarka pokazuje JEDNĄ kartę z listą dostępnych wartości. Nowy `setId` = utworzenie, istniejący = pełna podmiana (kolejność ofert = kolejność w odpowiedzi).\n\nZasady (jak Allegro): nazwa 1–50 znaków; 1–2 parametry wyboru (`id` parametru Allegro, `{\"alleeId\": …}` albo `color/pattern`); 2–500 ofert TEGO SAMEGO sprzedawcy, z tej samej kategorii-liścia, Kup Teraz; oferta w najwyżej jednym zestawie; każda oferta z inną kombinacją wartości. Wartość parametru każdej oferty bierzemy Z OFERTY (zestaw jej nie zmienia); `colorPattern` (≤ 64 znaki) podajesz przy ofercie. Błędy — wszystkie naraz (422, `path` = `offers[i].id`).\n\nPo zmianie oferty (PATCH parametru, kategorii, usunięcie szkicu) zestaw sprawdza się sam: oferta, która przestała pasować, wypada z zestawu (zdarzenie `OFFER_CHANGED`, `allee.reason` = `variant_set_detached:…`), a zestaw z jedną ofertą jest rozwiązywany.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /sale/offer-variants/{setId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "setId", "in": "path", "required": true, "description": "Identyfikator zestawu (UUID — w PUT nadaje go integrator, zalecany v4).", "schema": { "type": "string", "format": "uuid" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferVariantSetInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferVariantSetInput" } } } }, "responses": { "200": { "description": "Zestaw (utworzony albo zmieniony).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferVariantSet" }, "example": { "id": "2acf7981-8d96-48bb-8eb0-c6f4267e1eec", "name": "Podróż na Księżyc — DVD i Blu-ray", "parameters": [ { "id": "color/pattern" } ], "offers": [ { "id": "900000000000023", "colorPattern": "Blu-ray" }, { "id": "900000000000021", "colorPattern": "DVD" } ], "allee": { "setId": 1, "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "color/pattern", "alleeId": 0, "name": "Kolor" } ], "offers": [ { "id": "900000000000023", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "Blu-ray", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 10 }, "sellingMode": { "price": { "amount": "49.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-WAR" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-blu-ray-wydanie-kolekcjonerskie-900000000000023" }, { "id": "900000000000021", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "DVD", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 8 }, "sellingMode": { "price": { "amount": "44.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-1" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021" } ], "createdAt": "2026-11-10T11:10:04.000Z", "updatedAt": "2026-11-10T11:10:04.000Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferVariantSet" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `VARIANT_SET_CONFLICT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `VARIANT_SET_COLOR_PATTERN_REQUIRED`, `VARIANT_SET_COLOR_PATTERN_TOO_LONG`, `VARIANT_SET_DIFFERENT_CATEGORIES`, `VARIANT_SET_DUPLICATED_OFFER`, `VARIANT_SET_DUPLICATED_VARIANT`, `VARIANT_SET_NAME_INVALID`, `VARIANT_SET_OFFER_AMBIGUOUS_PARAMETER`, `VARIANT_SET_OFFER_IN_OTHER_SET`, `VARIANT_SET_OFFER_MISSING_PARAMETER`, `VARIANT_SET_OFFER_NOT_BUY_NOW`, `VARIANT_SET_OFFER_NOT_FOUND`, `VARIANT_SET_PARAMETERS_INVALID`, `VARIANT_SET_PARAMETER_NOT_IN_CATEGORY`, `VARIANT_SET_TOO_FEW_OFFERS`, `VARIANT_SET_TOO_MANY_OFFERS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /sale/offer-variants/{setId}", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "VARIANT_SET_CONFLICT" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "VARIANT_SET_COLOR_PATTERN_REQUIRED" }, { "status": 422, "code": "VARIANT_SET_COLOR_PATTERN_TOO_LONG" }, { "status": 422, "code": "VARIANT_SET_DIFFERENT_CATEGORIES" }, { "status": 422, "code": "VARIANT_SET_DUPLICATED_OFFER" }, { "status": 422, "code": "VARIANT_SET_DUPLICATED_VARIANT" }, { "status": 422, "code": "VARIANT_SET_NAME_INVALID" }, { "status": 422, "code": "VARIANT_SET_OFFER_AMBIGUOUS_PARAMETER" }, { "status": 422, "code": "VARIANT_SET_OFFER_IN_OTHER_SET" }, { "status": 422, "code": "VARIANT_SET_OFFER_MISSING_PARAMETER" }, { "status": 422, "code": "VARIANT_SET_OFFER_NOT_BUY_NOW" }, { "status": 422, "code": "VARIANT_SET_OFFER_NOT_FOUND" }, { "status": 422, "code": "VARIANT_SET_PARAMETERS_INVALID" }, { "status": 422, "code": "VARIANT_SET_PARAMETER_NOT_IN_CATEGORY" }, { "status": 422, "code": "VARIANT_SET_TOO_FEW_OFFERS" }, { "status": 422, "code": "VARIANT_SET_TOO_MANY_OFFERS" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Podróż na Księżyc — DVD i Blu-ray\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n },\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Podróż na Księżyc — DVD i Blu-ray',\n 'parameters' => [\n [\n 'id' => 'color/pattern',\n ],\n ],\n 'offers' => [\n [\n 'id' => '900000000000023',\n 'colorPattern' => 'Blu-ray',\n ],\n [\n 'id' => '900000000000021',\n 'colorPattern' => 'DVD',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Podróż na Księżyc — DVD i Blu-ray\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\",\n },\n ],\n \"offers\": [\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\",\n },\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\",\n },\n ],\n}\nr = requests.request(\"PUT\", BASE + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Podróż na Księżyc — DVD i Blu-ray\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n },\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Podróż na Księżyc — DVD i Blu-ray\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n },\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Podróż na Księżyc — DVD i Blu-ray\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n },\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Podróż na Księżyc — DVD i Blu-ray\",\n \"parameters\": [\n {\n \"id\": \"color/pattern\"\n }\n ],\n \"offers\": [\n {\n \"id\": \"900000000000023\",\n \"colorPattern\": \"Blu-ray\"\n },\n {\n \"id\": \"900000000000021\",\n \"colorPattern\": \"DVD\"\n }\n ]\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "get": { "operationId": "getOfferVariantSet", "summary": "Zestaw wariantów", "tags": [ "Warianty ofert" ], "description": "Zestaw w kształcie Allegro + blok `allee`: wartości wyboru każdej oferty, status publikacji, stan, cena, SKU i adres strony oferty. Zestaw innego sprzedawcy → 403.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/offer-variants/{setId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "setId", "in": "path", "required": true, "description": "Identyfikator zestawu (UUID — w PUT nadaje go integrator, zalecany v4).", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "200": { "description": "Zestaw.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferVariantSet" }, "example": { "id": "2acf7981-8d96-48bb-8eb0-c6f4267e1eec", "name": "Podróż na Księżyc — wydania", "parameters": [ { "id": "color/pattern" } ], "offers": [ { "id": "900000000000021", "colorPattern": "DVD" }, { "id": "900000000000023", "colorPattern": "Blu-ray" } ], "allee": { "setId": 1, "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "color/pattern", "alleeId": 0, "name": "Kolor" } ], "offers": [ { "id": "900000000000021", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "DVD", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 8 }, "sellingMode": { "price": { "amount": "44.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-1" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021" }, { "id": "900000000000023", "values": [ { "parameterId": "color/pattern", "name": "Kolor", "value": "Blu-ray", "valueId": null } ], "publication": { "status": "ACTIVE" }, "stock": { "available": 10 }, "sellingMode": { "price": { "amount": "49.90", "currency": "PLN" } }, "external": { "id": "FILM-21ef85-WAR" }, "url": "https://allee.pl/oferta/podroz-na-ksiezyc-blu-ray-wydanie-kolekcjonerskie-900000000000023" } ], "createdAt": "2026-11-10T11:10:04.000Z", "updatedAt": "2026-11-10T11:10:04.000Z" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferVariantSet" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/offer-variants/{setId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteOfferVariantSet", "summary": "Rozłączenie zestawu wariantów", "tags": [ "Warianty ofert" ], "description": "Rozłącza zestaw: oferty zostają bez zmian (w sprzedaży, z tym samym stanem i ceną), znikają tylko z przełącznika i znów są osobnymi kartami w wynikach.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /sale/offer-variants/{setId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "setId", "in": "path", "required": true, "description": "Identyfikator zestawu (UUID — w PUT nadaje go integrator, zalecany v4).", "schema": { "type": "string", "format": "uuid" } } ], "responses": { "204": { "description": "Rozłączono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /sale/offer-variants/{setId}", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/sale/offer-variants/2acf7981-8d96-48bb-8eb0-c6f4267e1eec\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offers": { "get": { "operationId": "getOffers", "summary": "Lista ofert", "tags": [ "Oferty" ], "description": "Wszystkie oferty sprzedawcy (z API, panelu i integracji). Filtry jak w Allegro; parametry z wieloma wartościami możesz powtórzyć albo rozdzielić przecinkiem.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/offers.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–1000, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } }, { "name": "publication.status", "in": "query", "required": false, "description": "Status publikacji.", "schema": { "type": "array", "items": { "$ref": "#/components/schemas/PublicationStatus" } }, "style": "form", "explode": true }, { "name": "external.id", "in": "query", "required": false, "description": "SKU (do 1000).", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "offer.id", "in": "query", "required": false, "description": "Id ofert (do 1000).", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "name", "in": "query", "required": false, "description": "Fragment tytułu (bez wielkości liter).", "schema": { "type": "string", "maxLength": 100 } }, { "name": "category.id", "in": "query", "required": false, "description": "Kategoria Allegro.", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "category.alleeId", "in": "query", "required": false, "description": "Kategoria allee.", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "sellingMode.format", "in": "query", "required": false, "description": "Format.", "schema": { "type": "string", "enum": [ "BUY_NOW", "AUCTION" ] } }, { "name": "sellingMode.price.amount.gte", "in": "query", "required": false, "description": "Cena od.", "schema": { "type": "string" } }, { "name": "sellingMode.price.amount.lte", "in": "query", "required": false, "description": "Cena do.", "schema": { "type": "string" } }, { "name": "stock.available.gte", "in": "query", "required": false, "description": "Sztuk od.", "schema": { "type": "integer" } }, { "name": "stock.available.lte", "in": "query", "required": false, "description": "Sztuk do.", "schema": { "type": "integer" } }, { "name": "delivery.shippingRates.id", "in": "query", "required": false, "description": "Cennik dostawy.", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "sort", "in": "query", "required": false, "description": "Sortowanie („-” = malejąco); domyślnie po id.", "schema": { "type": "string", "enum": [ "sellingMode.price.amount", "-sellingMode.price.amount", "stock.available", "-stock.available", "stock.sold", "-stock.sold" ] } } ], "responses": { "200": { "description": "Oferty.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferList" }, "example": { "offers": [ { "id": "900000000000001", "name": "Produkt demo 01 – Projekty wnętrz", "category": { "id": "319697", "alleeId": 941 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/1f93e0d0ce5c0868cee3-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "19.99", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-01" } }, { "id": "900000000000002", "name": "Produkt demo 02 – Bulwy, cebulki, kłącza", "category": { "id": "12922", "alleeId": 1739 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/0108cb32c6569aad69db-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "29.90", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-02" } }, { "id": "900000000000003", "name": "Produkt demo 03 – Byliny ozdobne", "category": { "id": "99806", "alleeId": 1755 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/521d588b620db4503484-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "49.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-03" } }, { "id": "900000000000004", "name": "Produkt demo 04 – Drzewa i krzewy iglaste", "category": { "id": "99745", "alleeId": 2123 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/974af1fae322953c9a7e-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "79.99", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-04" } }, { "id": "900000000000005", "name": "Produkt demo 05 – Złote numery", "category": { "id": "310073", "alleeId": 1296 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/c57b491b20ba66fe8ff7-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "99.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-05" } }, { "id": "900000000000006", "name": "Produkt demo 06 – Etui i pokrowce", "category": { "id": "353", "alleeId": 2220 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/518b2c3652686f357b3b-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "129.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-06" } }, { "id": "900000000000007", "name": "Produkt demo 07 – Dresy kompletne", "category": { "id": "76039", "alleeId": 2103 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/29d58c570b4c85084c70-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "15.50", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-07" } }, { "id": "900000000000008", "name": "Produkt demo 08 – Dresy kompletne", "category": { "id": "87844", "alleeId": 2104 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/5b602fdfbcc60880f7b9-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "249.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-08" } }, { "id": "900000000000009", "name": "Produkt demo 09 – Wąsy i brody", "category": { "id": "319923", "alleeId": 11907 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/50e5775d08ce8523d94e-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "9.99", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-09" } }, { "id": "900000000000010", "name": "Produkt demo 10 – Gadżety kolekcjonerskie", "category": { "id": "321371", "alleeId": 368 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/87bc8e8f0fbb54acec68-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "59.90", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-10" } }, { "id": "900000000000011", "name": "Produkt demo 11 – Pozostałe", "category": { "id": "3965", "alleeId": 870 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/bd0da30f53525dad5442-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "19.99", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-11" } }, { "id": "900000000000012", "name": "Produkt demo 12 – Czapki", "category": { "id": "147285", "alleeId": 1862 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/0115415d6cc0f875b5a7-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "29.90", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-12" } }, { "id": "900000000000013", "name": "Produkt demo 13 – Kominiarki", "category": { "id": "256732", "alleeId": 2893 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/3bc43bd59c59f2908ace-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "49.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-13" } }, { "id": "900000000000014", "name": "Produkt demo 14 – Kosmetyczki i kuferki", "category": { "id": "122609", "alleeId": 8850 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/fca267ed0a086a975639-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "79.99", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-14" } }, { "id": "900000000000015", "name": "Produkt demo 15 – Nożyki i nożyczki", "category": { "id": "317733", "alleeId": 9547 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/7aa1def088c8cfb0be44-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "99.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-15" } }, { "id": "900000000000016", "name": "Produkt demo 16 – Szablony i taśmy", "category": { "id": "317739", "alleeId": 11371 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/7da31d7ceaa6b38bd949-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "129.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-16" } }, { "id": "900000000000017", "name": "Produkt demo 17 – Dresy kompletne", "category": { "id": "89511", "alleeId": 318 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/f26f25ba36e605b02c63-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "15.50", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-17" } }, { "id": "900000000000018", "name": "Produkt demo 18 – Podziękowania", "category": { "id": "88357", "alleeId": 833 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/8ea12dba550bed3da128-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "249.00", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-18" } }, { "id": "900000000000019", "name": "Produkt demo 19 – Zdalnie sterowane", "category": { "id": "11841", "alleeId": 1273 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/ca954c7263ea7bf5123c-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "9.99", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-19" } }, { "id": "900000000000020", "name": "Produkt demo 20 – Kostiumy", "category": { "id": "88319", "alleeId": 3031 }, "primaryImage": { "url": "https://cdn.allee.pl/img/u/980000001/d3caf839cae33e4da1a1-1200.webp" }, "sellingMode": { "format": "BUY_NOW", "price": { "amount": "59.90", "currency": "PLN" } }, "stock": { "available": 25, "sold": 0 }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "DEMO-20" } } ], "count": 20, "totalCount": 21 } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/offers", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offers?publication.status=ACTIVE&limit=20&offset=0\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offers (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offers?publication.status=ACTIVE&limit=20&offset=0\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offers (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offers?publication.status=ACTIVE&limit=20&offset=0`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offers (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offers?publication.status=ACTIVE&limit=20&offset=0\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offers (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offers?publication.status=ACTIVE&limit=20&offset=0\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offers (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offers?publication.status=ACTIVE&limit=20&offset=0\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offers/unfilled-parameters": { "get": { "operationId": "getOffersUnfilledParameters", "summary": "Oferty z brakującymi parametrami", "tags": [ "Oferty" ], "description": "Oferty, w których brakuje parametrów kategorii (wymaganych albo zalecanych) — uzupełnij je PATCH-em, by poprawić widoczność.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/offers/unfilled-parameters.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Ile pozycji pominąć.", "schema": { "type": "integer", "description": "Przesunięcie.", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "Ile pozycji zwrócić (1–1000, domyślnie 100).", "schema": { "type": "integer", "minimum": 1, "maximum": 1000, "default": 100 } }, { "name": "offer.id", "in": "query", "required": false, "description": "Tylko te oferty.", "schema": { "type": "array", "items": { "type": "string" } }, "style": "form", "explode": true }, { "name": "parameterType", "in": "query", "required": false, "description": "Rodzaj parametrów.", "schema": { "type": "string", "enum": [ "REQUIRED", "NON_REQUIRED" ] } } ], "responses": { "200": { "description": "Oferty i brakujące parametry.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/UnfilledParametersList" }, "example": { "offers": [ { "id": "900000000000001", "parameters": [ { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000002", "parameters": [ { "id": "447", "alleeId": 121, "name": "Cykl rozwojowy rośliny", "required": false }, { "id": "5187", "alleeId": 354, "name": "Czas sadzenia", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "212686", "alleeId": 3824, "name": "Styl", "required": false }, { "id": "247345", "alleeId": 9062, "name": "Cechy charakterystyczne", "required": false }, { "id": "25548", "alleeId": 1053, "name": "Roślina w postaci", "required": false }, { "id": "249248", "alleeId": 10304, "name": "Kraj", "required": false }, { "id": "249410", "alleeId": 10418, "name": "Nazwa łacińska", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "247632", "alleeId": 9132, "name": "Liczba sztuk w opakowaniu", "required": false }, { "id": "249511", "alleeId": 10488, "name": "Numer paszportu (sekcja C)", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000003", "parameters": [ { "id": "447", "alleeId": 121, "name": "Cykl rozwojowy rośliny", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "212686", "alleeId": 3824, "name": "Styl", "required": false }, { "id": "247345", "alleeId": 9062, "name": "Cechy charakterystyczne", "required": false }, { "id": "249248", "alleeId": 10304, "name": "Kraj", "required": false }, { "id": "249410", "alleeId": 10418, "name": "Nazwa łacińska", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "249511", "alleeId": 10488, "name": "Numer paszportu (sekcja C)", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false }, { "id": "11865", "alleeId": 699, "name": "Wysokość sadzonki", "required": false } ] }, { "id": "900000000000004", "parameters": [ { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "212686", "alleeId": 3824, "name": "Styl", "required": false }, { "id": "247345", "alleeId": 9062, "name": "Cechy charakterystyczne", "required": false }, { "id": "249248", "alleeId": 10304, "name": "Kraj", "required": false }, { "id": "249410", "alleeId": 10418, "name": "Nazwa łacińska", "required": false }, { "id": "248914", "alleeId": 10076, "name": "Producent", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "249511", "alleeId": 10488, "name": "Numer paszportu (sekcja C)", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false }, { "id": "212434", "alleeId": 3791, "name": "Wysokość sadzonki", "required": false } ] }, { "id": "900000000000005", "parameters": [ { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "218669", "alleeId": 4775, "name": "Certyfikaty zgodności", "required": false }, { "id": "247702", "alleeId": 9181, "name": "Kraj operatora", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "249959", "alleeId": 10837, "name": "Numer telefonu", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000006", "parameters": [ { "id": "207794", "alleeId": 2965, "name": "Rozszerzenie", "required": false }, { "id": "207802", "alleeId": 2967, "name": "Funkcje", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "207806", "alleeId": 2968, "name": "Załączone wyposażenie", "required": false }, { "id": "218669", "alleeId": 4775, "name": "Certyfikaty zgodności", "required": false }, { "id": "249517", "alleeId": 10494, "name": "Motyw przewodni", "required": false }, { "id": "249513", "alleeId": 10490, "name": "Odcień", "required": false }, { "id": "249518", "alleeId": 10495, "name": "Wzór dominujący", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "249372", "alleeId": 10390, "name": "Kolekcja", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000007", "parameters": [ { "id": "15851", "alleeId": 758, "name": "Płeć", "required": false }, { "id": "201077", "alleeId": 1852, "name": "Długość nogawki", "required": false }, { "id": "201081", "alleeId": 1853, "name": "Rodzaj spodni", "required": false }, { "id": "18293", "alleeId": 884, "name": "Rękaw", "required": false }, { "id": "201085", "alleeId": 1854, "name": "Cechy dodatkowe", "required": false }, { "id": "249516", "alleeId": 10493, "name": "Kolor dodatkowy", "required": false }, { "id": "3766", "alleeId": 277, "name": "Wzór dominujący", "required": false }, { "id": "249513", "alleeId": 10490, "name": "Odcień", "required": false }, { "id": "201093", "alleeId": 1856, "name": "Długość nogawki od kroku", "required": false }, { "id": "201097", "alleeId": 1857, "name": "Długość nogawki zewnętrzna", "required": false }, { "id": "201037", "alleeId": 1847, "name": "Długość rękawa", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "201029", "alleeId": 1845, "name": "Liczba kieszeni", "required": false }, { "id": "237206", "alleeId": 7936, "name": "Model", "required": false }, { "id": "215922", "alleeId": 4320, "name": "Nazwa koloru producenta", "required": false }, { "id": "215930", "alleeId": 4322, "name": "Skład materiałowy", "required": false }, { "id": "201049", "alleeId": 1850, "name": "Szerokość na dole produktu", "required": false }, { "id": "201041", "alleeId": 1848, "name": "Szerokość pod pachami", "required": false }, { "id": "201089", "alleeId": 1855, "name": "Szerokość w pasie", "required": false }, { "id": "201045", "alleeId": 1849, "name": "Szerokość w ramionach", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000008", "parameters": [ { "id": "15851", "alleeId": 758, "name": "Płeć", "required": false }, { "id": "201077", "alleeId": 1852, "name": "Długość nogawki", "required": false }, { "id": "201081", "alleeId": 1853, "name": "Rodzaj spodni", "required": false }, { "id": "18293", "alleeId": 884, "name": "Rękaw", "required": false }, { "id": "249516", "alleeId": 10493, "name": "Kolor dodatkowy", "required": false }, { "id": "3766", "alleeId": 277, "name": "Wzór dominujący", "required": false }, { "id": "249513", "alleeId": 10490, "name": "Odcień", "required": false }, { "id": "201093", "alleeId": 1856, "name": "Długość nogawki od kroku", "required": false }, { "id": "201097", "alleeId": 1857, "name": "Długość nogawki zewnętrzna", "required": false }, { "id": "201037", "alleeId": 1847, "name": "Długość rękawa", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "201029", "alleeId": 1845, "name": "Liczba kieszeni", "required": false }, { "id": "237206", "alleeId": 7936, "name": "Model", "required": false }, { "id": "215922", "alleeId": 4320, "name": "Nazwa koloru producenta", "required": false }, { "id": "215930", "alleeId": 4322, "name": "Skład materiałowy", "required": false }, { "id": "201049", "alleeId": 1850, "name": "Szerokość na dole produktu", "required": false }, { "id": "201041", "alleeId": 1848, "name": "Szerokość pod pachami", "required": false }, { "id": "201089", "alleeId": 1855, "name": "Szerokość w pasie", "required": false }, { "id": "201045", "alleeId": 1849, "name": "Szerokość w ramionach", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000009", "parameters": [ { "id": "15851", "alleeId": 758, "name": "Płeć", "required": false }, { "id": "249512", "alleeId": 10489, "name": "Kolor", "required": false }, { "id": "129612", "alleeId": 1555, "name": "Kolor włosów", "required": false }, { "id": "220837", "alleeId": 5151, "name": "Postać/temat", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "237206", "alleeId": 7936, "name": "Model", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000010", "parameters": [ { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "130411", "alleeId": 1738, "name": "Płeć", "required": false }, { "id": "18611", "alleeId": 912, "name": "Dyscyplina sportowa", "required": false }, { "id": "215758", "alleeId": 4286, "name": "Drużyna", "required": false }, { "id": "2977", "alleeId": 244, "name": "Długość", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "231157", "alleeId": 6878, "name": "Głębokość", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "247791", "alleeId": 9242, "name": "Szerokość", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000011", "parameters": [ { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "215758", "alleeId": 4286, "name": "Drużyna", "required": false }, { "id": "249839", "alleeId": 10750, "name": "Wydawca", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000012", "parameters": [ { "id": "223117", "alleeId": 5496, "name": "Cechy dodatkowe", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "249516", "alleeId": 10493, "name": "Kolor dodatkowy", "required": false }, { "id": "249513", "alleeId": 10490, "name": "Odcień", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "237210", "alleeId": 7937, "name": "Kolekcja", "required": false }, { "id": "215778", "alleeId": 4291, "name": "Obwód", "required": false }, { "id": "215930", "alleeId": 4322, "name": "Skład materiałowy", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000013", "parameters": [ { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "249516", "alleeId": 10493, "name": "Kolor dodatkowy", "required": false }, { "id": "249513", "alleeId": 10490, "name": "Odcień", "required": false }, { "id": "2977", "alleeId": 244, "name": "Długość", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "237210", "alleeId": 7937, "name": "Kolekcja", "required": false }, { "id": "215778", "alleeId": 4291, "name": "Obwód", "required": false }, { "id": "215930", "alleeId": 4322, "name": "Skład materiałowy", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000014", "parameters": [ { "id": "249946", "alleeId": 10824, "name": "Typ wyrobu medycznego", "required": false }, { "id": "249829", "alleeId": 10743, "name": "Wyrób medyczny", "required": false }, { "id": "249948", "alleeId": 10826, "name": "Klasa wyrobu medycznego", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "218669", "alleeId": 4775, "name": "Certyfikaty zgodności", "required": false }, { "id": "249512", "alleeId": 10489, "name": "Kolor", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "201321", "alleeId": 1897, "name": "Głębokość produktu", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "237214", "alleeId": 7938, "name": "Linia", "required": false }, { "id": "249949", "alleeId": 10827, "name": "Numer jednostki notyfikowanej", "required": false }, { "id": "249945", "alleeId": 10823, "name": "Producent wyrobu medycznego", "required": false }, { "id": "223333", "alleeId": 5528, "name": "Szerokość produktu", "required": false }, { "id": "249947", "alleeId": 10825, "name": "Upoważniony przedstawiciel", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false }, { "id": "203897", "alleeId": 2283, "name": "Wysokość", "required": false } ] }, { "id": "900000000000015", "parameters": [ { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "218669", "alleeId": 4775, "name": "Certyfikaty zgodności", "required": false }, { "id": "249512", "alleeId": 10489, "name": "Kolor", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000016", "parameters": [ { "id": "247906", "alleeId": 9316, "name": "Przeznaczenie", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "249512", "alleeId": 10489, "name": "Kolor", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000017", "parameters": [ { "id": "127789", "alleeId": 1171, "name": "Płeć", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "18151", "alleeId": 848, "name": "Certyfikaty, opinie, atesty", "required": false }, { "id": "202661", "alleeId": 2098, "name": "Zapięcie", "required": false }, { "id": "249516", "alleeId": 10493, "name": "Kolor dodatkowy", "required": false }, { "id": "202497", "alleeId": 2076, "name": "Wzór dominujący", "required": false }, { "id": "249513", "alleeId": 10490, "name": "Odcień", "required": false }, { "id": "127768", "alleeId": 1166, "name": "Bohater / Bajka", "required": false }, { "id": "202517", "alleeId": 2079, "name": "Długość całkowita", "required": false }, { "id": "203237", "alleeId": 2183, "name": "Długość nogawki od kroku", "required": false }, { "id": "203241", "alleeId": 2184, "name": "Długość nogawki zewnętrzna", "required": false }, { "id": "202525", "alleeId": 2081, "name": "Długość rękawa", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "217765", "alleeId": 4647, "name": "Skład surowcowy", "required": false }, { "id": "202521", "alleeId": 2080, "name": "Szerokość na dole produktu", "required": false }, { "id": "202513", "alleeId": 2078, "name": "Szerokość pod pachami", "required": false }, { "id": "202509", "alleeId": 2077, "name": "Szerokość w pasie", "required": false }, { "id": "203229", "alleeId": 2181, "name": "Szerokość w ramionach", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000018", "parameters": [ { "id": "238169", "alleeId": 8107, "name": "Przeznaczenie", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "247241", "alleeId": 9047, "name": "Okazje", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] }, { "id": "900000000000019", "parameters": [ { "id": "250685", "alleeId": 11436, "name": "Zawiera baterie", "required": false }, { "id": "127789", "alleeId": 1171, "name": "Płeć", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "201345", "alleeId": 1900, "name": "Efekty", "required": false }, { "id": "250061", "alleeId": 10911, "name": "Informacje dot. bezpieczeństwa i zgodności produktu", "required": false }, { "id": "18137", "alleeId": 844, "name": "Certyfikaty, opinie, atesty", "required": false }, { "id": "249512", "alleeId": 10489, "name": "Kolor", "required": false }, { "id": "201349", "alleeId": 1901, "name": "Skala", "required": false }, { "id": "127768", "alleeId": 1166, "name": "Bohater / Bajka", "required": false }, { "id": "215910", "alleeId": 4319, "name": "Baterie", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "201321", "alleeId": 1897, "name": "Głębokość produktu", "required": false }, { "id": "224017", "alleeId": 5647, "name": "Kod producenta", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "201357", "alleeId": 1903, "name": "Liczba kanałów sterowania", "required": false }, { "id": "201365", "alleeId": 1905, "name": "Prędkość maksymalna", "required": false }, { "id": "237222", "alleeId": 7940, "name": "Seria", "required": false }, { "id": "223333", "alleeId": 5528, "name": "Szerokość produktu", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false }, { "id": "223329", "alleeId": 5527, "name": "Wysokość produktu", "required": false }, { "id": "201353", "alleeId": 1902, "name": "Zakres częstotliwości", "required": false }, { "id": "201361", "alleeId": 1904, "name": "Zasięg pilota", "required": false } ] }, { "id": "900000000000020", "parameters": [ { "id": "298", "alleeId": 72, "name": "Płeć", "required": false }, { "id": "229205", "alleeId": 6525, "name": "Stan opakowania", "required": false }, { "id": "247241", "alleeId": 9047, "name": "Okazje", "required": false }, { "id": "249512", "alleeId": 10489, "name": "Kolor", "required": false }, { "id": "250491", "alleeId": 11293, "name": "Motyw", "required": false }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "required": false }, { "id": "250792", "alleeId": 11529, "name": "Kod taryfy celnej", "required": false }, { "id": "17448", "alleeId": 811, "name": "Waga produktu z opakowaniem jednostkowym", "required": false } ] } ], "count": 20, "totalCount": 21 } }, "application/json": { "schema": { "$ref": "#/components/schemas/UnfilledParametersList" } } } }, "400": { "description": "Zły parametr zapytania. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/offers/unfilled-parameters", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 400, "code": "VALIDATION_ERROR" }, { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offers/unfilled-parameters?limit=20\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offers/unfilled-parameters (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offers/unfilled-parameters?limit=20\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offers/unfilled-parameters (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offers/unfilled-parameters?limit=20`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offers/unfilled-parameters (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offers/unfilled-parameters?limit=20\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offers/unfilled-parameters (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offers/unfilled-parameters?limit=20\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offers/unfilled-parameters (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offers/unfilled-parameters?limit=20\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offers/{offerId}": { "delete": { "operationId": "deleteOffer", "summary": "Usunięcie szkicu oferty", "tags": [ "Oferty" ], "description": "Usuwa wyłącznie szkic, który nigdy nie był opublikowany. Ofertę opublikowaną kończysz poleceniem `END` → inaczej **409 `OFFER_NOT_DRAFT`**.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /sale/offers/{offerId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "offerId", "in": "path", "required": true, "description": "Identyfikator oferty (liczba w tekście).", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `OFFER_NOT_DRAFT`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /sale/offers/{offerId}", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "OFFER_NOT_DRAFT" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offers/900000000000022\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /sale/offers/900000000000022 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/sale/offers/900000000000022\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /sale/offers/900000000000022 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offers/900000000000022`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /sale/offers/900000000000022 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/sale/offers/900000000000022\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /sale/offers/900000000000022 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offers/900000000000022\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /sale/offers/900000000000022 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/sale/offers/900000000000022\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offers/{offerId}/buyability": { "get": { "operationId": "getOfferBuyability", "summary": "Czy oferta da się kupić", "tags": [ "Oferty" ], "description": "Problemy liczone z prawdziwego stanu oferty: nieaktywna, brak sztuk, brak GPSR, brak cennika.\n\n**Zgodność:** tylko allee — Rozszerzenie allee.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offerId", "in": "path", "required": true, "description": "Identyfikator oferty (liczba w tekście).", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } } ], "responses": { "200": { "description": "Wynik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/Buyability" }, "example": { "buyable": true, "problems": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/Buyability" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Rozszerzenie allee", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offers/900000000000021/buyability\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offers/900000000000021/buyability (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offers/900000000000021/buyability\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offers/900000000000021/buyability (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offers/900000000000021/buyability`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offers/900000000000021/buyability (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offers/900000000000021/buyability\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offers/900000000000021/buyability (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offers/900000000000021/buyability\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offers/900000000000021/buyability (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offers/900000000000021/buyability\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/offers/{offerId}/compliance": { "get": { "operationId": "getOfferCompliance", "summary": "Wymagania prawne oferty (GPSR, etykiety, skład)", "tags": [ "Zgodność sprzedawcy" ], "description": "Ocena oferty regułami kategorii (GPSR: producent, informacje o bezpieczeństwie, osoba w UE dla producenta spoza UE; klasa energetyczna; kod EPREL; skład wyrobu tekstylnego). Każdy problem ma regułę z wersją, podstawę prawną i ścieżkę pola.\n\n`publishingAllowed` mówi, czy ofertę można teraz opublikować lub wznowić (profil sprzedawcy + reguły z blokadą). Reguły blokujące działają od `blockingFrom` — wcześniej są ostrzeżeniami.\n\n**Zgodność:** tylko allee — Rozszerzenie allee (Z2).\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offerId", "in": "path", "required": true, "description": "Identyfikator oferty (liczba w tekście).", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } } ], "responses": { "200": { "description": "Ocena.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/OfferCompliance" }, "example": { "offerId": "900000000000021", "status": "COMPLIANT", "publishingAllowed": true, "publishingBlockedBy": null, "issues": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/OfferCompliance" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allee", "equivalent": "Rozszerzenie allee (Z2)", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/offers/900000000000021/compliance\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/offers/900000000000021/compliance (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/offers/900000000000021/compliance\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/offers/900000000000021/compliance (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/offers/900000000000021/compliance`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/offers/900000000000021/compliance (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/offers/900000000000021/compliance\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/offers/900000000000021/compliance (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/offers/900000000000021/compliance\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/offers/900000000000021/compliance (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/offers/900000000000021/compliance\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/product-offers": { "post": { "operationId": "createProductOffer", "summary": "Wystawienie oferty", "tags": [ "Oferty" ], "description": "Oferta w kształcie Allegro. Minimum: `productSet[0].product` (nazwa 10–75 znaków, kategoria-liść, wymagane parametry, ≥ 1 zdjęcie), cena, liczba sztuk, opis ≥ 20 znaków, `delivery.shippingRates.id`.\n\n- `publication.status: ACTIVE` publikuje od razu (wymaga GPSR: `responsibleProducer` + `safetyInformation`); brak = szkic `INACTIVE`.\n- Kategorię wskaż przez `id` (Allegro) albo `alleeId`; gdy podasz oba, wygrywa `alleeId`.\n- `external.id` = SKU, unikalne na koncie: drugi POST z tym samym SKU → **409 `OfferDuplicate`** z id istniejącej oferty w `details` (bezpieczne ponowienie).\n- Zdjęcia pobiera allee w tle; do czasu pobrania status `ACTIVATING`, `allee.imagesPending` > 0.\n- Walidacja zwraca **wszystkie** błędy naraz (422).\n- **allee:** `?validateOnly=true` sprawdza ofertę bez zapisu (200 `ValidationResult`); nagłówek `Idempotency-Key` chroni przed dublem po zerwanym połączeniu.\n\nZawsze **201** z pełnym obiektem (allee nie odpowiada 202).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST /sale/product-offers.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "validateOnly", "in": "query", "required": false, "description": "true = tylko walidacja, bez zapisu (rozszerzenie allee).", "schema": { "type": "boolean", "default": false } }, { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ProductOfferInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProductOfferInput" } } } }, "responses": { "200": { "description": "Wynik validateOnly=true (nic nie zapisano).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ValidationResult" }, "example": { "validateOnly": true, "status": "VALID", "issues": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ValidationResult" } } } }, "201": { "description": "Utworzono (pełny obiekt; adres oferty: GET /sale/product-offers/{id} z pola id).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ProductOffer" }, "example": { "id": "900000000000021", "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "category": { "id": "20585", "alleeId": 35 }, "productSet": [ { "product": { "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "246845", "alleeId": 8973, "name": "Nośnik", "valuesIds": [ "246845_622165" ], "alleeValuesIds": [ 79216 ], "values": [ "płyta DVD" ], "rangeValue": null }, { "id": "250077", "alleeId": 10923, "name": "Gatunek", "valuesIds": [ "250077_1797493" ], "alleeValuesIds": [ 258674 ], "values": [ "anime" ], "rangeValue": null }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "valuesIds": [], "values": [ "5901234123457" ], "rangeValue": null }, { "id": "237218", "alleeId": 7939, "name": "Tytuł", "valuesIds": [], "values": [ "Podróż na Księżyc" ], "rangeValue": null } ], "images": [ "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" ] }, "responsibleProducer": { "type": "ID", "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e" }, "responsiblePerson": null, "safetyInformation": { "type": "TEXT", "description": "Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła." } } ], "parameters": [ { "id": "11323", "alleeId": 669, "name": "Stan", "valuesIds": [ "11323_1" ], "alleeValuesIds": [ 6386 ], "values": [ "Nowy" ], "rangeValue": null } ], "sellingMode": { "format": "BUY_NOW", "price": { "amount": "49.90", "currency": "PLN" } }, "stock": { "available": 10, "unit": "UNIT" }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "FILM-21ef85-1" }, "delivery": { "handlingTime": "PT24H", "shippingRates": { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a" } }, "afterSalesServices": { "returnPolicy": { "id": "0d2fcf15-119d-479c-9d97-ba1794013def" }, "warranty": null, "impliedWarranty": { "id": "d82f8496-f284-4cdf-9575-242222870c5f" } }, "taxSettings": { "rates": [ { "rate": "23.00", "countryCode": "PL" } ] }, "payments": { "invoice": "VAT" }, "images": [ "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" ], "description": { "sections": [ { "items": [ { "type": "TEXT", "content": "

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

• Region 2
• Język: polski

" } ] } ] }, "location": { "city": "Warszawa", "countryCode": "PL", "postCode": "00-001", "province": "MAZOWIECKIE" }, "validation": { "errors": [], "warnings": [] }, "createdAt": "2026-11-10T11:10:03.000Z", "updatedAt": "2026-11-10T11:10:03.000Z", "allee": { "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021", "endedReason": null, "imagesPending": 0, "categorySource": "allegro" } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProductOffer" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `OfferDuplicate`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `ATTACHMENTS_NOT_SUPPORTED`, `CATALOG_PRODUCT_NOT_SUPPORTED`, `CATEGORY_NOT_FOUND`, `CATEGORY_NOT_LEAF`, `ConstraintViolationException.MissingRequiredParameters`, `ConstraintViolationException.RangeValueNotSupported`, `ConstraintViolationException.TooManyValues`, `DictionaryParameterValueNotFound`, `IMAGE_DOWNLOAD_FAILED`, `INVALID_QUANTITY`, `JsonMappingException`, `ParameterCategoryException`, `RESPONSIBLE_PRODUCER_NOT_SPECIFIED`, `SAFETY_INFO_NOT_DEFINED`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST /sale/product-offers", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 409, "code": "OfferDuplicate" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "ATTACHMENTS_NOT_SUPPORTED" }, { "status": 422, "code": "CATALOG_PRODUCT_NOT_SUPPORTED" }, { "status": 422, "code": "CATEGORY_NOT_FOUND" }, { "status": 422, "code": "CATEGORY_NOT_LEAF" }, { "status": 422, "code": "ConstraintViolationException.MissingRequiredParameters" }, { "status": 422, "code": "ConstraintViolationException.RangeValueNotSupported" }, { "status": 422, "code": "ConstraintViolationException.TooManyValues" }, { "status": 422, "code": "DictionaryParameterValueNotFound" }, { "status": 422, "code": "IMAGE_DOWNLOAD_FAILED" }, { "status": 422, "code": "INVALID_QUANTITY" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "ParameterCategoryException" }, { "status": 422, "code": "RESPONSIBLE_PRODUCER_NOT_SPECIFIED" }, { "status": 422, "code": "SAFETY_INFO_NOT_DEFINED" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/product-offers\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Idempotency-Key: oferta-FILM-21ef85-1\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"productSet\": [\n {\n \"product\": {\n \"name\": \"Podróż na Księżyc DVD wydanie kolekcjonerskie\",\n \"category\": {\n \"id\": \"20585\"\n },\n \"parameters\": [\n {\n \"id\": \"225693\",\n \"values\": [\n \"5901234123457\"\n ]\n },\n {\n \"id\": \"237218\",\n \"values\": [\n \"Podróż na Księżyc\"\n ]\n },\n {\n \"id\": \"246845\",\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n {\n \"id\": \"250077\",\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n }\n ],\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ]\n },\n \"responsibleProducer\": {\n \"type\": \"ID\",\n \"id\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\"\n },\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.\"\n }\n }\n ],\n \"parameters\": [\n {\n \"id\": \"11323\",\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n ],\n \"sellingMode\": {\n \"format\": \"BUY_NOW\",\n \"price\": {\n \"amount\": \"49.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 10,\n \"unit\": \"UNIT\"\n },\n \"external\": {\n \"id\": \"FILM-21ef85-1\"\n },\n \"description\": {\n \"sections\": [\n {\n \"items\": [\n {\n \"type\": \"TEXT\",\n \"content\": \"

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
\"\n }\n ]\n }\n ]\n },\n \"delivery\": {\n \"handlingTime\": \"PT24H\",\n \"shippingRates\": {\n \"id\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\"\n }\n },\n \"afterSalesServices\": {\n \"returnPolicy\": {\n \"id\": \"0d2fcf15-119d-479c-9d97-ba1794013def\"\n },\n \"impliedWarranty\": {\n \"id\": \"d82f8496-f284-4cdf-9575-242222870c5f\"\n }\n },\n \"taxSettings\": {\n \"rates\": [\n {\n \"rate\": \"23.00\",\n \"countryCode\": \"PL\"\n }\n ]\n },\n \"payments\": {\n \"invoice\": \"VAT\"\n },\n \"location\": {\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n \"postCode\": \"00-001\",\n \"province\": \"MAZOWIECKIE\"\n },\n \"publication\": {\n \"status\": \"ACTIVE\"\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n [\n 'product' => [\n 'name' => 'Podróż na Księżyc DVD wydanie kolekcjonerskie',\n 'category' => [\n 'id' => '20585',\n ],\n 'parameters' => [\n [\n 'id' => '225693',\n 'values' => [\n '5901234123457',\n ],\n ],\n [\n 'id' => '237218',\n 'values' => [\n 'Podróż na Księżyc',\n ],\n ],\n [\n 'id' => '246845',\n 'valuesIds' => [\n '246845_622165',\n ],\n ],\n [\n 'id' => '250077',\n 'valuesIds' => [\n '250077_1797493',\n ],\n ],\n ],\n 'images' => [\n 'https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp',\n ],\n ],\n 'responsibleProducer' => [\n 'type' => 'ID',\n 'id' => '472bad66-e704-4344-a2d6-9bd85b1f9a5e',\n ],\n 'safetyInformation' => [\n 'type' => 'TEXT',\n 'description' => 'Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.',\n ],\n ],\n ],\n 'parameters' => [\n [\n 'id' => '11323',\n 'valuesIds' => [\n '11323_1',\n ],\n ],\n ],\n 'sellingMode' => [\n 'format' => 'BUY_NOW',\n 'price' => [\n 'amount' => '49.90',\n 'currency' => 'PLN',\n ],\n ],\n 'stock' => [\n 'available' => 10,\n 'unit' => 'UNIT',\n ],\n 'external' => [\n 'id' => 'FILM-21ef85-1',\n ],\n 'description' => [\n 'sections' => [\n [\n 'items' => [\n [\n 'type' => 'TEXT',\n 'content' => '

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
',\n ],\n ],\n ],\n ],\n ],\n 'delivery' => [\n 'handlingTime' => 'PT24H',\n 'shippingRates' => [\n 'id' => '797d2e65-cb23-4a16-98e9-d6f2a399839a',\n ],\n ],\n 'afterSalesServices' => [\n 'returnPolicy' => [\n 'id' => '0d2fcf15-119d-479c-9d97-ba1794013def',\n ],\n 'impliedWarranty' => [\n 'id' => 'd82f8496-f284-4cdf-9575-242222870c5f',\n ],\n ],\n 'taxSettings' => [\n 'rates' => [\n [\n 'rate' => '23.00',\n 'countryCode' => 'PL',\n ],\n ],\n ],\n 'payments' => [\n 'invoice' => 'VAT',\n ],\n 'location' => [\n 'city' => 'Warszawa',\n 'countryCode' => 'PL',\n 'postCode' => '00-001',\n 'province' => 'MAZOWIECKIE',\n ],\n 'publication' => [\n 'status' => 'ACTIVE',\n ],\n];\n$ch = curl_init($base . '/sale/product-offers');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Idempotency-Key: oferta-FILM-21ef85-1',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/product-offers (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Idempotency-Key\": \"oferta-FILM-21ef85-1\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"productSet\": [\n {\n \"product\": {\n \"name\": \"Podróż na Księżyc DVD wydanie kolekcjonerskie\",\n \"category\": {\n \"id\": \"20585\",\n },\n \"parameters\": [\n {\n \"id\": \"225693\",\n \"values\": [\n \"5901234123457\",\n ],\n },\n {\n \"id\": \"237218\",\n \"values\": [\n \"Podróż na Księżyc\",\n ],\n },\n {\n \"id\": \"246845\",\n \"valuesIds\": [\n \"246845_622165\",\n ],\n },\n {\n \"id\": \"250077\",\n \"valuesIds\": [\n \"250077_1797493\",\n ],\n },\n ],\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\",\n ],\n },\n \"responsibleProducer\": {\n \"type\": \"ID\",\n \"id\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\",\n },\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.\",\n },\n },\n ],\n \"parameters\": [\n {\n \"id\": \"11323\",\n \"valuesIds\": [\n \"11323_1\",\n ],\n },\n ],\n \"sellingMode\": {\n \"format\": \"BUY_NOW\",\n \"price\": {\n \"amount\": \"49.90\",\n \"currency\": \"PLN\",\n },\n },\n \"stock\": {\n \"available\": 10,\n \"unit\": \"UNIT\",\n },\n \"external\": {\n \"id\": \"FILM-21ef85-1\",\n },\n \"description\": {\n \"sections\": [\n {\n \"items\": [\n {\n \"type\": \"TEXT\",\n \"content\": \"

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
\",\n },\n ],\n },\n ],\n },\n \"delivery\": {\n \"handlingTime\": \"PT24H\",\n \"shippingRates\": {\n \"id\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\",\n },\n },\n \"afterSalesServices\": {\n \"returnPolicy\": {\n \"id\": \"0d2fcf15-119d-479c-9d97-ba1794013def\",\n },\n \"impliedWarranty\": {\n \"id\": \"d82f8496-f284-4cdf-9575-242222870c5f\",\n },\n },\n \"taxSettings\": {\n \"rates\": [\n {\n \"rate\": \"23.00\",\n \"countryCode\": \"PL\",\n },\n ],\n },\n \"payments\": {\n \"invoice\": \"VAT\",\n },\n \"location\": {\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n \"postCode\": \"00-001\",\n \"province\": \"MAZOWIECKIE\",\n },\n \"publication\": {\n \"status\": \"ACTIVE\",\n },\n}\nr = requests.request(\"POST\", BASE + \"/sale/product-offers\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/product-offers (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"productSet\": [\n {\n \"product\": {\n \"name\": \"Podróż na Księżyc DVD wydanie kolekcjonerskie\",\n \"category\": {\n \"id\": \"20585\"\n },\n \"parameters\": [\n {\n \"id\": \"225693\",\n \"values\": [\n \"5901234123457\"\n ]\n },\n {\n \"id\": \"237218\",\n \"values\": [\n \"Podróż na Księżyc\"\n ]\n },\n {\n \"id\": \"246845\",\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n {\n \"id\": \"250077\",\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n }\n ],\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ]\n },\n \"responsibleProducer\": {\n \"type\": \"ID\",\n \"id\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\"\n },\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.\"\n }\n }\n ],\n \"parameters\": [\n {\n \"id\": \"11323\",\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n ],\n \"sellingMode\": {\n \"format\": \"BUY_NOW\",\n \"price\": {\n \"amount\": \"49.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 10,\n \"unit\": \"UNIT\"\n },\n \"external\": {\n \"id\": \"FILM-21ef85-1\"\n },\n \"description\": {\n \"sections\": [\n {\n \"items\": [\n {\n \"type\": \"TEXT\",\n \"content\": \"

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
\"\n }\n ]\n }\n ]\n },\n \"delivery\": {\n \"handlingTime\": \"PT24H\",\n \"shippingRates\": {\n \"id\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\"\n }\n },\n \"afterSalesServices\": {\n \"returnPolicy\": {\n \"id\": \"0d2fcf15-119d-479c-9d97-ba1794013def\"\n },\n \"impliedWarranty\": {\n \"id\": \"d82f8496-f284-4cdf-9575-242222870c5f\"\n }\n },\n \"taxSettings\": {\n \"rates\": [\n {\n \"rate\": \"23.00\",\n \"countryCode\": \"PL\"\n }\n ]\n },\n \"payments\": {\n \"invoice\": \"VAT\"\n },\n \"location\": {\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n \"postCode\": \"00-001\",\n \"province\": \"MAZOWIECKIE\"\n },\n \"publication\": {\n \"status\": \"ACTIVE\"\n }\n};\nconst res = await fetch(`${BASE}/sale/product-offers`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Idempotency-Key\": \"oferta-FILM-21ef85-1\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/product-offers (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/product-offers\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nreq.Headers.Add(\"Idempotency-Key\", \"oferta-FILM-21ef85-1\");\nvar json = \"\"\"\n{\n \"productSet\": [\n {\n \"product\": {\n \"name\": \"Podróż na Księżyc DVD wydanie kolekcjonerskie\",\n \"category\": {\n \"id\": \"20585\"\n },\n \"parameters\": [\n {\n \"id\": \"225693\",\n \"values\": [\n \"5901234123457\"\n ]\n },\n {\n \"id\": \"237218\",\n \"values\": [\n \"Podróż na Księżyc\"\n ]\n },\n {\n \"id\": \"246845\",\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n {\n \"id\": \"250077\",\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n }\n ],\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ]\n },\n \"responsibleProducer\": {\n \"type\": \"ID\",\n \"id\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\"\n },\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.\"\n }\n }\n ],\n \"parameters\": [\n {\n \"id\": \"11323\",\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n ],\n \"sellingMode\": {\n \"format\": \"BUY_NOW\",\n \"price\": {\n \"amount\": \"49.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 10,\n \"unit\": \"UNIT\"\n },\n \"external\": {\n \"id\": \"FILM-21ef85-1\"\n },\n \"description\": {\n \"sections\": [\n {\n \"items\": [\n {\n \"type\": \"TEXT\",\n \"content\": \"

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
\"\n }\n ]\n }\n ]\n },\n \"delivery\": {\n \"handlingTime\": \"PT24H\",\n \"shippingRates\": {\n \"id\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\"\n }\n },\n \"afterSalesServices\": {\n \"returnPolicy\": {\n \"id\": \"0d2fcf15-119d-479c-9d97-ba1794013def\"\n },\n \"impliedWarranty\": {\n \"id\": \"d82f8496-f284-4cdf-9575-242222870c5f\"\n }\n },\n \"taxSettings\": {\n \"rates\": [\n {\n \"rate\": \"23.00\",\n \"countryCode\": \"PL\"\n }\n ]\n },\n \"payments\": {\n \"invoice\": \"VAT\"\n },\n \"location\": {\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n \"postCode\": \"00-001\",\n \"province\": \"MAZOWIECKIE\"\n },\n \"publication\": {\n \"status\": \"ACTIVE\"\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/product-offers (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"productSet\": [\n {\n \"product\": {\n \"name\": \"Podróż na Księżyc DVD wydanie kolekcjonerskie\",\n \"category\": {\n \"id\": \"20585\"\n },\n \"parameters\": [\n {\n \"id\": \"225693\",\n \"values\": [\n \"5901234123457\"\n ]\n },\n {\n \"id\": \"237218\",\n \"values\": [\n \"Podróż na Księżyc\"\n ]\n },\n {\n \"id\": \"246845\",\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n {\n \"id\": \"250077\",\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n }\n ],\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ]\n },\n \"responsibleProducer\": {\n \"type\": \"ID\",\n \"id\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\"\n },\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.\"\n }\n }\n ],\n \"parameters\": [\n {\n \"id\": \"11323\",\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n ],\n \"sellingMode\": {\n \"format\": \"BUY_NOW\",\n \"price\": {\n \"amount\": \"49.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 10,\n \"unit\": \"UNIT\"\n },\n \"external\": {\n \"id\": \"FILM-21ef85-1\"\n },\n \"description\": {\n \"sections\": [\n {\n \"items\": [\n {\n \"type\": \"TEXT\",\n \"content\": \"

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
\"\n }\n ]\n }\n ]\n },\n \"delivery\": {\n \"handlingTime\": \"PT24H\",\n \"shippingRates\": {\n \"id\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\"\n }\n },\n \"afterSalesServices\": {\n \"returnPolicy\": {\n \"id\": \"0d2fcf15-119d-479c-9d97-ba1794013def\"\n },\n \"impliedWarranty\": {\n \"id\": \"d82f8496-f284-4cdf-9575-242222870c5f\"\n }\n },\n \"taxSettings\": {\n \"rates\": [\n {\n \"rate\": \"23.00\",\n \"countryCode\": \"PL\"\n }\n ]\n },\n \"payments\": {\n \"invoice\": \"VAT\"\n },\n \"location\": {\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n \"postCode\": \"00-001\",\n \"province\": \"MAZOWIECKIE\"\n },\n \"publication\": {\n \"status\": \"ACTIVE\"\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/product-offers\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Idempotency-Key\", \"oferta-FILM-21ef85-1\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/product-offers (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"productSet\": [\n {\n \"product\": {\n \"name\": \"Podróż na Księżyc DVD wydanie kolekcjonerskie\",\n \"category\": {\n \"id\": \"20585\"\n },\n \"parameters\": [\n {\n \"id\": \"225693\",\n \"values\": [\n \"5901234123457\"\n ]\n },\n {\n \"id\": \"237218\",\n \"values\": [\n \"Podróż na Księżyc\"\n ]\n },\n {\n \"id\": \"246845\",\n \"valuesIds\": [\n \"246845_622165\"\n ]\n },\n {\n \"id\": \"250077\",\n \"valuesIds\": [\n \"250077_1797493\"\n ]\n }\n ],\n \"images\": [\n \"https://cdn.allee.pl/img/a/webe/1930/10001318-0-1200.webp\"\n ]\n },\n \"responsibleProducer\": {\n \"type\": \"ID\",\n \"id\": \"472bad66-e704-4344-a2d6-9bd85b1f9a5e\"\n },\n \"safetyInformation\": {\n \"type\": \"TEXT\",\n \"description\": \"Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła.\"\n }\n }\n ],\n \"parameters\": [\n {\n \"id\": \"11323\",\n \"valuesIds\": [\n \"11323_1\"\n ]\n }\n ],\n \"sellingMode\": {\n \"format\": \"BUY_NOW\",\n \"price\": {\n \"amount\": \"49.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 10,\n \"unit\": \"UNIT\"\n },\n \"external\": {\n \"id\": \"FILM-21ef85-1\"\n },\n \"description\": {\n \"sections\": [\n {\n \"items\": [\n {\n \"type\": \"TEXT\",\n \"content\": \"

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

  • Region 2
  • Język: polski
\"\n }\n ]\n }\n ]\n },\n \"delivery\": {\n \"handlingTime\": \"PT24H\",\n \"shippingRates\": {\n \"id\": \"797d2e65-cb23-4a16-98e9-d6f2a399839a\"\n }\n },\n \"afterSalesServices\": {\n \"returnPolicy\": {\n \"id\": \"0d2fcf15-119d-479c-9d97-ba1794013def\"\n },\n \"impliedWarranty\": {\n \"id\": \"d82f8496-f284-4cdf-9575-242222870c5f\"\n }\n },\n \"taxSettings\": {\n \"rates\": [\n {\n \"rate\": \"23.00\",\n \"countryCode\": \"PL\"\n }\n ]\n },\n \"payments\": {\n \"invoice\": \"VAT\"\n },\n \"location\": {\n \"city\": \"Warszawa\",\n \"countryCode\": \"PL\",\n \"postCode\": \"00-001\",\n \"province\": \"MAZOWIECKIE\"\n },\n \"publication\": {\n \"status\": \"ACTIVE\"\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/product-offers\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Idempotency-Key\", \"oferta-FILM-21ef85-1\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/product-offers/{offerId}": { "get": { "operationId": "getProductOffer", "summary": "Oferta", "tags": [ "Oferty" ], "description": "Pełna oferta. `validation.errors` = prawdziwe problemy (np. nieudane zdjęcia). Cudza → 403, brak → 404.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — GET /sale/product-offers/{offerId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offerId", "in": "path", "required": true, "description": "Identyfikator oferty (liczba w tekście).", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } } ], "responses": { "200": { "description": "Oferta.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ProductOffer" }, "example": { "id": "900000000000021", "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "category": { "id": "20585", "alleeId": 35 }, "productSet": [ { "product": { "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "246845", "alleeId": 8973, "name": "Nośnik", "valuesIds": [ "246845_622165" ], "alleeValuesIds": [ 79216 ], "values": [ "płyta DVD" ], "rangeValue": null }, { "id": "250077", "alleeId": 10923, "name": "Gatunek", "valuesIds": [ "250077_1797493" ], "alleeValuesIds": [ 258674 ], "values": [ "anime" ], "rangeValue": null }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "valuesIds": [], "values": [ "5901234123457" ], "rangeValue": null }, { "id": "237218", "alleeId": 7939, "name": "Tytuł", "valuesIds": [], "values": [ "Podróż na Księżyc" ], "rangeValue": null } ], "images": [ "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" ] }, "responsibleProducer": { "type": "ID", "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e" }, "responsiblePerson": null, "safetyInformation": { "type": "TEXT", "description": "Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła." } } ], "parameters": [ { "id": "11323", "alleeId": 669, "name": "Stan", "valuesIds": [ "11323_1" ], "alleeValuesIds": [ 6386 ], "values": [ "Nowy" ], "rangeValue": null } ], "sellingMode": { "format": "BUY_NOW", "price": { "amount": "49.90", "currency": "PLN" } }, "stock": { "available": 10, "unit": "UNIT" }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "FILM-21ef85-1" }, "delivery": { "handlingTime": "PT24H", "shippingRates": { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a" } }, "afterSalesServices": { "returnPolicy": { "id": "0d2fcf15-119d-479c-9d97-ba1794013def" }, "warranty": null, "impliedWarranty": { "id": "d82f8496-f284-4cdf-9575-242222870c5f" } }, "taxSettings": { "rates": [ { "rate": "23.00", "countryCode": "PL" } ] }, "payments": { "invoice": "VAT" }, "images": [ "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" ], "description": { "sections": [ { "items": [ { "type": "TEXT", "content": "

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

• Region 2
• Język: polski

" } ] } ] }, "location": { "city": "Warszawa", "countryCode": "PL", "postCode": "00-001", "province": "MAZOWIECKIE" }, "validation": { "errors": [], "warnings": [] }, "createdAt": "2026-11-10T11:10:03.000Z", "updatedAt": "2026-11-10T11:10:03.000Z", "allee": { "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021", "endedReason": null, "imagesPending": 0 } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProductOffer" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: GET /sale/product-offers/{offerId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/product-offers/900000000000021\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/product-offers/900000000000021 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/product-offers/900000000000021\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/product-offers/900000000000021 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/product-offers/900000000000021`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/product-offers/900000000000021 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/product-offers/900000000000021\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/product-offers/900000000000021 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/product-offers/900000000000021\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/product-offers/900000000000021 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/product-offers/900000000000021\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "patch": { "operationId": "updateProductOffer", "summary": "Zmiana oferty", "tags": [ "Oferty" ], "description": "Zmieniasz tylko podane pola; odpowiedź 200 z pełną ofertą.\n\n- **Szybka ścieżka:** ciało tylko ze `stock` i/lub `sellingMode.price` — bez pełnej walidacji treści (masowe aktualizacje).\n- Parametry są **scalane** (podane zastępują te same parametry, reszta zostaje).\n- Status publikacji zmieniasz poleceniem `PUT /sale/offer-publication-commands/{id}` (pole `publication` → 422).\n- `stock.available = 0` na aktywnej ofercie kończy ją (`ENDED`, `endedBy: EMPTY_STOCK`).\n- `?validateOnly=true` — podgląd bez zapisu.\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — PATCH /sale/product-offers/{offerId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "offerId", "in": "path", "required": true, "description": "Identyfikator oferty (liczba w tekście).", "schema": { "type": "string", "pattern": "^[0-9]{1,19}$" } }, { "name": "validateOnly", "in": "query", "required": false, "description": "true = tylko walidacja.", "schema": { "type": "boolean", "default": false } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ProductOfferInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProductOfferInput" } } } }, "responses": { "200": { "description": "Zmieniono (albo wynik validateOnly).", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ProductOffer" }, { "$ref": "#/components/schemas/ValidationResult" } ] }, "example": { "id": "900000000000021", "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "category": { "id": "20585", "alleeId": 35 }, "productSet": [ { "product": { "name": "Podróż na Księżyc DVD wydanie kolekcjonerskie", "category": { "id": "20585", "alleeId": 35 }, "parameters": [ { "id": "246845", "alleeId": 8973, "name": "Nośnik", "valuesIds": [ "246845_622165" ], "alleeValuesIds": [ 79216 ], "values": [ "płyta DVD" ], "rangeValue": null }, { "id": "250077", "alleeId": 10923, "name": "Gatunek", "valuesIds": [ "250077_1797493" ], "alleeValuesIds": [ 258674 ], "values": [ "anime" ], "rangeValue": null }, { "id": "225693", "alleeId": 5967, "name": "EAN (GTIN)", "valuesIds": [], "values": [ "5901234123457" ], "rangeValue": null }, { "id": "237218", "alleeId": 7939, "name": "Tytuł", "valuesIds": [], "values": [ "Podróż na Księżyc" ], "rangeValue": null } ], "images": [ "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" ] }, "responsibleProducer": { "type": "ID", "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e" }, "responsiblePerson": null, "safetyInformation": { "type": "TEXT", "description": "Produkt bezpieczny w normalnym użytkowaniu. Przechowywać z dala od źródeł ciepła." } } ], "parameters": [ { "id": "11323", "alleeId": 669, "name": "Stan", "valuesIds": [ "11323_1" ], "alleeValuesIds": [ 6386 ], "values": [ "Nowy" ], "rangeValue": null } ], "sellingMode": { "format": "BUY_NOW", "price": { "amount": "44.90", "currency": "PLN" } }, "stock": { "available": 8, "unit": "UNIT" }, "publication": { "status": "ACTIVE", "endedBy": null }, "external": { "id": "FILM-21ef85-1" }, "delivery": { "handlingTime": "PT24H", "shippingRates": { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a" } }, "afterSalesServices": { "returnPolicy": { "id": "0d2fcf15-119d-479c-9d97-ba1794013def" }, "warranty": null, "impliedWarranty": { "id": "d82f8496-f284-4cdf-9575-242222870c5f" } }, "taxSettings": { "rates": [ { "rate": "23.00", "countryCode": "PL" } ] }, "payments": { "invoice": "VAT" }, "images": [ "https://cdn.allee.pl/img/sandbox/9a16623650ab051ba0d7-1200.webp" ], "description": { "sections": [ { "items": [ { "type": "TEXT", "content": "

Opis

Film na płycie DVD, wydanie kolekcjonerskie, nowy w folii.

• Region 2
• Język: polski

" } ] } ] }, "location": { "city": "Warszawa", "countryCode": "PL", "postCode": "00-001", "province": "MAZOWIECKIE" }, "validation": { "errors": [], "warnings": [] }, "createdAt": "2026-11-10T11:10:03.000Z", "updatedAt": "2026-11-10T11:10:03.000Z", "allee": { "url": "https://allee.pl/oferta/podroz-na-ksiezyc-dvd-wydanie-kolekcjonerskie-900000000000021", "endedReason": null, "imagesPending": 0 } } }, "application/json": { "schema": { "oneOf": [ { "$ref": "#/components/schemas/ProductOffer" }, { "$ref": "#/components/schemas/ValidationResult" } ] } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`, `OFFER_ENDED_BY_ADMIN`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `OfferDuplicate`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `ATTACHMENTS_NOT_SUPPORTED`, `CATALOG_PRODUCT_NOT_SUPPORTED`, `CATEGORY_NOT_FOUND`, `CATEGORY_NOT_LEAF`, `ConstraintViolationException.MissingRequiredParameters`, `ConstraintViolationException.RangeValueNotSupported`, `ConstraintViolationException.TooManyValues`, `DictionaryParameterValueNotFound`, `IMAGE_DOWNLOAD_FAILED`, `INVALID_QUANTITY`, `JsonMappingException`, `ParameterCategoryException`, `RESPONSIBLE_PRODUCER_NOT_SPECIFIED`, `SAFETY_INFO_NOT_DEFINED`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: PATCH /sale/product-offers/{offerId}", "limitGroup": "write", "scope": "allegro:api:sale:offers:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 403, "code": "OFFER_ENDED_BY_ADMIN" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "OfferDuplicate" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "ATTACHMENTS_NOT_SUPPORTED" }, { "status": 422, "code": "CATALOG_PRODUCT_NOT_SUPPORTED" }, { "status": 422, "code": "CATEGORY_NOT_FOUND" }, { "status": 422, "code": "CATEGORY_NOT_LEAF" }, { "status": 422, "code": "ConstraintViolationException.MissingRequiredParameters" }, { "status": 422, "code": "ConstraintViolationException.RangeValueNotSupported" }, { "status": 422, "code": "ConstraintViolationException.TooManyValues" }, { "status": 422, "code": "DictionaryParameterValueNotFound" }, { "status": 422, "code": "IMAGE_DOWNLOAD_FAILED" }, { "status": 422, "code": "INVALID_QUANTITY" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "ParameterCategoryException" }, { "status": 422, "code": "RESPONSIBLE_PRODUCER_NOT_SPECIFIED" }, { "status": 422, "code": "SAFETY_INFO_NOT_DEFINED" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PATCH \"${ALLEE_API_URL:-https://api.allee.pl}/sale/product-offers/900000000000021\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"44.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 8\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " [\n 'price' => [\n 'amount' => '44.90',\n 'currency' => 'PLN',\n ],\n ],\n 'stock' => [\n 'available' => 8,\n ],\n];\n$ch = curl_init($base . '/sale/product-offers/900000000000021');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PATCH',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PATCH /sale/product-offers/900000000000021 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"44.90\",\n \"currency\": \"PLN\",\n },\n },\n \"stock\": {\n \"available\": 8,\n },\n}\nr = requests.request(\"PATCH\", BASE + \"/sale/product-offers/900000000000021\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PATCH /sale/product-offers/900000000000021 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"44.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 8\n }\n};\nconst res = await fetch(`${BASE}/sale/product-offers/900000000000021`, {\n method: \"PATCH\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PATCH /sale/product-offers/900000000000021 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PATCH\"), baseUrl + \"/sale/product-offers/900000000000021\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"44.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 8\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PATCH /sale/product-offers/900000000000021 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"44.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 8\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/product-offers/900000000000021\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PATCH\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PATCH /sale/product-offers/900000000000021 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"sellingMode\": {\n \"price\": {\n \"amount\": \"44.90\",\n \"currency\": \"PLN\"\n }\n },\n \"stock\": {\n \"available\": 8\n }\n}`\n\treq, err := http.NewRequest(\"PATCH\", base+\"/sale/product-offers/900000000000021\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/products": { "get": { "operationId": "getProducts", "summary": "Wyszukiwanie produktów w katalogu", "tags": [ "Produkty" ], "description": "allee nie prowadzi katalogu produktów — odpowiedź to zawsze `{\"products\": []}`. Wystawiaj oferty z pełnymi danymi produktu (nazwa, kategoria, parametry, zdjęcia).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/products.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "phrase", "in": "query", "required": false, "description": "Fraza (bez skutku).", "schema": { "type": "string" } }, { "name": "ean", "in": "query", "required": false, "description": "EAN (bez skutku).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Pusta lista.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ProductList" }, "example": { "products": [] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ProductList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/products", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/products?phrase=film%20dvd\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/products (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/products?phrase=film%20dvd\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/products (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/products?phrase=film%20dvd`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/products (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/products?phrase=film%20dvd\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/products (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/products?phrase=film%20dvd\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/products (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/products?phrase=film%20dvd\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/products/{productId}": { "get": { "operationId": "getProduct", "summary": "Karta produktu", "tags": [ "Produkty" ], "description": "Zawsze **404** — allee nie ma kart produktów.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/products/{productId}.\n**Uprawnienie:** zakres `allegro:api:sale:offers:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "productId", "in": "path", "required": true, "description": "Identyfikator produktu Allegro.", "schema": { "type": "string" } } ], "responses": { "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Brak katalogu. Kody błędów: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" }, "example": { "errors": [ { "code": "NOT_FOUND", "message": "allee nie prowadzi katalogu produktów — wystaw ofertę z własnymi danymi produktu (productSet[0].product.name, category, parameters, images).", "details": null, "path": "id", "userMessage": "allee nie prowadzi katalogu produktów — wystaw ofertę z własnymi danymi produktu (productSet[0].product.name, category, parameters, images)." } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:offers:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/products/{productId}", "limitGroup": "read", "scope": "allegro:api:sale:offers:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/products/c9a40d2e-2b57-4f7b-a2b4-3b2c4d5e6f70\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/responsible-persons": { "get": { "operationId": "getResponsiblePersons", "summary": "Osoba odpowiedzialna — lista", "tags": [ "GPSR" ], "description": "Twoje wpisy osób odpowiedzialnych, posortowane po nazwie. Bez parametrów — wszystkie naraz; `offset`/`limit` jak w Allegro (S2, 10.11): `count` = wpisy w odpowiedzi, `totalCount` = wszystkie.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/responsible-persons.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Pominięte wpisy od początku listy.", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "1–1000; brak = wszystkie.", "schema": { "type": "integer", "minimum": 1, "maximum": 1000 } } ], "responses": { "200": { "description": "Lista.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsiblePersonList" }, "example": { "responsiblePersons": [ { "id": "6a29e43e-96c9-4bd6-b999-82c3413fdfa1", "name": "Importer UE", "personalData": { "name": "Import Filmów Sp. z o.o.", "address": { "countryCode": "PL", "street": "Portowa 3", "postalCode": "80-001", "city": "Gdańsk" }, "contact": { "email": "kontakt@import.example.com" } } }, { "id": "30c5cc4a-ff63-4507-8c9c-e9410008b8f0", "name": "Osoba odpowiedzialna demo", "personalData": { "name": "Importer Demo", "address": { "street": "ul. Przykładowa 1", "postalCode": "00-001", "city": "Warszawa", "countryCode": "PL" }, "contact": { "email": "gpsr@example.invalid", "formUrl": "https://example.invalid/kontakt" } } } ], "count": 2, "totalCount": 2 } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsiblePersonList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/responsible-persons", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-persons\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/responsible-persons (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/responsible-persons\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/responsible-persons (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/responsible-persons`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/responsible-persons (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/responsible-persons\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/responsible-persons (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-persons\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/responsible-persons (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/responsible-persons\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createResponsiblePerson", "summary": "Osoba odpowiedzialna — nowy wpis", "tags": [ "GPSR" ], "description": "`name` 1–50 znaków (unikalna), `personalData` z białej listy pól Allegro (nazwa, adres, kontakt — wartości sprawdzane, inne pola pomijane). Najwyżej 1000 wpisów. Dubel nazwy → 422 `PRODUCER_NAME_HAS_TO_BE_UNIQUE` (`details` = id istniejącego wpisu — użyj go).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /sale/responsible-persons.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsiblePersonInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsiblePersonInput" } } } }, "responses": { "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsiblePerson" }, "example": { "id": "6a29e43e-96c9-4bd6-b999-82c3413fdfa1", "name": "Importer UE", "personalData": { "name": "Import Filmów Sp. z o.o.", "address": { "countryCode": "PL", "street": "Portowa 3", "postalCode": "80-001", "city": "Gdańsk" }, "contact": { "email": "kontakt@import.example.com" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsiblePerson" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `LIMIT_EXCEEDED`, `PRODUCER_NAME_HAS_TO_BE_UNIQUE`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /sale/responsible-persons", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LIMIT_EXCEEDED" }, { "status": 422, "code": "PRODUCER_NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-persons\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 3\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Importer UE',\n 'personalData' => [\n 'name' => 'Import Filmów Sp. z o.o.',\n 'address' => [\n 'countryCode' => 'PL',\n 'street' => 'Portowa 3',\n 'postalCode' => '80-001',\n 'city' => 'Gdańsk',\n ],\n 'contact' => [\n 'email' => 'kontakt@import.example.com',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/responsible-persons');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/responsible-persons (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 3\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\",\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\",\n },\n },\n}\nr = requests.request(\"POST\", BASE + \"/sale/responsible-persons\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/responsible-persons (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 3\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n};\nconst res = await fetch(`${BASE}/sale/responsible-persons`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/responsible-persons (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/responsible-persons\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 3\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/responsible-persons (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 3\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-persons\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/responsible-persons (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 3\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/responsible-persons\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/responsible-persons/{responsiblePersonId}": { "get": { "operationId": "getResponsiblePerson", "summary": "Osoba odpowiedzialna", "tags": [ "GPSR" ], "description": "Pełny wpis. Cudzy → 403, brak → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/responsible-persons/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "responsiblePersonId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wpis.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsiblePerson" }, "example": { "id": "6a29e43e-96c9-4bd6-b999-82c3413fdfa1", "name": "Importer UE", "personalData": { "name": "Import Filmów Sp. z o.o.", "address": { "countryCode": "PL", "street": "Portowa 3", "postalCode": "80-001", "city": "Gdańsk" }, "contact": { "email": "kontakt@import.example.com" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsiblePerson" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/responsible-persons/{id}", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateResponsiblePerson", "summary": "Osoba odpowiedzialna — zmiana", "tags": [ "GPSR" ], "description": "Pełna podmiana wpisu (nieznane pole → 422); karty ofert wskazujących ten wpis pokazują nowe dane w sekcji „Bezpieczeństwo produktu”.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /sale/responsible-persons/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "responsiblePersonId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsiblePersonInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsiblePersonInput" } } } }, "responses": { "200": { "description": "Zmieniono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsiblePerson" }, "example": { "id": "6a29e43e-96c9-4bd6-b999-82c3413fdfa1", "name": "Importer UE", "personalData": { "name": "Import Filmów Sp. z o.o.", "address": { "countryCode": "PL", "street": "Portowa 4", "postalCode": "80-001", "city": "Gdańsk" }, "contact": { "email": "kontakt@import.example.com" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsiblePerson" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `PRODUCER_NAME_HAS_TO_BE_UNIQUE`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /sale/responsible-persons/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "PRODUCER_NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 4\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Importer UE',\n 'personalData' => [\n 'name' => 'Import Filmów Sp. z o.o.',\n 'address' => [\n 'countryCode' => 'PL',\n 'street' => 'Portowa 4',\n 'postalCode' => '80-001',\n 'city' => 'Gdańsk',\n ],\n 'contact' => [\n 'email' => 'kontakt@import.example.com',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 4\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\",\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\",\n },\n },\n}\nr = requests.request(\"PUT\", BASE + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 4\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n};\nconst res = await fetch(`${BASE}/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 4\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 4\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Importer UE\",\n \"personalData\": {\n \"name\": \"Import Filmów Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Portowa 4\",\n \"postalCode\": \"80-001\",\n \"city\": \"Gdańsk\"\n },\n \"contact\": {\n \"email\": \"kontakt@import.example.com\"\n }\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteResponsiblePerson", "summary": "Osoba odpowiedzialna — usunięcie", "tags": [ "GPSR" ], "description": "Usuwa wpis. Wskazany w ofercie → **409 `IN_USE`**.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /sale/responsible-persons/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "responsiblePersonId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `IN_USE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /sale/responsible-persons/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "IN_USE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/sale/responsible-persons/6a29e43e-96c9-4bd6-b999-82c3413fdfa1\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/responsible-producers": { "get": { "operationId": "getResponsibleProducers", "summary": "Producent odpowiedzialny — lista", "tags": [ "GPSR" ], "description": "Twoje wpisy producentów, posortowane po nazwie. Bez parametrów — wszystkie naraz; `offset`/`limit` jak w Allegro (S2, 10.11): `count` = wpisy w odpowiedzi, `totalCount` = wszystkie.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/responsible-producers.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "offset", "in": "query", "required": false, "description": "Pominięte wpisy od początku listy.", "schema": { "type": "integer", "minimum": 0, "default": 0 } }, { "name": "limit", "in": "query", "required": false, "description": "1–1000; brak = wszystkie.", "schema": { "type": "integer", "minimum": 1, "maximum": 1000 } } ], "responses": { "200": { "description": "Lista.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducerList" }, "example": { "responsibleProducers": [ { "id": "e157086a-a704-46a9-8922-770c82c9a7d6", "name": "Producent demo", "producerData": { "tradeName": "Fabryka Demo", "address": { "street": "ul. Przykładowa 1", "postalCode": "00-001", "city": "Warszawa", "countryCode": "PL" }, "contact": { "email": "gpsr@example.invalid", "formUrl": "https://example.invalid/kontakt" } } }, { "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e", "name": "Wytwórnia Filmowa", "producerData": { "tradeName": "Wytwórnia Filmowa Sp. z o.o.", "address": { "countryCode": "PL", "street": "Filmowa 5", "postalCode": "00-950", "city": "Warszawa" }, "contact": { "email": "gpsr@wytwornia.example.com", "phoneNumber": "+48 22 100 00 00" } } } ], "count": 2, "totalCount": 2 } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducerList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/responsible-producers", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-producers\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/responsible-producers (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/responsible-producers\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/responsible-producers (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/responsible-producers`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/responsible-producers (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/responsible-producers\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/responsible-producers (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-producers\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/responsible-producers (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/responsible-producers\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createResponsibleProducer", "summary": "Producent odpowiedzialny — nowy wpis", "tags": [ "GPSR" ], "description": "`name` 1–50 znaków (unikalna), `producerData` z białej listy pól Allegro (nazwa, adres, kontakt — wartości sprawdzane, inne pola pomijane). Wymagane `producerData.tradeName`. Najwyżej 1000 wpisów. Dubel nazwy → 422 `PRODUCER_NAME_HAS_TO_BE_UNIQUE` (`details` = id istniejącego wpisu — użyj go).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — POST /sale/responsible-producers.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducerInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducerInput" } } } }, "responses": { "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducer" }, "example": { "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e", "name": "Wytwórnia Filmowa", "producerData": { "tradeName": "Wytwórnia Filmowa Sp. z o.o.", "address": { "countryCode": "PL", "street": "Filmowa 5", "postalCode": "00-950", "city": "Warszawa" }, "contact": { "email": "gpsr@wytwornia.example.com", "phoneNumber": "+48 22 100 00 00" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducer" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `LIMIT_EXCEEDED`, `PRODUCER_NAME_HAS_TO_BE_UNIQUE`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: POST /sale/responsible-producers", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LIMIT_EXCEEDED" }, { "status": 422, "code": "PRODUCER_NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-producers\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 5\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Wytwórnia Filmowa',\n 'producerData' => [\n 'tradeName' => 'Wytwórnia Filmowa Sp. z o.o.',\n 'address' => [\n 'countryCode' => 'PL',\n 'street' => 'Filmowa 5',\n 'postalCode' => '00-950',\n 'city' => 'Warszawa',\n ],\n 'contact' => [\n 'email' => 'gpsr@wytwornia.example.com',\n 'phoneNumber' => '+48 22 100 00 00',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/responsible-producers');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/responsible-producers (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 5\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\",\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\",\n },\n },\n}\nr = requests.request(\"POST\", BASE + \"/sale/responsible-producers\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/responsible-producers (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 5\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n};\nconst res = await fetch(`${BASE}/sale/responsible-producers`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/responsible-producers (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/responsible-producers\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 5\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/responsible-producers (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 5\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-producers\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/responsible-producers (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 5\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/responsible-producers\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/responsible-producers/{responsibleProducerId}": { "get": { "operationId": "getResponsibleProducer", "summary": "Producent odpowiedzialny", "tags": [ "GPSR" ], "description": "Pełny wpis. Cudzy → 403, brak → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/responsible-producers/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "responsibleProducerId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Wpis.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducer" }, "example": { "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e", "name": "Wytwórnia Filmowa", "producerData": { "tradeName": "Wytwórnia Filmowa Sp. z o.o.", "address": { "countryCode": "PL", "street": "Filmowa 5", "postalCode": "00-950", "city": "Warszawa" }, "contact": { "email": "gpsr@wytwornia.example.com", "phoneNumber": "+48 22 100 00 00" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducer" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/responsible-producers/{id}", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateResponsibleProducer", "summary": "Producent odpowiedzialny — zmiana", "tags": [ "GPSR" ], "description": "Pełna podmiana wpisu (nieznane pole → 422); karty ofert wskazujących ten wpis pokazują nowe dane w sekcji „Bezpieczeństwo produktu”.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /sale/responsible-producers/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "responsibleProducerId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducerInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducerInput" } } } }, "responses": { "200": { "description": "Zmieniono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducer" }, "example": { "id": "472bad66-e704-4344-a2d6-9bd85b1f9a5e", "name": "Wytwórnia Filmowa", "producerData": { "tradeName": "Wytwórnia Filmowa Sp. z o.o.", "address": { "countryCode": "PL", "street": "Filmowa 7", "postalCode": "00-950", "city": "Warszawa" }, "contact": { "email": "gpsr@wytwornia.example.com", "phoneNumber": "+48 22 100 00 00" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ResponsibleProducer" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`, `PRODUCER_NAME_HAS_TO_BE_UNIQUE`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /sale/responsible-producers/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "PRODUCER_NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 7\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Wytwórnia Filmowa',\n 'producerData' => [\n 'tradeName' => 'Wytwórnia Filmowa Sp. z o.o.',\n 'address' => [\n 'countryCode' => 'PL',\n 'street' => 'Filmowa 7',\n 'postalCode' => '00-950',\n 'city' => 'Warszawa',\n ],\n 'contact' => [\n 'email' => 'gpsr@wytwornia.example.com',\n 'phoneNumber' => '+48 22 100 00 00',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 7\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\",\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\",\n },\n },\n}\nr = requests.request(\"PUT\", BASE + \"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 7\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n};\nconst res = await fetch(`${BASE}/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 7\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 7\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Wytwórnia Filmowa\",\n \"producerData\": {\n \"tradeName\": \"Wytwórnia Filmowa Sp. z o.o.\",\n \"address\": {\n \"countryCode\": \"PL\",\n \"street\": \"Filmowa 7\",\n \"postalCode\": \"00-950\",\n \"city\": \"Warszawa\"\n },\n \"contact\": {\n \"email\": \"gpsr@wytwornia.example.com\",\n \"phoneNumber\": \"+48 22 100 00 00\"\n }\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/responsible-producers/472bad66-e704-4344-a2d6-9bd85b1f9a5e\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "delete": { "operationId": "deleteResponsibleProducer", "summary": "Producent odpowiedzialny — usunięcie", "tags": [ "GPSR" ], "description": "Usuwa wpis. Wskazany w ofercie → **409 `IN_USE`**.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — DELETE /sale/responsible-producers/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "responsibleProducerId", "in": "path", "required": true, "description": "Identyfikator (UUID).", "schema": { "type": "string" } } ], "responses": { "204": { "description": "Usunięto.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "409": { "description": "Konflikt ze stanem zasobu. Kody: `IN_USE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: DELETE /sale/responsible-producers/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 409, "code": "IN_USE" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X DELETE \"${ALLEE_API_URL:-https://api.allee.pl}/sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'DELETE',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: DELETE /sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73 (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"DELETE\", BASE + \"/sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: DELETE /sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73 (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73`, {\n method: \"DELETE\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: DELETE /sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73 (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"DELETE\"), baseUrl + \"/sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: DELETE /sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73 (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"DELETE\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: DELETE /sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73 (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"DELETE\", base+\"/sale/responsible-producers/779d5493-2252-4fa5-b0f1-04968b912e73\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/shipping-rates": { "get": { "operationId": "getShippingRates", "summary": "Cenniki dostawy sprzedawcy", "tags": [ "Dostawa" ], "description": "Twoje cenniki (id i nazwa), posortowane po nazwie.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/shipping-rates.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "responses": { "200": { "description": "Cenniki.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRatesList" }, "example": { "shippingRates": [ { "id": "154985df-0580-4e6e-91a3-7b23608beb41", "name": "Cennik demo" }, { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a", "name": "Paczkomat i kurier pobraniowy" } ] } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRatesList" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/shipping-rates", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/shipping-rates\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/shipping-rates (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/shipping-rates\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/shipping-rates (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/shipping-rates`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/shipping-rates (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/shipping-rates\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/shipping-rates (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/shipping-rates\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/shipping-rates (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/shipping-rates\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "post": { "operationId": "createShippingRates", "summary": "Nowy cennik dostawy", "tags": [ "Dostawa" ], "description": "**201** — nowy cennik. **200** — masz już cennik o tej `name`: oddajemy istniejący, jego treść się nie zmienia (bezpieczne ponowienie; wzorzec „nazwa = odcisk kosztów”).\n\nW `rates[].deliveryMethod` zamiast `id` możesz podać dokładną `name` metody. Wszystkie błędy zwracamy naraz (np. `EMPTY_TYPE` i `DELIVERY_METHOD_NOT_FOUND` z `path` na pozycję).\n\nRozszerzenie allee (opcjonalne): `allee.freeDeliveryFrom` — próg darmowej dostawy (kwota PLN; `null` = bez progu). Ten sam cennik edytuje sprzedawca w panelu (Ustawienia › Wysyłka).\n\n**Zgodność:** zgodna z Allegro REST API, z rozszerzeniami allee (pola `allee.*`, `alleeId`) — POST /sale/shipping-rates.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "$ref": "#/components/parameters/IdempotencyKey" } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRatesInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRatesInput" } } } }, "responses": { "200": { "description": "Cennik o tej nazwie już był — bez zmian.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRates" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRates" } } } }, "201": { "description": "Utworzono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRates" }, "example": { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a", "name": "Paczkomat i kurier pobraniowy", "type": "PHYSICAL", "rates": [ { "deliveryMethod": { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f" }, "maxQuantityPerPackage": 5, "firstItemRate": { "amount": "13.99", "currency": "PLN" }, "nextItemRate": { "amount": "0.00", "currency": "PLN" } }, { "deliveryMethod": { "id": "5c76d200-c6db-46a7-9b78-7d067e8cfb2d" }, "maxQuantityPerPackage": 5, "firstItemRate": { "amount": "17.99", "currency": "PLN" }, "nextItemRate": { "amount": "2.00", "currency": "PLN" } } ], "lastModified": "2026-11-10T11:10:03.639Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRates" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `DELIVERY_METHOD_NOT_FOUND`, `EMPTY_TYPE`, `JsonMappingException`, `LIMIT_EXCEEDED`, `UnknownJSONProperty`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro+", "equivalent": "Allegro: POST /sale/shipping-rates", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "DELIVERY_METHOD_NOT_FOUND" }, { "status": 422, "code": "EMPTY_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "LIMIT_EXCEEDED" }, { "status": 422, "code": "UnknownJSONProperty" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/sale/shipping-rates\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"13.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"17.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ]\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Paczkomat i kurier pobraniowy',\n 'type' => 'PHYSICAL',\n 'rates' => [\n [\n 'deliveryMethod' => [\n 'id' => 'bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f',\n ],\n 'maxQuantityPerPackage' => 5,\n 'firstItemRate' => [\n 'amount' => '13.99',\n 'currency' => 'PLN',\n ],\n 'nextItemRate' => [\n 'amount' => '0.00',\n 'currency' => 'PLN',\n ],\n ],\n [\n 'deliveryMethod' => [\n 'id' => '5c76d200-c6db-46a7-9b78-7d067e8cfb2d',\n ],\n 'maxQuantityPerPackage' => 5,\n 'firstItemRate' => [\n 'amount' => '17.99',\n 'currency' => 'PLN',\n ],\n 'nextItemRate' => [\n 'amount' => '2.00',\n 'currency' => 'PLN',\n ],\n ],\n ],\n];\n$ch = curl_init($base . '/sale/shipping-rates');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'POST',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /sale/shipping-rates (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\",\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"13.99\",\n \"currency\": \"PLN\",\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\",\n },\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\",\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"17.99\",\n \"currency\": \"PLN\",\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\",\n },\n },\n ],\n}\nr = requests.request(\"POST\", BASE + \"/sale/shipping-rates\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /sale/shipping-rates (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"13.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"17.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ]\n};\nconst res = await fetch(`${BASE}/sale/shipping-rates`, {\n method: \"POST\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /sale/shipping-rates (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/sale/shipping-rates\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"13.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"17.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ]\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /sale/shipping-rates (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"13.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"17.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ]\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/shipping-rates\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /sale/shipping-rates (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"13.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"17.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ]\n}`\n\treq, err := http.NewRequest(\"POST\", base+\"/sale/shipping-rates\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/sale/shipping-rates/{shippingRatesId}": { "get": { "operationId": "getShippingRate", "summary": "Cennik dostawy", "tags": [ "Dostawa" ], "description": "Pełny cennik. Cudzy → 403, brak → 404.\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — GET /sale/shipping-rates/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:read`.\n**Grupa limitu:** `read`.", "parameters": [ { "name": "shippingRatesId", "in": "path", "required": true, "description": "Identyfikator cennika (UUID).", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Cennik.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRates" }, "example": { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a", "name": "Paczkomat i kurier pobraniowy", "type": "PHYSICAL", "rates": [ { "deliveryMethod": { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f" }, "maxQuantityPerPackage": 5, "firstItemRate": { "amount": "13.99", "currency": "PLN" }, "nextItemRate": { "amount": "0.00", "currency": "PLN" } }, { "deliveryMethod": { "id": "5c76d200-c6db-46a7-9b78-7d067e8cfb2d" }, "maxQuantityPerPackage": 5, "firstItemRate": { "amount": "17.99", "currency": "PLN" }, "nextItemRate": { "amount": "2.00", "currency": "PLN" } } ], "lastModified": "2026-11-10T11:10:03.639Z" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRates" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:read" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: GET /sale/shipping-rates/{id}", "limitGroup": "read", "scope": "allegro:api:sale:settings:read", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X GET \"${ALLEE_API_URL:-https://api.allee.pl}/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'GET',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: GET /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n}\nr = requests.request(\"GET\", BASE + \"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\", headers=headers, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: GET /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst res = await fetch(`${BASE}/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a`, {\n method: \"GET\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n },\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: GET /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"GET\"), baseUrl + \"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: GET /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .method(\"GET\", HttpRequest.BodyPublishers.noBody())\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: GET /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\treq, err := http.NewRequest(\"GET\", base+\"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\", nil)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] }, "put": { "operationId": "updateShippingRate", "summary": "Zmiana cennika dostawy", "tags": [ "Dostawa" ], "description": "Pełna podmiana `name` i `rates`. Oferty z tym cennikiem dostają nową „dostawę od” (najtańsze `firstItemRate`). Nazwa zajęta przez inny Twój cennik → 422. `allee.freeDeliveryFrom` zmieniamy tylko, gdy go podasz (pominięty = bez zmian).\n\n**Zgodność:** zgodna z Allegro REST API (ten sam kształt) — PUT /sale/shipping-rates/{id}.\n**Uprawnienie:** zakres `allegro:api:sale:settings:write`.\n**Grupa limitu:** `write`.", "parameters": [ { "name": "shippingRatesId", "in": "path", "required": true, "description": "Identyfikator cennika (UUID).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRatesInput" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRatesInput" } } } }, "responses": { "200": { "description": "Zmieniono.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ShippingRates" }, "example": { "id": "797d2e65-cb23-4a16-98e9-d6f2a399839a", "name": "Paczkomat i kurier pobraniowy", "type": "PHYSICAL", "rates": [ { "deliveryMethod": { "id": "bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f" }, "maxQuantityPerPackage": 5, "firstItemRate": { "amount": "12.99", "currency": "PLN" }, "nextItemRate": { "amount": "0.00", "currency": "PLN" } }, { "deliveryMethod": { "id": "5c76d200-c6db-46a7-9b78-7d067e8cfb2d" }, "maxQuantityPerPackage": 5, "firstItemRate": { "amount": "16.99", "currency": "PLN" }, "nextItemRate": { "amount": "2.00", "currency": "PLN" } } ], "lastModified": "2026-11-10T11:10:03.648Z", "allee": { "freeDeliveryFrom": { "amount": "200.00", "currency": "PLN" } } } }, "application/json": { "schema": { "$ref": "#/components/schemas/ShippingRates" } } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `invalid_token`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "WWW-Authenticate": { "$ref": "#/components/headers/WWW-Authenticate" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OAuthError" } } } }, "403": { "description": "Brak uprawnień. Kody: `ACCOUNT_INACTIVE`, `AccessDenied`, `KEY_QUARANTINED`, `KEY_SUSPENDED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "404": { "description": "Nie ma takiego zasobu. Kody: `NOT_FOUND`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "406": { "description": "Nieobsługiwany nagłówek Accept. Kody: `NOT_ACCEPTABLE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "415": { "description": "Zły Content-Type. Kody: `UNSUPPORTED_MEDIA_TYPE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `DELIVERY_METHOD_NOT_FOUND`, `EMPTY_TYPE`, `JsonMappingException`, `NAME_HAS_TO_BE_UNIQUE`, `VALIDATION_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "429": { "description": "Przekroczony limit — ponów po Retry-After. Kody: `TOO_MANY_REQUESTS`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "X-Allee-RateLimit": { "$ref": "#/components/headers/X-Allee-RateLimit" }, "X-Allee-Mode": { "$ref": "#/components/headers/X-Allee-Mode" } }, "content": { "application/vnd.allegro.public.v1+json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } }, "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [ { "bearerAuth": [] }, { "oauth2": [ "allegro:api:sale:settings:write" ] } ], "x-allee": { "compatibility": "allegro", "equivalent": "Allegro: PUT /sale/shipping-rates/{id}", "limitGroup": "write", "scope": "allegro:api:sale:settings:write", "appTokenAllowed": false, "errors": [ { "status": 401, "code": "invalid_token" }, { "status": 403, "code": "ACCOUNT_INACTIVE" }, { "status": 403, "code": "AccessDenied" }, { "status": 403, "code": "KEY_QUARANTINED" }, { "status": 403, "code": "KEY_SUSPENDED" }, { "status": 404, "code": "NOT_FOUND" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 415, "code": "UNSUPPORTED_MEDIA_TYPE" }, { "status": 422, "code": "DELIVERY_METHOD_NOT_FOUND" }, { "status": 422, "code": "EMPTY_TYPE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 422, "code": "NAME_HAS_TO_BE_UNIQUE" }, { "status": 422, "code": "VALIDATION_ERROR" }, { "status": 429, "code": "TOO_MANY_REQUESTS" }, { "status": 500, "code": "INTERNAL_ERROR" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X PUT \"${ALLEE_API_URL:-https://api.allee.pl}/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\" \\\n -H \"Authorization: Bearer $ALLEE_API_KEY\" \\\n -H \"Accept: application/vnd.allegro.public.v1+json\" \\\n -H \"Content-Type: application/vnd.allegro.public.v1+json\" \\\n --data-binary @- \\\n -w '\\nHTTP %{http_code}\\n' <<'JSON'\n{\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"12.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"16.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ],\n \"allee\": {\n \"freeDeliveryFrom\": {\n \"amount\": \"200.00\",\n \"currency\": \"PLN\"\n }\n }\n}\nJSON\n" }, { "lang": "PHP", "label": "PHP", "source": " 'Paczkomat i kurier pobraniowy',\n 'type' => 'PHYSICAL',\n 'rates' => [\n [\n 'deliveryMethod' => [\n 'id' => 'bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f',\n ],\n 'maxQuantityPerPackage' => 5,\n 'firstItemRate' => [\n 'amount' => '12.99',\n 'currency' => 'PLN',\n ],\n 'nextItemRate' => [\n 'amount' => '0.00',\n 'currency' => 'PLN',\n ],\n ],\n [\n 'deliveryMethod' => [\n 'id' => '5c76d200-c6db-46a7-9b78-7d067e8cfb2d',\n ],\n 'maxQuantityPerPackage' => 5,\n 'firstItemRate' => [\n 'amount' => '16.99',\n 'currency' => 'PLN',\n ],\n 'nextItemRate' => [\n 'amount' => '2.00',\n 'currency' => 'PLN',\n ],\n ],\n ],\n 'allee' => [\n 'freeDeliveryFrom' => [\n 'amount' => '200.00',\n 'currency' => 'PLN',\n ],\n ],\n];\n$ch = curl_init($base . '/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a');\ncurl_setopt_array($ch, [\n CURLOPT_CUSTOMREQUEST => 'PUT',\n CURLOPT_HTTPHEADER => [\n 'Authorization: Bearer ' . getenv('ALLEE_API_KEY'),\n 'Accept: application/vnd.allegro.public.v1+json',\n 'Content-Type: application/vnd.allegro.public.v1+json',\n ],\n CURLOPT_POSTFIELDS => json_encode($body, JSON_UNESCAPED_UNICODE | JSON_UNESCAPED_SLASHES),\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: PUT /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Authorization\": \"Bearer \" + os.environ[\"ALLEE_API_KEY\"],\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n}\nbody = {\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\",\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"12.99\",\n \"currency\": \"PLN\",\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\",\n },\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\",\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"16.99\",\n \"currency\": \"PLN\",\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\",\n },\n },\n ],\n \"allee\": {\n \"freeDeliveryFrom\": {\n \"amount\": \"200.00\",\n \"currency\": \"PLN\",\n },\n },\n}\nr = requests.request(\"PUT\", BASE + \"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\", headers=headers, json=body, timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: PUT /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = {\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"12.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"16.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ],\n \"allee\": {\n \"freeDeliveryFrom\": {\n \"amount\": \"200.00\",\n \"currency\": \"PLN\"\n }\n }\n};\nconst res = await fetch(`${BASE}/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a`, {\n method: \"PUT\",\n headers: {\n Authorization: `Bearer ${process.env.ALLEE_API_KEY}`,\n \"Accept\": \"application/vnd.allegro.public.v1+json\",\n \"Content-Type\": \"application/vnd.allegro.public.v1+json\",\n },\n body: JSON.stringify(body),\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: PUT /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"PUT\"), baseUrl + \"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\");\nreq.Headers.Authorization = new AuthenticationHeaderValue(\"Bearer\", Environment.GetEnvironmentVariable(\"ALLEE_API_KEY\"));\nreq.Headers.Accept.ParseAdd(\"application/vnd.allegro.public.v1+json\");\nvar json = \"\"\"\n{\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"12.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"16.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ],\n \"allee\": {\n \"freeDeliveryFrom\": {\n \"amount\": \"200.00\",\n \"currency\": \"PLN\"\n }\n }\n}\n\"\"\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/vnd.allegro.public.v1+json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: PUT /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"\"\"\n {\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"12.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"16.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ],\n \"allee\": {\n \"freeDeliveryFrom\": {\n \"amount\": \"200.00\",\n \"currency\": \"PLN\"\n }\n }\n }\n \"\"\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\"))\n .header(\"Authorization\", \"Bearer \" + System.getenv(\"ALLEE_API_KEY\"))\n .header(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n .header(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n .method(\"PUT\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: PUT /sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `{\n \"name\": \"Paczkomat i kurier pobraniowy\",\n \"type\": \"PHYSICAL\",\n \"rates\": [\n {\n \"deliveryMethod\": {\n \"id\": \"bd0e0bcb-10d1-4584-bf5b-ebd07a86e70f\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"12.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"0.00\",\n \"currency\": \"PLN\"\n }\n },\n {\n \"deliveryMethod\": {\n \"id\": \"5c76d200-c6db-46a7-9b78-7d067e8cfb2d\"\n },\n \"maxQuantityPerPackage\": 5,\n \"firstItemRate\": {\n \"amount\": \"16.99\",\n \"currency\": \"PLN\"\n },\n \"nextItemRate\": {\n \"amount\": \"2.00\",\n \"currency\": \"PLN\"\n }\n }\n ],\n \"allee\": {\n \"freeDeliveryFrom\": {\n \"amount\": \"200.00\",\n \"currency\": \"PLN\"\n }\n }\n}`\n\treq, err := http.NewRequest(\"PUT\", base+\"/sale/shipping-rates/797d2e65-cb23-4a16-98e9-d6f2a399839a\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Authorization\", \"Bearer \"+os.Getenv(\"ALLEE_API_KEY\"))\n\treq.Header.Set(\"Accept\", \"application/vnd.allegro.public.v1+json\")\n\treq.Header.Set(\"Content-Type\", \"application/vnd.allegro.public.v1+json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } }, "/security/leak-report": { "post": { "operationId": "reportLeakedSecrets", "summary": "Zgłoszenie wycieku kluczy (GitHub secret scanning)", "tags": [ "Bezpieczeństwo" ], "description": "Wywołuje **GitHub**, gdy w publicznym repozytorium znajdzie klucz allee (`allee_sk_live_…`, `allee_sk_test_…`, `allee_at_…`, `allee_rt_…`, `allee_cs_…`). Podpis ECDSA w nagłówkach `Github-Public-Key-Identifier` i `Github-Public-Key-Signature`.\n\nZnaleziony klucz unieważniamy natychmiast, token OAuth — razem z kwarantanną pary, a sprzedawca dostaje powiadomienie. Odpowiedź zawiera skrót SHA-256 zamiast jawnego tokenu. Integratorzy nie wołają tej trasy.\n\n**Zgodność:** tylko allee — GitHub secret scanning partner program.\n**Uwierzytelnienie:** brak.", "parameters": [ { "name": "Github-Public-Key-Identifier", "in": "header", "required": true, "description": "Identyfikator klucza GitHuba.", "schema": { "type": "string" } }, { "name": "Github-Public-Key-Signature", "in": "header", "required": true, "description": "Podpis ECDSA treści (base64).", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LeakReportItem" }, "maxItems": 1000 } } } }, "responses": { "200": { "description": "Wynik dla każdego tokenu.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LeakReportResult" }, "example": [ { "token_hash": "2a8052c39d6de83f4f808165c1f2a34edaaf0565c95045b11b528f7f747a69f3", "token_type": "allee_personal_api_key", "label": "false_positive" } ] } } }, "401": { "description": "Brak albo nieważny token lub klucz. Kody: `INVALID_SIGNATURE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "413": { "description": "Treść za duża. Kody: `PAYLOAD_TOO_LARGE`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "422": { "description": "Niepoprawne dane. Kody: `JsonMappingException`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "500": { "description": "Błąd serwera — podaj X-Request-Id. Kody: `INTERNAL_ERROR`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } }, "503": { "description": "Funkcja chwilowo niedostępna. Kody: `NOT_DEPLOYED`.", "headers": { "X-Request-Id": { "$ref": "#/components/headers/X-Request-Id" }, "X-RateLimit-Limit": { "$ref": "#/components/headers/X-RateLimit-Limit" }, "X-RateLimit-Remaining": { "$ref": "#/components/headers/X-RateLimit-Remaining" }, "X-RateLimit-Reset": { "$ref": "#/components/headers/X-RateLimit-Reset" }, "Retry-After": { "$ref": "#/components/headers/Retry-After" } }, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ErrorResponse" } } } } }, "security": [], "x-allee": { "compatibility": "allee", "equivalent": "GitHub secret scanning partner program", "limitGroup": "write", "errors": [ { "status": 401, "code": "INVALID_SIGNATURE" }, { "status": 413, "code": "PAYLOAD_TOO_LARGE" }, { "status": 422, "code": "JsonMappingException" }, { "status": 500, "code": "INTERNAL_ERROR" }, { "status": 503, "code": "NOT_DEPLOYED" } ] }, "x-codeSamples": [ { "lang": "Shell", "label": "cURL", "source": "curl -sS -X POST \"${ALLEE_API_URL:-https://api.allee.pl}/security/leak-report\" \\\n -H \"Accept: application/json\" \\\n -H \"Github-Public-Key-Identifier: dok-test-klucz-1\" \\\n -H \"Github-Public-Key-Signature: MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS\" \\\n -H \"Content-Type: application/json\" \\\n --data-raw '[{\"token\":\"allee_sk_live_…\",\"type\":\"allee_personal_api_key\",\"url\":\"https://github.com/przyklad/repo/blob/main/config.php\",\"source\":\"content\"}]' \\\n -w '\\nHTTP %{http_code}\\n'\n" }, { "lang": "PHP", "label": "PHP", "source": " 'POST',\n CURLOPT_HTTPHEADER => [\n 'Accept: application/json',\n 'Github-Public-Key-Identifier: dok-test-klucz-1',\n 'Github-Public-Key-Signature: MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS',\n 'Content-Type: application/json',\n ],\n CURLOPT_POSTFIELDS => $body,\n CURLOPT_RETURNTRANSFER => true,\n]);\n$odp = curl_exec($ch);\necho 'HTTP ', curl_getinfo($ch, CURLINFO_RESPONSE_CODE), \"\\n\", $odp, \"\\n\";\n" }, { "lang": "Python", "label": "Python", "source": "# allee API: POST /security/leak-report (Python 3, biblioteka requests)\nimport os\n\nimport requests\n\nBASE = os.environ.get(\"ALLEE_API_URL\", \"https://api.allee.pl\")\nheaders = {\n \"Accept\": \"application/json\",\n \"Github-Public-Key-Identifier\": \"dok-test-klucz-1\",\n \"Github-Public-Key-Signature\": \"MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS\",\n \"Content-Type\": \"application/json\",\n}\nbody = \"[{\\\"token\\\":\\\"allee_sk_live_…\\\",\\\"type\\\":\\\"allee_personal_api_key\\\",\\\"url\\\":\\\"https://github.com/przyklad/repo/blob/main/config.php\\\",\\\"source\\\":\\\"content\\\"}]\"\nr = requests.request(\"POST\", BASE + \"/security/leak-report\", headers=headers, data=body.encode(\"utf-8\"), timeout=60, allow_redirects=False)\nprint(\"HTTP\", r.status_code)\nprint(r.text)\n" }, { "lang": "JavaScript", "label": "JavaScript (Node.js)", "source": "// allee API: POST /security/leak-report (Node.js 18+, wbudowany fetch; plik .mjs)\nconst BASE = process.env.ALLEE_API_URL ?? \"https://api.allee.pl\";\nconst body = \"[{\\\"token\\\":\\\"allee_sk_live_…\\\",\\\"type\\\":\\\"allee_personal_api_key\\\",\\\"url\\\":\\\"https://github.com/przyklad/repo/blob/main/config.php\\\",\\\"source\\\":\\\"content\\\"}]\";\nconst res = await fetch(`${BASE}/security/leak-report`, {\n method: \"POST\",\n headers: {\n \"Accept\": \"application/json\",\n \"Github-Public-Key-Identifier\": \"dok-test-klucz-1\",\n \"Github-Public-Key-Signature\": \"MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS\",\n \"Content-Type\": \"application/json\",\n },\n body,\n redirect: \"manual\",\n});\nconsole.log(\"HTTP\", res.status);\nconsole.log(await res.text());\n" }, { "lang": "C#", "label": "C#", "source": "// allee API: POST /security/leak-report (C#, .NET 8+, HttpClient)\nusing System.Net.Http.Headers;\nusing System.Text;\n\nvar baseUrl = Environment.GetEnvironmentVariable(\"ALLEE_API_URL\") ?? \"https://api.allee.pl\";\nusing var http = new HttpClient(new HttpClientHandler { AllowAutoRedirect = false });\nusing var req = new HttpRequestMessage(new HttpMethod(\"POST\"), baseUrl + \"/security/leak-report\");\nreq.Headers.Accept.ParseAdd(\"application/json\");\nreq.Headers.Add(\"Github-Public-Key-Identifier\", \"dok-test-klucz-1\");\nreq.Headers.Add(\"Github-Public-Key-Signature\", \"MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS\");\nvar json = \"[{\\\"token\\\":\\\"allee_sk_live_…\\\",\\\"type\\\":\\\"allee_personal_api_key\\\",\\\"url\\\":\\\"https://github.com/przyklad/repo/blob/main/config.php\\\",\\\"source\\\":\\\"content\\\"}]\";\nreq.Content = new StringContent(json, Encoding.UTF8);\nreq.Content.Headers.ContentType = new MediaTypeHeaderValue(\"application/json\");\nusing var res = await http.SendAsync(req);\nConsole.WriteLine($\"HTTP {(int)res.StatusCode}\");\nConsole.WriteLine(await res.Content.ReadAsStringAsync());\n" }, { "lang": "Java", "label": "Java", "source": "// allee API: POST /security/leak-report (Java 11+, java.net.http; uruchom: java Main.java)\nimport java.net.URI;\nimport java.net.http.HttpClient;\nimport java.net.http.HttpRequest;\nimport java.net.http.HttpResponse;\n\npublic class Main {\n public static void main(String[] args) throws Exception {\n String base = System.getenv().getOrDefault(\"ALLEE_API_URL\", \"https://api.allee.pl\");\n String body = \"[{\\\"token\\\":\\\"allee_sk_live_…\\\",\\\"type\\\":\\\"allee_personal_api_key\\\",\\\"url\\\":\\\"https://github.com/przyklad/repo/blob/main/config.php\\\",\\\"source\\\":\\\"content\\\"}]\";\n HttpRequest req = HttpRequest.newBuilder(URI.create(base + \"/security/leak-report\"))\n .header(\"Accept\", \"application/json\")\n .header(\"Github-Public-Key-Identifier\", \"dok-test-klucz-1\")\n .header(\"Github-Public-Key-Signature\", \"MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS\")\n .header(\"Content-Type\", \"application/json\")\n .method(\"POST\", HttpRequest.BodyPublishers.ofString(body))\n .build();\n HttpClient http = HttpClient.newBuilder().version(HttpClient.Version.HTTP_1_1).build();\n HttpResponse res = http.send(req, HttpResponse.BodyHandlers.ofString());\n System.out.println(\"HTTP \" + res.statusCode());\n System.out.println(res.body());\n }\n}\n" }, { "lang": "Go", "label": "Go", "source": "// allee API: POST /security/leak-report (Go 1.20+, net/http; uruchom: go run main.go)\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io\"\n\t\"net/http\"\n\t\"os\"\n\t\"strings\"\n)\n\nfunc main() {\n\tbase := os.Getenv(\"ALLEE_API_URL\")\n\tif base == \"\" {\n\t\tbase = \"https://api.allee.pl\"\n\t}\n\tbody := `[{\"token\":\"allee_sk_live_…\",\"type\":\"allee_personal_api_key\",\"url\":\"https://github.com/przyklad/repo/blob/main/config.php\",\"source\":\"content\"}]`\n\treq, err := http.NewRequest(\"POST\", base+\"/security/leak-report\", strings.NewReader(body))\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\treq.Header.Set(\"Accept\", \"application/json\")\n\treq.Header.Set(\"Github-Public-Key-Identifier\", \"dok-test-klucz-1\")\n\treq.Header.Set(\"Github-Public-Key-Signature\", \"MEYCIQCDjKriWvn4Qfh5aSJUn2p+zd9eZdn8FnzIqmdC9W+sZQIhAKCVfQ3f55eEx9RN9+RcvOPKH2aEJBDiqQk6hXtC9OwS\")\n\treq.Header.Set(\"Content-Type\", \"application/json\")\n\tklient := &http.Client{CheckRedirect: func(*http.Request, []*http.Request) error { return http.ErrUseLastResponse }}\n\tres, err := klient.Do(req)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tdefer res.Body.Close()\n\tdane, err := io.ReadAll(res.Body)\n\tif err != nil {\n\t\tpanic(err)\n\t}\n\tfmt.Println(\"HTTP\", res.StatusCode)\n\tfmt.Println(string(dane))\n}\n" } ] } } }, "webhooks": { "ORDER_CHANGE": { "post": { "summary": "Powiadomienie ORDER_CHANGE", "operationId": "webhookOrderChange", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "ORDER_CHANGE" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationOrderChange" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "OFFER_STATUS_CHANGE": { "post": { "summary": "Powiadomienie OFFER_STATUS_CHANGE", "operationId": "webhookOfferStatusChange", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "OFFER_STATUS_CHANGE" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationOfferStatusChange" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "OFFER_ISSUES_CHANGE": { "post": { "summary": "Powiadomienie OFFER_ISSUES_CHANGE", "operationId": "webhookOfferIssuesChange", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "OFFER_ISSUES_CHANGE" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationOfferIssuesChange" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "MESSAGE_RECEIVED": { "post": { "summary": "Powiadomienie MESSAGE_RECEIVED", "operationId": "webhookMessageReceived", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "MESSAGE_RECEIVED" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationMessageReceived" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "RETURN_CHANGE": { "post": { "summary": "Powiadomienie RETURN_CHANGE", "operationId": "webhookReturnChange", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "RETURN_CHANGE" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationReturnChange" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "ISSUE_CHANGE": { "post": { "summary": "Powiadomienie ISSUE_CHANGE", "operationId": "webhookIssueChange", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "ISSUE_CHANGE" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationIssueChange" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "FEED_PROCESSING_FINISHED": { "post": { "summary": "Powiadomienie FEED_PROCESSING_FINISHED", "operationId": "webhookFeedProcessingFinished", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "FEED_PROCESSING_FINISHED" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationFeedFinished" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "REPORT_PROCESSING_FINISHED": { "post": { "summary": "Powiadomienie REPORT_PROCESSING_FINISHED", "operationId": "webhookReportProcessingFinished", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "REPORT_PROCESSING_FINISHED" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationReportFinished" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "API_KEY_SECURITY_EVENT": { "post": { "summary": "Powiadomienie API_KEY_SECURITY_EVENT", "operationId": "webhookApiKeySecurityEvent", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "API_KEY_SECURITY_EVENT" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationSecurityEvent" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "SELLER_COMPLIANCE_CHANGED": { "post": { "summary": "Powiadomienie SELLER_COMPLIANCE_CHANGED", "operationId": "webhookSellerComplianceChanged", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "SELLER_COMPLIANCE_CHANGED" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationSellerComplianceChanged" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "OFFER_NOTICE_RECEIVED": { "post": { "summary": "Powiadomienie OFFER_NOTICE_RECEIVED", "operationId": "webhookOfferNoticeReceived", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "OFFER_NOTICE_RECEIVED" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationOfferNoticeReceived" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "OFFER_RESTRICTED": { "post": { "summary": "Powiadomienie OFFER_RESTRICTED", "operationId": "webhookOfferRestricted", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "OFFER_RESTRICTED" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationOfferRestricted" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "TEST_NOTIFICATION": { "post": { "summary": "Powiadomienie TEST_NOTIFICATION", "operationId": "webhookTestNotification", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "TEST_NOTIFICATION" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationTest" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } }, "DESTINATION_VERIFICATION": { "post": { "summary": "Powiadomienie DESTINATION_VERIFICATION", "operationId": "webhookDestinationVerification", "description": "allee wysyła POST na adres destynacji. Nagłówki: `Allee-Signature: t=,v1=` (HMAC-SHA256 sekretu destynacji nad `t + \".\" + surowa treść`; przy rotacji dwa `v1`), `Allee-Notification-Id`, `Allee-Notification-Type`, `Allee-Delivery-Attempt`. Odpowiedz 2xx w 5 s; inaczej ponowienia wykładnicze do 24 h. Odrzucaj podpisy starsze niż 300 s i duplikaty `notificationId`. Odpowiedz `{\"challenge\": \"\"}`.", "parameters": [ { "name": "Allee-Signature", "in": "header", "required": true, "schema": { "type": "string", "examples": [ "t=1794205145,v1=5257a869e7ecebeda32affa62cdca3fa51cad7e77a0e56ff536d0ce8e108d8bd" ] } }, { "name": "Allee-Notification-Id", "in": "header", "required": true, "schema": { "type": "string" } }, { "name": "Allee-Notification-Type", "in": "header", "required": true, "schema": { "type": "string", "enum": [ "DESTINATION_VERIFICATION" ] } }, { "name": "Allee-Delivery-Attempt", "in": "header", "required": false, "schema": { "type": "integer" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/NotificationVerification" } } } }, "responses": { "200": { "description": "Odebrano (każdy kod 2xx)." } } } } }, "components": { "schemas": { "Money": { "type": "object", "properties": { "amount": { "type": "string", "description": "Kwota z dwoma miejscami po przecinku, kropka dziesiętna.", "pattern": "^-?[0-9]+\\.[0-9]{2}$", "examples": [ "49.90" ] }, "currency": { "type": "string", "enum": [ "PLN" ], "description": "Waluta (allee.pl: tylko PLN)." } }, "required": [ "amount", "currency" ], "description": "Kwota (kształt Allegro)." }, "MoneyInput": { "type": "object", "properties": { "amount": { "type": [ "string", "number" ], "description": "Kwota jako tekst „123.45” (zalecane) albo liczba.", "examples": [ "49.90" ] }, "currency": { "type": "string", "enum": [ "PLN" ], "description": "Waluta: tylko PLN (domyślnie PLN)." } }, "required": [ "amount" ], "description": "Kwota w żądaniu." }, "Error": { "type": "object", "properties": { "code": { "type": "string", "description": "Kod maszynowy błędu — na nim opieraj obsługę (lista: przewodnik „Błędy”).", "examples": [ "VALIDATION_ERROR" ] }, "message": { "type": "string", "description": "Opis dla programisty (po polsku)." }, "details": { "description": "Dane dodatkowe albo null — np. id istniejącej oferty przy OfferDuplicate, {\"current\": \"SENT\"} przy błędzie statusu, {\"retryAfterMs\": 1200} przy limicie." }, "path": { "type": [ "string", "null" ], "description": "Pole żądania, którego dotyczy błąd, np. productSet[0].product.parameters." }, "userMessage": { "type": "string", "description": "Komunikat, który można pokazać sprzedawcy." } }, "required": [ "code", "message", "details", "path", "userMessage" ], "description": "Jeden błąd (kształt Allegro)." }, "ErrorResponse": { "type": "object", "properties": { "errors": { "type": "array", "items": { "$ref": "#/components/schemas/Error" }, "description": "Wszystkie wykryte problemy naraz (walidacja oferty zwraca komplet — poprawiasz raz).", "minItems": 1 } }, "required": [ "errors" ], "description": "Odpowiedź błędu (wszystkie trasy poza OAuth). Czytaj errors[0].code; X-Request-Id z nagłówka podaj przy zgłoszeniu." }, "OAuthError": { "type": "object", "properties": { "error": { "type": "string", "description": "Kod OAuth 2.0 (RFC 6749): invalid_token, invalid_client, invalid_grant, invalid_request, unsupported_grant_type, slow_down." }, "error_description": { "type": "string", "description": "Opis po polsku." } }, "required": [ "error", "error_description" ], "description": "Błąd w formacie OAuth (401 tokenu, odpowiedzi /auth/oauth/*)." }, "IdRef": { "type": "object", "properties": { "id": { "type": "string" } }, "required": [ "id" ], "description": "Odwołanie po identyfikatorze." }, "CategoryRef": { "type": "object", "properties": { "id": { "type": [ "string", "null" ], "description": "Identyfikator kategorii Allegro (bywa liczbą, bywa UUID).", "examples": [ "20585" ] }, "alleeId": { "type": "integer", "description": "Identyfikator kategorii allee.", "examples": [ 35 ] } }, "required": [ "id", "alleeId" ], "description": "Kategoria — oba identyfikatory." }, "RateGroup": { "type": "object", "properties": { "rate": { "type": "number", "description": "Stałe tempo: żądań na sekundę." }, "burst": { "type": "integer", "description": "Ile żądań naraz ponad tempo." } }, "required": [ "rate", "burst" ], "description": "Limit grupy operacji." }, "UsagePlan": { "type": "object", "properties": { "name": { "type": "string", "enum": [ "allegro", "start", "standard", "pro" ], "description": "Plan użycia: „allegro” = aplikacje sprzed kluczy (okno minutowe), start/standard/pro = limity grup GCRA." }, "perMinute": { "type": "integer", "description": "Sufit żądań na minutę dla pary aplikacja × sprzedawca (nagłówek X-RateLimit-Limit)." }, "groups": { "type": [ "object", "null" ], "properties": { "read": { "$ref": "#/components/schemas/RateGroup" }, "write": { "$ref": "#/components/schemas/RateGroup" }, "bulk": { "$ref": "#/components/schemas/RateGroup" } }, "required": [ "read", "write", "bulk" ], "description": "Limity grup operacji (algorytm GCRA); null w planie „allegro” (tylko okno minutowe)." } }, "required": [ "name", "perMinute", "groups" ], "description": "Plan użycia i limity." }, "ServiceStatus": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ok" ] }, "api": { "type": "string", "enum": [ "allee" ] }, "czas": { "type": "string", "format": "date-time", "description": "Bieżący czas serwera (UTC)." } }, "required": [ "status", "api", "czas" ], "description": "Stan usługi." }, "Me": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "login": { "type": "string", "description": "Login na allee.pl." }, "email": { "type": "string", "description": "E-mail konta." }, "firstName": { "type": [ "string", "null" ], "description": "allee nie przechowuje imienia — zawsze null." }, "lastName": { "type": [ "string", "null" ], "description": "Zawsze null." }, "company": { "type": [ "object", "null" ], "properties": { "name": { "type": [ "string", "null" ], "description": "Nazwa firmy." }, "taxId": { "type": [ "string", "null" ], "description": "NIP." } }, "required": [ "name", "taxId" ], "description": "Dane firmy — tylko konto firmowe; null dla konta prywatnego." } }, "required": [ "id", "login", "email", "firstName", "lastName", "company" ], "description": "Konto sprzedawcy (kształt Allegro GET /me)." }, "TokenInfo": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "OAUTH_ACCESS_TOKEN", "PERSONAL_API_KEY", "APPLICATION_TOKEN" ], "description": "Rodzaj poświadczenia." }, "key": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "description": "Numer klucza osobistego (bez sekretu)." } }, "required": [ "id" ], "description": "Tylko dla klucza osobistego." }, "application": { "type": "object", "properties": { "clientId": { "type": [ "string", "null" ], "description": "client_id aplikacji." }, "name": { "type": [ "string", "null" ], "description": "Nazwa aplikacji." } }, "required": [ "clientId", "name" ], "description": "Aplikacja (dla kluczy osobistych: ukryta aplikacja „Klucze osobiste”; w trybie test pola są null)." }, "user": { "type": "object", "properties": { "id": { "type": "string" }, "login": { "type": [ "string", "null" ], "description": "Login (w trybie test null)." }, "active": { "type": "boolean", "description": "Czy konto sprzedawcy jest aktywne." } }, "required": [ "id", "login", "active" ] }, "scopes": { "type": "array", "items": { "type": "string", "examples": [ "allegro:api:sale:offers:read" ] }, "description": "Zakresy tego poświadczenia (nazwy z przedrostkiem allegro:api: albo allee:api:)." }, "expiresAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Kiedy token/klucz wygasa; null = bezterminowy klucz." }, "usagePlan": { "$ref": "#/components/schemas/UsagePlan" } }, "required": [ "type", "key", "application", "user", "scopes", "expiresAt", "usagePlan" ], "description": "Co może bieżący token albo klucz (introspekcja, bez sekretów)." }, "SellerAccount": { "type": "object", "properties": { "sellerId": { "type": "string" }, "login": { "type": "string" }, "accountType": { "type": "string", "enum": [ "BUSINESS", "INDIVIDUAL" ], "description": "Konto firmowe albo prywatne." }, "status": { "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] }, "businessVerification": { "type": [ "object", "null" ], "properties": { "status": { "type": "string", "enum": [ "VERIFIED", "PENDING", "FAILED", "MISSING", "NOT_STARTED" ], "description": "Weryfikacja firmy w rejestrach (NIP)." }, "checkedAt": { "type": [ "string", "null" ], "format": "date-time" }, "taxId": { "type": [ "string", "null" ], "description": "NIP." }, "companyName": { "type": [ "string", "null" ] } }, "required": [ "status", "checkedAt", "taxId", "companyName" ], "description": "Tylko konto firmowe." }, "createdAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Data założenia konta." }, "marketplace": { "$ref": "#/components/schemas/Marketplace" }, "usagePlan": { "$ref": "#/components/schemas/UsagePlan" }, "rateLimitHeader": { "type": [ "string", "null" ], "description": "Dokładnie to, co zawiera nagłówek X-Allee-RateLimit tej odpowiedzi (null w planie allegro).", "examples": [ "plan=pro; group=read; rate=50; burst=150" ] }, "credential": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "OAUTH_ACCESS_TOKEN", "PERSONAL_API_KEY", "APPLICATION_TOKEN" ] }, "keyId": { "type": [ "string", "null" ] }, "scopes": { "type": "array", "items": { "type": "string" } }, "expiresAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "type", "keyId", "scopes", "expiresAt" ], "description": "Poświadczenie tego żądania." }, "offers": { "type": "object", "properties": { "active": { "type": "integer", "description": "Aktywne oferty." }, "all": { "type": "integer", "description": "Wszystkie oferty konta (sprzedawca, API, integracje)." } }, "required": [ "active", "all" ] }, "ordersIntegration": { "type": "object", "properties": { "owner": { "type": "string", "enum": [ "PANEL", "THIS_APPLICATION", "OTHER_APPLICATION", "BASELINKER" ], "description": "Kto obsługuje zamówienia allee.pl tego sprzedawcy (jedna integracja naraz)." } }, "required": [ "owner" ] }, "restrictions": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "ACCOUNT_INACTIVE", "QUARANTINE_READ_ONLY", "SUSPENDED", "ADULT_CONTENT_NOT_CONFIRMED", "PRIVATE_ACCOUNT_LIMITS" ] }, "message": { "type": "string" } }, "required": [ "code", "message" ] }, "description": "Ograniczenia konta, które wpływają na API." } }, "required": [ "sellerId", "login", "accountType", "status", "businessVerification", "createdAt", "marketplace", "usagePlan", "rateLimitHeader", "credential", "offers", "ordersIntegration", "restrictions" ], "description": "Konto, plan użycia i ograniczenia („po amazonowemu”: getMarketplaceParticipations + limity)." }, "SellerLegalProfile": { "type": "object", "properties": { "sellerId": { "type": "string" }, "sellerType": { "type": "string", "enum": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ], "description": "Rodzaj sprzedawcy: osoba prywatna, jednoosobowa działalność, spółka, działalność nierejestrowana." }, "sellerTypeConfirmed": { "type": "boolean", "description": "false = rodzaj zgadnięty z konta (prywatne/firmowe) — potwierdź go przez PUT." }, "sellerTypeLabel": { "type": "string", "description": "Nazwa rodzaju po polsku." }, "country": { "type": "string", "description": "Kraj zamieszkania lub siedziby (ISO 3166-1 alfa-2).", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "contactLanguage": { "type": "string", "description": "Język kontaktu (ISO 639-1).", "examples": [ "pl" ] }, "phone": { "type": [ "string", "null" ], "description": "Telefon E.164.", "examples": [ "+48601234567" ] }, "personName": { "type": [ "string", "null" ], "description": "Imię i nazwisko." }, "company": { "type": [ "object", "null" ], "properties": { "companyName": { "type": [ "string", "null" ] }, "legalName": { "type": [ "string", "null" ], "description": "Pełna nazwa prawna, gdy inna niż companyName." }, "taxId": { "type": [ "string", "null" ], "description": "NIP (10 cyfr)." }, "registrationNumbers": { "type": "object", "properties": { "regon": { "type": [ "string", "null" ] }, "krs": { "type": [ "string", "null" ] }, "bdo": { "type": [ "string", "null" ] } }, "required": [ "regon", "krs", "bdo" ] }, "address": { "type": "object", "properties": { "street": { "type": [ "string", "null" ] }, "postalCode": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "countryCode": { "type": "string" } }, "required": [ "street", "postalCode", "city", "countryCode" ], "description": "Adres siedziby." }, "contact": { "type": "object", "properties": { "email": { "type": "string", "description": "E-mail dla kupujących (domyślnie e-mail konta)." }, "phone": { "type": [ "string", "null" ] } }, "required": [ "email", "phone" ] }, "publicDataVisible": { "type": "boolean", "description": "Czy kupujący widzą komplet danych przedsiębiorcy (DSA art. 30) na stronie sklepu i oferty." } }, "required": [ "companyName", "legalName", "taxId", "registrationNumbers", "address", "contact", "publicDataVisible" ], "description": "Tylko SOLE_TRADER i COMPANY." }, "updatedAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "sellerId", "sellerType", "sellerTypeConfirmed", "sellerTypeLabel", "country", "contactLanguage", "phone", "personName", "company", "updatedAt" ], "description": "Profil prawny sprzedawcy." }, "SellerLegalProfileUpdate": { "type": "object", "properties": { "sellerType": { "type": "string", "enum": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ] }, "country": { "type": "string", "description": "ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$" }, "contactLanguage": { "type": "string", "enum": [ "pl", "en", "de", "cs", "sk", "uk", "lt", "fr", "es", "it" ] }, "phone": { "type": [ "string", "null" ], "description": "Dowolny zapis; zamieniamy na E.164 (9 cyfr bez kierunkowego = Polska).", "examples": [ "+48 601 234 567" ] }, "personName": { "type": [ "string", "null" ], "description": "Imię i nazwisko.", "maxLength": 190 }, "companyName": { "type": "string", "description": "Nazwa firmy (SOLE_TRADER, COMPANY).", "maxLength": 190 }, "taxId": { "type": "string", "description": "NIP, z „PL” albo bez.", "examples": [ "5260250274" ] }, "registrationNumbers": { "type": "object", "properties": { "regon": { "type": [ "string", "null" ] }, "krs": { "type": [ "string", "null" ] }, "bdo": { "type": [ "string", "null" ] } } }, "address": { "type": "object", "properties": { "street": { "type": "string" }, "postalCode": { "type": "string" }, "city": { "type": "string" }, "countryCode": { "type": "string", "pattern": "^[A-Z]{2}$" } }, "description": "Adres siedziby." }, "contact": { "type": "object", "properties": { "email": { "type": [ "string", "null" ], "format": "email" }, "phone": { "type": [ "string", "null" ] } }, "description": "Kontakt dla kupujących." } }, "description": "Zmiana profilu: pola nieobecne zostają bez zmian. Pola tylko do odczytu z GET (sellerId, company, updatedAt…) są pomijane." }, "SellerLegalProfileHistory": { "type": "object", "properties": { "changes": { "type": "array", "items": { "type": "object", "properties": { "field": { "type": "string", "description": "Pole (ścieżka API), np. phone, address.city, declaration.DSA_LEGAL_PRODUCTS, restriction.offers." }, "before": { "type": [ "string", "null" ] }, "after": { "type": [ "string", "null" ] }, "channel": { "type": "string", "enum": [ "PANEL", "API", "ADMIN", "SYSTEM" ] }, "applicationId": { "type": [ "string", "null" ], "description": "Aplikacja, która zmieniła (kanał API)." }, "changedAt": { "type": "string", "format": "date-time" } }, "required": [ "field", "before", "after", "channel", "applicationId", "changedAt" ] } }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "changes", "limit", "offset" ], "description": "Historia zmian danych prawnych (najnowsze pierwsze)." }, "ComplianceArea": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "VERIFIED", "PENDING", "NOT_STARTED", "REJECTED", "NOT_REQUIRED", "NOT_AVAILABLE" ], "description": "NOT_AVAILABLE = funkcja allee jeszcze nie działa (np. wypłaty, DAC7)." }, "reason": { "type": [ "string", "null" ], "description": "Wyjaśnienie dla sprzedawcy." }, "checkedAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Ostatnie sprawdzenie w rejestrach (business)." }, "vatStatus": { "type": [ "string", "null" ], "description": "Status VAT z Białej listy (tax)." }, "activeOffers": { "type": "integer", "description": "Aktywne oferty (productCompliance)." } }, "required": [ "status", "reason" ], "description": "Status jednego obszaru." }, "SellerCompliance": { "type": "object", "properties": { "sellerId": { "type": "string" }, "status": { "type": "string", "enum": [ "ACTIVE", "INCOMPLETE", "RESTRICTED", "SUSPENDED", "CLOSED" ], "description": "Status główny." }, "sellerType": { "type": "string", "enum": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ] }, "sellerTypeConfirmed": { "type": "boolean" }, "statuses": { "type": "object", "properties": { "identity": { "$ref": "#/components/schemas/ComplianceArea" }, "business": { "$ref": "#/components/schemas/ComplianceArea" }, "payment": { "$ref": "#/components/schemas/ComplianceArea" }, "tax": { "$ref": "#/components/schemas/ComplianceArea" }, "dac7": { "$ref": "#/components/schemas/ComplianceArea" }, "productCompliance": { "$ref": "#/components/schemas/ComplianceArea" } }, "required": [ "identity", "business", "payment", "tax", "dac7", "productCompliance" ], "description": "Obszary niezależne." }, "restrictions": { "type": "object", "properties": { "offers": { "type": "object", "properties": { "blocked": { "type": "boolean" }, "since": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "blocked", "since" ], "description": "Nowe oferty i wznowienia wstrzymane." }, "payouts": { "type": "object", "properties": { "blocked": { "type": "boolean" }, "since": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "blocked", "since" ], "description": "Wypłaty wstrzymane." }, "selling": { "type": "object", "properties": { "suspended": { "type": "boolean" }, "since": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "suspended", "since" ], "description": "Sprzedaż zawieszona." }, "reason": { "type": [ "string", "null" ], "description": "Uzasadnienie (DSA art. 17)." } }, "required": [ "offers", "payouts", "selling", "reason" ], "description": "Trzy poziomy blokady." }, "missing": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "description": "Np. PHONE_MISSING, TAX_ID_INVALID, DECLARATION_REQUIRED, GPSR_PRODUCER_MISSING." }, "path": { "type": "string", "description": "Pole albo miejsce do uzupełnienia." }, "message": { "type": "string" }, "userMessage": { "type": "string" }, "severity": { "type": "string", "enum": [ "ERROR", "WARNING" ], "description": "ERROR = wymagane, WARNING = zalecane." }, "area": { "type": "string", "enum": [ "identity", "business", "tax", "productCompliance", "payment", "dac7" ] }, "details": { "type": "object", "additionalProperties": true, "description": "Np. {code, version} oświadczenia." } }, "required": [ "code", "path", "message", "userMessage", "severity", "area" ] }, "description": "Braki (ERROR przed WARNING)." }, "summary": { "type": "object", "properties": { "errors": { "type": "integer" }, "warnings": { "type": "integer" } }, "required": [ "errors", "warnings" ] }, "declarations": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "title": { "type": "string" }, "required": { "type": "boolean", "description": "Wymagane dla tego rodzaju sprzedawcy." }, "accepted": { "type": "boolean", "description": "Zaakceptowana aktualna wersja." }, "acceptedAt": { "type": [ "string", "null" ], "format": "date-time" }, "previousVersionAccepted": { "type": "boolean", "description": "Zaakceptowana wcześniejsza wersja (treść się zmieniła)." } }, "required": [ "code", "version", "title", "required", "accepted", "acceptedAt", "previousVersionAccepted" ] } }, "enforcement": { "type": "object", "properties": { "active": { "type": "boolean", "description": "true = braki ERROR blokują nowe oferty." }, "description": { "type": "string" } }, "required": [ "active", "description" ] } }, "required": [ "sellerId", "status", "sellerType", "sellerTypeConfirmed", "statuses", "restrictions", "missing", "summary", "declarations", "enforcement" ], "description": "Stan zgodności sprzedawcy." }, "Declaration": { "type": "object", "properties": { "code": { "type": "string", "examples": [ "DSA_LEGAL_PRODUCTS" ] }, "version": { "type": "string", "examples": [ "2026-11-10" ] }, "title": { "type": "string" }, "text": { "type": "string", "description": "Pełna treść do pokazania sprzedawcy." }, "legalBasis": { "type": [ "string", "null" ] }, "requiredFor": { "type": "array", "items": { "type": "string", "enum": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ] } }, "effectiveFrom": { "type": [ "string", "null" ], "format": "date-time" }, "accepted": { "type": "object", "properties": { "current": { "type": "boolean", "description": "Zaakceptowana aktualna wersja." }, "acceptedAt": { "type": [ "string", "null" ], "format": "date-time" }, "acceptedVersions": { "type": "array", "items": { "type": "string" } } }, "required": [ "current", "acceptedAt", "acceptedVersions" ] } }, "required": [ "code", "version", "title", "text", "legalBasis", "requiredFor", "effectiveFrom", "accepted" ], "description": "Oświadczenie." }, "DeclarationList": { "type": "object", "properties": { "declarations": { "type": "array", "items": { "$ref": "#/components/schemas/Declaration" } } }, "required": [ "declarations" ] }, "DeclarationAcceptRequest": { "type": "object", "properties": { "code": { "type": "string", "description": "Kod z GET /allee/declarations." }, "version": { "type": "string", "description": "Wersja, którą sprzedawca przeczytał (zalecane — inna niż aktualna → 409)." } }, "required": [ "code" ] }, "DeclarationAcceptResponse": { "type": "object", "properties": { "code": { "type": "string" }, "version": { "type": "string" }, "accepted": { "type": "boolean" }, "compliance": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ACTIVE", "INCOMPLETE", "RESTRICTED", "SUSPENDED", "CLOSED" ] } }, "required": [ "status" ] } }, "required": [ "code", "version", "accepted", "compliance" ] }, "ComplianceRule": { "type": "object", "properties": { "code": { "type": "string", "examples": [ "ENERGY_CLASS" ] }, "version": { "type": "string" }, "name": { "type": "string" }, "issueCode": { "type": "string", "description": "Kod problemu w issues[] oferty, np. ENERGY_CLASS_MISSING." }, "requirement": { "type": "string", "description": "Co podać." }, "legalBasis": { "type": [ "string", "null" ] }, "path": { "type": "string", "description": "Pole oferty, np. parameters.{id} albo productSet[0].responsibleProducer." }, "sellerTypes": { "type": "array", "items": { "type": "string", "enum": [ "PRIVATE_PERSON", "SOLE_TRADER", "COMPANY", "UNREGISTERED_ACTIVITY" ] } }, "condition": { "type": "string", "enum": [ "NEW", "ANY" ], "description": "Stan produktu, którego dotyczy." }, "effect": { "type": "string", "enum": [ "WARN", "BLOCK" ] }, "severity": { "type": "string", "enum": [ "ERROR", "WARNING" ], "description": "Waga dziś (BLOCK przed blockingFrom = WARNING)." }, "blockingFrom": { "type": [ "string", "null" ], "format": "date-time" }, "effectiveFrom": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "code", "version", "name", "issueCode", "requirement", "legalBasis", "path", "sellerTypes", "condition", "effect", "severity", "blockingFrom", "effectiveFrom" ], "description": "Reguła." }, "ComplianceRuleList": { "type": "object", "properties": { "category": { "type": "object", "properties": { "id": { "type": "string", "description": "Kategoria allee." } }, "required": [ "id" ] }, "sellerType": { "type": [ "string", "null" ] }, "rules": { "type": "array", "items": { "$ref": "#/components/schemas/ComplianceRule" } }, "count": { "type": "integer" } }, "required": [ "category", "sellerType", "rules", "count" ] }, "OfferCompliance": { "type": "object", "properties": { "offerId": { "type": "string" }, "status": { "type": "string", "enum": [ "COMPLIANT", "WARNINGS", "BLOCKED" ] }, "publishingAllowed": { "type": "boolean", "description": "Czy można teraz opublikować / wznowić ofertę." }, "publishingBlockedBy": { "type": [ "object", "null" ], "properties": { "code": { "type": "string", "enum": [ "SELLER_COMPLIANCE_INCOMPLETE", "OFFER_COMPLIANCE_BLOCKED" ] }, "message": { "type": "string" } }, "required": [ "code", "message" ] }, "issues": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "severity": { "type": "string", "enum": [ "ERROR", "WARNING" ] }, "path": { "type": "string" }, "rule": { "type": "string" }, "ruleVersion": { "type": "string" }, "legalBasis": { "type": [ "string", "null" ] }, "blockingFrom": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "code", "message", "severity", "path", "rule", "ruleVersion", "legalBasis", "blockingFrom" ] } } }, "required": [ "offerId", "status", "publishingAllowed", "publishingBlockedBy", "issues" ], "description": "Ocena oferty regułami prawnymi." }, "TextInput": { "type": "object", "properties": { "text": { "type": "string", "description": "Treść (stanowisko albo uzasadnienie odwołania).", "maxLength": 5000 } }, "required": [ "text" ] }, "Notice": { "type": "object", "properties": { "id": { "type": "string", "description": "Numer zgłoszenia.", "examples": [ "DSA-2026-000001" ] }, "offerId": { "type": [ "string", "null" ] }, "subject": { "type": "string", "enum": [ "OFERTA", "SKLEP", "INNE" ] }, "url": { "type": "string" }, "category": { "type": "string", "enum": [ "NIELEGALNY_PRODUKT", "NIEBEZPIECZNY_PRODUKT", "PODROBKA", "WLASNOSC_INTELEKTUALNA", "OSZUSTWO", "TRESC_NIEZGODNA", "DANE_OSOBOWE", "OCHRONA_MALOLETNICH", "OCHRONA_KONSUMENTA", "INNE" ] }, "categoryLabel": { "type": "string" }, "explanation": { "type": "string", "description": "Uzasadnienie zgłaszającego." }, "status": { "type": "string", "enum": [ "NOWE", "W_TOKU", "ZASADNE", "NIEZASADNE", "WYCOFANE" ] }, "trustedFlagger": { "type": "boolean", "description": "Zaufany podmiot sygnalizujący (art. 22)." }, "createdAt": { "type": "string", "format": "date-time" }, "sellerResponse": { "type": [ "object", "null" ], "properties": { "text": { "type": "string" }, "respondedAt": { "type": [ "string", "null" ], "format": "date-time" }, "channel": { "type": [ "string", "null" ], "enum": [ "PANEL", "API", null ] } }, "required": [ "text", "respondedAt", "channel" ] }, "decisionId": { "type": [ "string", "null" ] } }, "required": [ "id", "offerId", "subject", "url", "category", "categoryLabel", "explanation", "status", "trustedFlagger", "createdAt", "sellerResponse", "decisionId" ], "description": "Zgłoszenie (bez danych zgłaszającego)." }, "NoticeList": { "type": "object", "properties": { "notices": { "type": "array", "items": { "$ref": "#/components/schemas/Notice" } }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "notices", "limit", "offset" ] }, "Decision": { "type": "object", "properties": { "id": { "type": "string", "examples": [ "DEC-2026-000001" ] }, "noticeId": { "type": [ "string", "null" ] }, "offerId": { "type": [ "string", "null" ] }, "measure": { "type": "string", "enum": [ "BRAK_DZIALANIA", "OSTRZEZENIE", "OFERTA_ZAKONCZONA", "BLOKADA_OFERT", "BLOKADA_WYPLAT", "ZAWIESZENIE" ] }, "measureLabel": { "type": "string" }, "legalGround": { "type": "string", "enum": [ "ILLEGAL_CONTENT", "TERMS_OF_SERVICE" ] }, "groundReference": { "type": "string", "description": "Przepis albo punkt regulaminu." }, "facts": { "type": "string", "description": "Fakty i okoliczności." }, "automatedMeans": { "type": "boolean" }, "territorialScope": { "type": "string" }, "createdAt": { "type": "string", "format": "date-time" }, "redress": { "type": "object", "properties": { "internalComplaint": { "type": "string" }, "outOfCourt": { "type": "string" }, "court": { "type": "string" } }, "required": [ "internalComplaint", "outOfCourt", "court" ], "description": "Środki odwoławcze." }, "appealDeadline": { "type": "string", "format": "date-time" }, "appeal": { "type": [ "object", "null" ], "properties": { "status": { "type": "string", "enum": [ "SUBMITTED", "ACCEPTED", "REJECTED" ] }, "text": { "type": [ "string", "null" ] }, "submittedAt": { "type": [ "string", "null" ], "format": "date-time" }, "resolution": { "type": [ "string", "null" ] }, "resolvedAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "status", "text", "submittedAt", "resolution", "resolvedAt" ] } }, "required": [ "id", "noticeId", "offerId", "measure", "measureLabel", "legalGround", "groundReference", "facts", "automatedMeans", "territorialScope", "createdAt", "redress", "appealDeadline", "appeal" ], "description": "Decyzja z uzasadnieniem (DSA art. 17)." }, "DecisionList": { "type": "object", "properties": { "decisions": { "type": "array", "items": { "$ref": "#/components/schemas/Decision" } }, "limit": { "type": "integer" }, "offset": { "type": "integer" } }, "required": [ "decisions", "limit", "offset" ] }, "NotificationOfferNoticeReceived": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "OFFER_NOTICE_RECEIVED" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "noticeId": { "type": "string" }, "offerId": { "type": [ "string", "null" ] }, "category": { "type": "string" }, "status": { "type": "string", "enum": [ "NEW" ] } }, "required": [ "noticeId", "offerId", "category", "status" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "OFFER_NOTICE_RECEIVED — nowe zgłoszenie nielegalnej treści dotyczące oferty lub sklepu. Szczegóły: GET /allee/notices." }, "NotificationOfferRestricted": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "OFFER_RESTRICTED" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "decisionId": { "type": "string" }, "offerId": { "type": [ "string", "null" ] }, "measure": { "type": "string" }, "noticeId": { "type": [ "string", "null" ] } }, "required": [ "decisionId", "offerId", "measure", "noticeId" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "OFFER_RESTRICTED — decyzja allee wobec oferty lub konta. Uzasadnienie: GET /allee/decisions/{id}." }, "Marketplace": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "allee-pl" ] }, "countryCode": { "type": "string", "enum": [ "PL" ] }, "currency": { "type": "string", "enum": [ "PLN" ] }, "language": { "type": "string", "enum": [ "pl-PL" ] } }, "required": [ "id", "countryCode", "currency", "language" ], "description": "Rynek." }, "MarketplaceList": { "type": "object", "properties": { "marketplaces": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "allee-pl" ] }, "name": { "type": "string" }, "languages": { "type": "object", "properties": { "base": { "type": "string" }, "extra": { "type": "array", "items": { "type": "string" } } }, "required": [ "base", "extra" ] }, "currencies": { "type": "object", "properties": { "base": { "type": "string" }, "extra": { "type": "array", "items": { "type": "string" } } }, "required": [ "base", "extra" ] } }, "required": [ "id", "name", "languages", "currencies" ] } } }, "required": [ "marketplaces" ], "description": "Rynki (Allegro GET /marketplaces)." }, "SandboxSummary": { "type": "object", "properties": { "mode": { "type": "string", "enum": [ "test" ] }, "seller": { "$ref": "#/components/schemas/IdRef" }, "buyer": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ], "description": "Kupujący demo (fikcyjny)." }, "createdAt": { "type": [ "string", "null" ], "format": "date-time" }, "dataVersion": { "type": "integer", "description": "Wersja danych demo." }, "offers": { "type": "object", "properties": { "active": { "type": "integer" }, "total": { "type": "integer" }, "sampleOfferId": { "type": [ "string", "null" ], "description": "Przykładowa aktywna oferta demo — do symulatora zamówień." } }, "required": [ "active", "total", "sampleOfferId" ] }, "shippingRates": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] } }, "required": [ "id" ], "description": "Cennik demo." }, "returnPolicy": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] } }, "required": [ "id" ] }, "impliedWarranty": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] } }, "required": [ "id" ] }, "warranty": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] } }, "required": [ "id" ] }, "responsibleProducer": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] } }, "required": [ "id" ] }, "responsiblePerson": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] } }, "required": [ "id" ] }, "simulator": { "type": "object", "properties": { "orders": { "type": "string" }, "returns": { "type": "string" }, "messages": { "type": "string" } }, "required": [ "orders", "returns", "messages" ], "description": "Trasy symulatora." } }, "required": [ "mode", "seller", "buyer", "createdAt", "dataVersion", "offers", "shippingRates", "returnPolicy", "impliedWarranty", "warranty", "responsibleProducer", "responsiblePerson", "simulator" ], "description": "Konto demo w sandboxie (identyfikatory danych przykładowych)." }, "Category": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator Allegro." }, "alleeId": { "type": "integer", "description": "Identyfikator allee." }, "name": { "type": "string" }, "parent": { "type": [ "object", "null" ], "properties": { "id": { "type": [ "string", "null" ] }, "alleeId": { "type": "integer" } }, "required": [ "id", "alleeId" ], "description": "Kategoria nadrzędna; null dla działu głównego." }, "leaf": { "type": "boolean", "description": "Czy to kategoria najniższego poziomu (tylko w liściu można wystawić ofertę)." }, "options": { "type": "object", "additionalProperties": true, "description": "Zawsze {} (zgodność z Allegro)." } }, "required": [ "id", "alleeId", "name", "parent", "leaf", "options" ], "description": "Kategoria (ścieżka Allegro)." }, "CategoryList": { "type": "object", "properties": { "categories": { "type": "array", "items": { "$ref": "#/components/schemas/Category" } } }, "required": [ "categories" ] }, "AlleeCategory": { "type": "object", "properties": { "alleeId": { "type": "integer" }, "id": { "type": [ "string", "null" ], "description": "Identyfikator Allegro (mapa 1:1)." }, "name": { "type": "string" }, "parent": { "type": [ "object", "null" ], "properties": { "alleeId": { "type": "integer" }, "id": { "type": [ "string", "null" ] } }, "required": [ "alleeId", "id" ] }, "leaf": { "type": "boolean" }, "path": { "type": "array", "items": { "type": "object", "properties": { "alleeId": { "type": "integer" }, "id": { "type": [ "string", "null" ] }, "name": { "type": "string" } }, "required": [ "alleeId", "id", "name" ] }, "description": "Ścieżka od działu głównego (tylko pojedyncza kategoria)." } }, "required": [ "alleeId", "id", "name", "parent", "leaf" ], "description": "Kategoria (ścieżka allee — po naszych identyfikatorach)." }, "AlleeCategoryList": { "type": "object", "properties": { "categories": { "type": "array", "items": { "$ref": "#/components/schemas/AlleeCategory" } } }, "required": [ "categories" ] }, "CategoryParameter": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator parametru Allegro." }, "alleeId": { "type": "integer", "description": "Identyfikator allee." }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "dictionary", "integer", "float", "string" ] }, "required": { "type": "boolean", "description": "Wymagany w tej kategorii." }, "requiredForProduct": { "type": "boolean", "description": "Zawsze false (allee nie ma kart produktów)." }, "unit": { "type": [ "string", "null" ], "description": "Jednostka, np. kg." }, "options": { "type": "object", "properties": { "customValuesEnabled": { "type": "boolean", "description": "Zawsze false — tylko wartości ze słownika." }, "ambiguousValueId": { "type": [ "string", "null" ] } }, "required": [ "customValuesEnabled", "ambiguousValueId" ] }, "restrictions": { "type": "object", "properties": { "multipleChoices": { "type": "boolean", "description": "Czy wolno wybrać kilka wartości słownika." }, "minLength": { "type": "integer" }, "maxLength": { "type": "integer" }, "allowedNumberOfValues": { "type": "integer" }, "min": { "type": "number" }, "max": { "type": "number" }, "range": { "type": "boolean", "description": "Zawsze false (zakresy nieobsługiwane)." }, "precision": { "type": "integer", "description": "Miejsca po przecinku (float)." } }, "description": "Ograniczenia wartości (sprawdzane przy zapisie oferty)." }, "dictionary": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator wartości Allegro." }, "alleeId": { "type": "integer" }, "value": { "type": "string" }, "dependsOnValueIds": { "type": "array", "items": { "type": "string" }, "description": "Przekazujemy jak Allegro, nie sprawdzamy przy zapisie." }, "options": { "type": "object", "properties": { "alleeSupported": { "type": "boolean", "description": "Parametr Stan: czy allee przyjmuje tę wartość." } }, "required": [ "alleeSupported" ] } }, "required": [ "id", "alleeId", "value", "dependsOnValueIds" ] }, "description": "Wartości słownika (typ dictionary)." } }, "required": [ "id", "alleeId", "name", "type", "required", "requiredForProduct", "unit", "options", "restrictions" ], "description": "Parametr kategorii (kształt Allegro + alleeId)." }, "CategoryParameterList": { "type": "object", "properties": { "parameters": { "type": "array", "items": { "$ref": "#/components/schemas/CategoryParameter" } } }, "required": [ "parameters" ] }, "CategorySchema": { "type": "object", "properties": { "category": { "type": "object", "properties": { "alleeId": { "type": "integer" }, "id": { "type": [ "string", "null" ] }, "name": { "type": "string" } }, "required": [ "alleeId", "id", "name" ] }, "requirements": { "type": "string", "enum": [ "LISTING", "LISTING_OFFER_ONLY" ], "description": "LISTING = pełna oferta, LISTING_OFFER_ONLY = tylko dane sprzedażowe istniejącego SKU." }, "metaSchema": { "type": "object", "properties": { "link": { "type": "object", "properties": { "resource": { "type": "string", "description": "Adres meta-schematu JSON Schema 2020-12." }, "verb": { "type": "string", "enum": [ "GET" ] } }, "required": [ "resource", "verb" ] } }, "required": [ "link" ] }, "schema": { "type": "object", "additionalProperties": true, "description": "JSON Schema 2020-12 treści PUT /allee/listings/{sku} dla tej kategorii: properties.attributes opisuje atrybuty, parameters — parametry kategorii (klucz = id parametru Allegro, enum wartości słownika, x-allee: alleeId, typ, jednostka)." }, "meta": { "type": "object", "properties": { "version": { "type": "string", "description": "Skrót wersji schematu — zmienia się, gdy zmieni się kategoria lub jej parametry (ETag)." }, "generatedAt": { "type": "string", "format": "date-time" } }, "required": [ "version", "generatedAt" ] }, "propertyGroups": { "type": "object", "additionalProperties": { "type": "object", "properties": { "title": { "type": "string" }, "propertyNames": { "type": "array", "items": { "type": "string" } } }, "required": [ "title", "propertyNames" ] }, "description": "Grupy atrybutów do formularzy (produkt, oferta, warunki, GPSR)." } }, "required": [ "category", "requirements", "metaSchema", "schema", "meta", "propertyGroups" ], "description": "Schemat atrybutów oferty kategorii (Amazon Product Type Definitions). Walidujesz u siebie, zanim wyślesz." }, "MatchingCategoryList": { "type": "object", "properties": { "matchingCategories": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "alleeId": { "type": "integer" }, "name": { "type": "string" }, "leaf": { "type": "boolean" }, "parent": { "anyOf": [ { "$ref": "#/components/schemas/MatchingCategoryParent" }, { "type": "null" } ] }, "allee": { "type": "object", "properties": { "score": { "type": "number", "description": "Trafność dopasowania (większa = lepsza)." } }, "required": [ "score" ] } }, "required": [ "id", "alleeId", "name", "leaf", "parent", "allee" ] } } }, "required": [ "matchingCategories" ], "description": "Podpowiedzi kategorii dla nazwy produktu (najlepsze pierwsze)." }, "MatchingCategoryParent": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "alleeId": { "type": "integer" }, "name": { "type": "string" }, "leaf": { "type": "boolean" }, "parent": { "anyOf": [ { "$ref": "#/components/schemas/MatchingCategoryParent" }, { "type": "null" } ] } }, "required": [ "id", "alleeId", "name", "leaf", "parent" ], "description": "Kategoria nadrzędna (rekurencyjnie do działu)." }, "CategoryEventList": { "type": "object", "properties": { "categoryEvents": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Kursor zdarzenia (do parametru from)." }, "type": { "type": "string", "enum": [ "CATEGORY_CREATED", "CATEGORY_RENAMED", "CATEGORY_MOVED", "CATEGORY_DELETED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "category": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "alleeId": { "type": "integer" }, "name": { "type": "string" }, "parent": { "type": [ "object", "null" ], "properties": { "id": { "type": [ "string", "null" ] }, "alleeId": { "type": "integer" } }, "required": [ "id", "alleeId" ] } }, "required": [ "id", "alleeId" ], "additionalProperties": true }, "redirectCategory": { "type": [ "object", "null" ], "properties": { "id": { "type": [ "string", "null" ] }, "alleeId": { "type": "integer" } }, "required": [ "id", "alleeId" ], "description": "Kategoria zastępcza (przy usunięciu).", "additionalProperties": true } }, "required": [ "id", "type", "occurredAt", "category" ], "additionalProperties": true } } }, "required": [ "categoryEvents" ], "description": "Zmiany w drzewie kategorii (Allegro GET /sale/category-events)." }, "ProductList": { "type": "object", "properties": { "products": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Zawsze pusta — allee nie prowadzi katalogu produktów; wystawiaj z pełnymi danymi produktu." } }, "required": [ "products" ] }, "DeliveryMethod": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator metody (UUID allee, stały).", "format": "uuid" }, "name": { "type": "string" }, "paymentPolicy": { "type": "string", "enum": [ "IN_ADVANCE", "CASH_ON_DELIVERY" ], "description": "Przedpłata albo pobranie." }, "allee": { "type": "object", "properties": { "carrierId": { "type": "string", "description": "Kod przewoźnika — ten sam co w POST …/shipments.", "examples": [ "INPOST" ] } }, "required": [ "carrierId" ] } }, "required": [ "id", "name", "paymentPolicy", "allee" ], "description": "Metoda dostawy (słownik allee)." }, "DeliveryMethodList": { "type": "object", "properties": { "deliveryMethods": { "type": "array", "items": { "$ref": "#/components/schemas/DeliveryMethod" } } }, "required": [ "deliveryMethods" ] }, "ShippingRateItem": { "type": "object", "properties": { "deliveryMethod": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "required": [ "id" ] }, "maxQuantityPerPackage": { "type": "integer", "description": "Sztuk w jednej paczce (1–9999)." }, "firstItemRate": { "$ref": "#/components/schemas/Money", "description": "Koszt pierwszej sztuki." }, "nextItemRate": { "$ref": "#/components/schemas/Money", "description": "Koszt każdej kolejnej sztuki." } }, "required": [ "deliveryMethod", "maxQuantityPerPackage", "firstItemRate", "nextItemRate" ] }, "ShippingRates": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "PHYSICAL" ] }, "rates": { "type": "array", "items": { "$ref": "#/components/schemas/ShippingRateItem" } }, "lastModified": { "type": "string", "format": "date-time" }, "allee": { "type": "object", "properties": { "freeDeliveryFrom": { "$ref": "#/components/schemas/Money", "description": "Próg darmowej dostawy." } }, "required": [ "freeDeliveryFrom" ], "description": "Rozszerzenie allee (S2) — tylko gdy ustawiono próg." } }, "required": [ "id", "name", "type", "rates", "lastModified" ], "description": "Cennik dostawy." }, "ShippingRatesInput": { "type": "object", "properties": { "name": { "type": "string", "description": "1–100 znaków, unikalna w obrębie sprzedawcy.", "minLength": 1, "maxLength": 100 }, "type": { "type": "string", "enum": [ "PHYSICAL" ], "description": "Wymagane: PHYSICAL." }, "rates": { "type": "array", "items": { "type": "object", "properties": { "deliveryMethod": { "type": "object", "properties": { "id": { "type": "string", "description": "UUID z GET /sale/delivery-methods." }, "name": { "type": "string", "description": "Albo dokładna nazwa metody (bez względu na wielkość liter)." } } }, "maxQuantityPerPackage": { "type": "integer", "description": "1–9999, domyślnie 1.", "minimum": 1, "maximum": 9999 }, "firstItemRate": { "$ref": "#/components/schemas/MoneyInput" }, "nextItemRate": { "$ref": "#/components/schemas/MoneyInput" } }, "required": [ "deliveryMethod", "firstItemRate" ] }, "description": "Co najmniej jedna metoda; każda najwyżej raz.", "minItems": 1 }, "allee": { "type": "object", "properties": { "freeDeliveryFrom": { "anyOf": [ { "$ref": "#/components/schemas/MoneyInput" }, { "type": "null" } ] } }, "description": "Rozszerzenie allee (S2): próg darmowej dostawy; null = bez progu, pominięte = bez zmian." } }, "required": [ "name", "type", "rates" ], "description": "Cennik dostawy w żądaniu (POST/PUT)." }, "ShippingRatesList": { "type": "object", "properties": { "shippingRates": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } } }, "required": [ "shippingRates" ] }, "ReturnPolicy": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "availability": { "type": "object", "properties": { "range": { "type": "string", "enum": [ "FULL", "RESTRICTED", "DISABLED" ] }, "restrictionCause": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 100 }, "description": { "type": "string", "maxLength": 2000 } } } } }, "withdrawalPeriod": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "returnCost": { "type": "object", "properties": { "coveredBy": { "type": "string", "enum": [ "SELLER", "BUYER" ] } } }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "contact": { "type": "object", "properties": { "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } } }, "options": { "type": "object", "properties": { "cashOnDeliveryNotAllowed": { "type": "boolean" }, "freeAccessoriesReturnRequired": { "type": "boolean" }, "refundLoweredByReceivedDiscount": { "type": "boolean" }, "businessReturnAllowed": { "type": "boolean" }, "collectBySellerOnly": { "type": "boolean" } } }, "description": { "type": "string", "maxLength": 5000 } }, "required": [ "id", "name" ], "description": "Warunki zwrotów (pola Allegro z białej listy)." }, "ImpliedWarranty": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "individual": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "corporate": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "description": { "type": "string", "maxLength": 5000 } }, "required": [ "id", "name" ], "description": "Warunki reklamacji (rękojmia)." }, "Warranty": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] }, "individual": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "corporate": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "attachment": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "url": { "type": "string", "description": "Adres https.", "format": "uri" } } }, "description": { "type": "string", "maxLength": 5000 } }, "required": [ "id", "name" ], "description": "Gwarancja." }, "ReturnPolicyInput": { "type": "object", "properties": { "name": { "type": "string", "description": "1–100 znaków, unikalna w obrębie sprzedawcy.", "minLength": 1, "maxLength": 100 }, "availability": { "type": "object", "properties": { "range": { "type": "string", "enum": [ "FULL", "RESTRICTED", "DISABLED" ] }, "restrictionCause": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 100 }, "description": { "type": "string", "maxLength": 2000 } } } } }, "withdrawalPeriod": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "returnCost": { "type": "object", "properties": { "coveredBy": { "type": "string", "enum": [ "SELLER", "BUYER" ] } } }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "contact": { "type": "object", "properties": { "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } } }, "options": { "type": "object", "properties": { "cashOnDeliveryNotAllowed": { "type": "boolean" }, "freeAccessoriesReturnRequired": { "type": "boolean" }, "refundLoweredByReceivedDiscount": { "type": "boolean" }, "businessReturnAllowed": { "type": "boolean" }, "collectBySellerOnly": { "type": "boolean" } } }, "description": { "type": "string", "maxLength": 5000 } }, "required": [ "name" ], "description": "Warunki zwrotów w żądaniu. Pola z białej listy Allegro: w POST pola spoza listy są pomijane (nie zapisujemy ich), w PUT → 422 UnknownJSONProperty; wartości sprawdzane (okres ISO 8601, kod kraju, e-mail, https)." }, "ImpliedWarrantyInput": { "type": "object", "properties": { "name": { "type": "string", "description": "1–100 znaków, unikalna.", "minLength": 1, "maxLength": 100 }, "individual": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "corporate": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "description": { "type": "string", "maxLength": 5000 } }, "required": [ "name" ], "description": "Warunki reklamacji w żądaniu. Pola z białej listy Allegro: w POST pola spoza listy są pomijane (nie zapisujemy ich), w PUT → 422 UnknownJSONProperty; wartości sprawdzane (okres ISO 8601, kod kraju, e-mail, https)." }, "WarrantyInput": { "type": "object", "properties": { "name": { "type": "string", "description": "1–100 znaków, unikalna.", "minLength": 1, "maxLength": 100 }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] }, "individual": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "corporate": { "type": "object", "properties": { "period": { "type": "string", "description": "Okres ISO 8601, np. P14D, P1Y, P2Y.", "pattern": "^P(?=[0-9])([0-9]{1,3}Y)?([0-9]{1,3}M)?([0-9]{1,3}W)?([0-9]{1,4}D)?$" }, "lifetime": { "type": "boolean", "description": "Dożywotnio." }, "type": { "type": "string", "enum": [ "MANUFACTURER", "SELLER" ] } } }, "attachment": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "url": { "type": "string", "description": "Adres https.", "format": "uri" } } }, "description": { "type": "string", "maxLength": 5000 } }, "required": [ "name" ], "description": "Gwarancja w żądaniu. Pola z białej listy Allegro: w POST pola spoza listy są pomijane (nie zapisujemy ich), w PUT → 422 UnknownJSONProperty; wartości sprawdzane (okres ISO 8601, kod kraju, e-mail, https)." }, "ReturnPolicyList": { "type": "object", "properties": { "returnPolicies": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "count": { "type": "integer" } }, "required": [ "returnPolicies", "count" ] }, "ImpliedWarrantyList": { "type": "object", "properties": { "impliedWarranties": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "count": { "type": "integer" } }, "required": [ "impliedWarranties", "count" ] }, "WarrantyList": { "type": "object", "properties": { "warranties": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" } }, "required": [ "id", "name" ] } }, "count": { "type": "integer" } }, "required": [ "warranties", "count" ] }, "ResponsibleProducer": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string", "description": "Nazwa wpisu u sprzedawcy (1–50 znaków)." }, "producerData": { "type": "object", "properties": { "tradeName": { "type": "string", "description": "Nazwa handlowa producenta." }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "contact": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "phoneNumber": { "type": "string", "maxLength": 30 }, "formUrl": { "type": "string", "description": "Adres https formularza kontaktowego.", "format": "uri" } }, "description": "Dane kontaktowe." } }, "description": "Dane producenta." } }, "required": [ "id", "name", "producerData" ], "description": "Producent odpowiedzialny (GPSR)." }, "ResponsibleProducerInput": { "type": "object", "properties": { "name": { "type": "string", "description": "1–50 znaków, unikalna.", "maxLength": 50 }, "producerData": { "type": "object", "properties": { "tradeName": { "type": "string", "description": "Wymagane (do 200 znaków).", "maxLength": 200 }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "contact": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "phoneNumber": { "type": "string", "maxLength": 30 }, "formUrl": { "type": "string", "description": "Adres https formularza kontaktowego.", "format": "uri" } }, "description": "Dane kontaktowe." } }, "required": [ "tradeName" ] } }, "required": [ "name", "producerData" ], "description": "Producent w żądaniu. Pola z białej listy Allegro: w POST pola spoza listy są pomijane (nie zapisujemy ich), w PUT → 422 UnknownJSONProperty; wartości sprawdzane (okres ISO 8601, kod kraju, e-mail, https)." }, "ResponsibleProducerList": { "type": "object", "properties": { "responsibleProducers": { "type": "array", "items": { "$ref": "#/components/schemas/ResponsibleProducer" } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "responsibleProducers", "count", "totalCount" ] }, "ResponsiblePerson": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "personalData": { "type": "object", "properties": { "name": { "type": "string", "description": "Nazwa podmiotu odpowiedzialnego w UE." }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "contact": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "phoneNumber": { "type": "string", "maxLength": 30 }, "formUrl": { "type": "string", "description": "Adres https formularza kontaktowego.", "format": "uri" } }, "description": "Dane kontaktowe." } }, "description": "Dane osoby odpowiedzialnej." } }, "required": [ "id", "name", "personalData" ], "description": "Osoba odpowiedzialna w UE (GPSR)." }, "ResponsiblePersonInput": { "type": "object", "properties": { "name": { "type": "string", "description": "1–50 znaków, unikalna.", "maxLength": 50 }, "personalData": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "address": { "type": "object", "properties": { "name": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 200 }, "postCode": { "type": "string", "maxLength": 20 }, "postalCode": { "type": "string", "maxLength": 20 }, "city": { "type": "string", "maxLength": 100 }, "countryCode": { "type": "string", "description": "Kod kraju ISO 3166-1 alfa-2.", "pattern": "^[A-Z]{2}$", "examples": [ "PL" ] }, "phoneNumber": { "type": "string", "maxLength": 30 }, "email": { "type": "string", "format": "email" } }, "description": "Adres (kształt Allegro)." }, "contact": { "type": "object", "properties": { "email": { "type": "string", "format": "email" }, "phoneNumber": { "type": "string", "maxLength": 30 }, "formUrl": { "type": "string", "description": "Adres https formularza kontaktowego.", "format": "uri" } }, "description": "Dane kontaktowe." } } } }, "required": [ "name", "personalData" ], "description": "Osoba odpowiedzialna w żądaniu. Pola z białej listy Allegro: w POST pola spoza listy są pomijane (nie zapisujemy ich), w PUT → 422 UnknownJSONProperty; wartości sprawdzane (okres ISO 8601, kod kraju, e-mail, https)." }, "ResponsiblePersonList": { "type": "object", "properties": { "responsiblePersons": { "type": "array", "items": { "$ref": "#/components/schemas/ResponsiblePerson" } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "responsiblePersons", "count", "totalCount" ] }, "OfferParameter": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator parametru Allegro." }, "alleeId": { "type": "integer" }, "name": { "type": "string" }, "valuesIds": { "type": "array", "items": { "type": "string" }, "description": "Identyfikatory wartości słownika Allegro (puste dla parametrów liczbowych/tekstowych)." }, "alleeValuesIds": { "type": "array", "items": { "type": "integer" }, "description": "Identyfikatory wartości allee (tylko słownikowe)." }, "values": { "type": "array", "items": { "type": "string" }, "description": "Wartości tekstowo." }, "rangeValue": { "anyOf": [ {}, { "type": "null" } ], "description": "Zawsze null (zakresy nieobsługiwane)." } }, "required": [ "id", "alleeId", "name", "valuesIds", "values", "rangeValue" ], "description": "Parametr oferty w odpowiedzi." }, "OfferParameterInput": { "type": "object", "properties": { "id": { "type": "string", "description": "Id parametru Allegro." }, "alleeId": { "type": [ "integer", "string" ], "description": "Id parametru allee." }, "name": { "type": "string", "description": "Albo nazwa parametru w kategorii (bez względu na wielkość liter)." }, "valuesIds": { "type": "array", "items": { "type": "string" } }, "alleeValuesIds": { "type": "array", "items": { "type": [ "integer", "string" ] } }, "values": { "type": "array", "items": { "type": [ "string", "number" ] }, "description": "Tekst (słownik dopasowywany bez względu na wielkość liter), liczba albo tekst." }, "rangeValue": { "description": "Nieobsługiwane → 422 ConstraintViolationException.RangeValueNotSupported." } }, "description": "Parametr w żądaniu: wskaż parametr przez alleeId, id albo name (pierwsze pasujące wygrywa)." }, "ProductOffer": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator oferty." }, "name": { "type": "string", "description": "Tytuł oferty." }, "category": { "$ref": "#/components/schemas/CategoryRef" }, "productSet": { "type": "array", "items": { "type": "object", "properties": { "product": { "type": "object", "properties": { "name": { "type": "string" }, "category": { "$ref": "#/components/schemas/CategoryRef" }, "parameters": { "type": "array", "items": { "$ref": "#/components/schemas/OfferParameter" }, "description": "Parametry produktu (bez Stanu)." }, "images": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "Zdjęcia po przetworzeniu (cdn.allee.pl, WebP 1200 px)." } }, "required": [ "name", "category", "parameters", "images" ] }, "responsibleProducer": { "type": [ "object", "null" ], "properties": { "type": { "type": "string", "enum": [ "ID" ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "type", "id" ], "description": "Producent GPSR." }, "responsiblePerson": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ], "description": "Osoba odpowiedzialna GPSR." }, "safetyInformation": { "anyOf": [ { "$ref": "#/components/schemas/SafetyInformation" }, { "type": "null" } ] } }, "required": [ "product", "responsibleProducer", "responsiblePerson", "safetyInformation" ] }, "description": "Zawsze dokładnie 1 element.", "minItems": 1, "maxItems": 1 }, "parameters": { "type": "array", "items": { "$ref": "#/components/schemas/OfferParameter" }, "description": "Parametry oferty — tu jest Stan (11323)." }, "sellingMode": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "BUY_NOW", "AUCTION" ], "description": "Oferty przez API: BUY_NOW (licytacje tylko z panelu)." }, "price": { "$ref": "#/components/schemas/Money" } }, "required": [ "format", "price" ] }, "stock": { "type": "object", "properties": { "available": { "type": "integer", "description": "Dostępne sztuki (0–99 999)." }, "unit": { "type": "string", "enum": [ "UNIT" ] } }, "required": [ "available", "unit" ] }, "publication": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/PublicationStatus" }, "endedBy": { "type": [ "string", "null" ], "enum": [ "USER", "EMPTY_STOCK", "ADMIN", "EXPIRATION", null ], "description": "Kto zakończył (tylko przy ENDED)." } }, "required": [ "status", "endedBy" ] }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": "string", "description": "SKU sprzedawcy (unikalne na koncie)." } }, "required": [ "id" ] }, "delivery": { "type": "object", "properties": { "handlingTime": { "type": [ "string", "null" ], "enum": [ "PT0S", "PT24H", "P2D", "P3D", "P4D", "P5D", "P7D", "P10D", "P14D", "P21D", "P30D", "P60D", null ], "description": "Czas wysyłki." }, "shippingRates": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ], "description": "Cennik dostawy." } }, "required": [ "handlingTime", "shippingRates" ] }, "afterSalesServices": { "type": "object", "properties": { "returnPolicy": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "warranty": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "impliedWarranty": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] } }, "required": [ "returnPolicy", "warranty", "impliedWarranty" ] }, "taxSettings": { "type": [ "object", "null" ], "properties": { "rates": { "type": "array", "items": { "type": "object", "properties": { "rate": { "type": "string", "enum": [ "0.00", "5.00", "8.00", "23.00" ] }, "countryCode": { "type": "string", "enum": [ "PL" ] } }, "required": [ "rate", "countryCode" ] } } }, "required": [ "rates" ], "description": "Stawka VAT." }, "payments": { "type": "object", "properties": { "invoice": { "type": [ "string", "null" ], "enum": [ "VAT", "VAT_MARGIN", "WITHOUT_VAT", "NO_INVOICE", null ], "description": "Rodzaj dokumentu sprzedaży." } }, "required": [ "invoice" ] }, "images": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "To samo co productSet[0].product.images." }, "description": { "$ref": "#/components/schemas/OfferDescription" }, "location": { "type": [ "object", "null" ], "additionalProperties": true, "description": "Lokalizacja (zapisana 1:1, zwykle city, countryCode, postCode, province)." }, "validation": { "type": "object", "properties": { "errors": { "type": "array", "items": { "$ref": "#/components/schemas/Error" }, "description": "Prawdziwe problemy oferty, np. nieudane zdjęcia; puste = brak problemów." }, "warnings": { "type": "array", "items": { "$ref": "#/components/schemas/Error" }, "description": "Tylko w odpowiedzi POST/PATCH: co allee dopasowało zamiast odrzucić (np. czas wysyłki zaokrąglony w górę, parametr jednowartościowy obcięty do pierwszej wartości). W GET puste." } }, "required": [ "errors", "warnings" ] }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" }, "allee": { "type": "object", "properties": { "url": { "type": "string", "description": "Adres oferty na allee.pl.", "format": "uri" }, "endedReason": { "type": [ "string", "null" ], "description": "Powód zakończenia nadany przez allee (np. R2 = 0 sztuk)." }, "imagesPending": { "type": "integer", "description": "Zdjęcia czekające na pobranie przez allee." }, "categorySource": { "type": "string", "enum": [ "allegro", "allee", "allee (podano obie — allee ma pierwszeństwo)" ], "description": "Tylko w odpowiedzi POST: która kategoria została użyta." } }, "required": [ "url", "endedReason", "imagesPending" ], "description": "Rozszerzenie allee." } }, "required": [ "id", "name", "category", "productSet", "parameters", "sellingMode", "stock", "publication", "external", "delivery", "afterSalesServices", "taxSettings", "payments", "images", "description", "location", "validation", "createdAt", "updatedAt", "allee" ], "description": "Oferta (kształt Allegro /sale/product-offers)." }, "PublicationStatus": { "type": "string", "enum": [ "INACTIVE", "ACTIVATING", "ACTIVE", "ENDED" ], "description": "INACTIVE = szkic, ACTIVATING = czeka na zdjęcia, ACTIVE = widoczna i kupowalna, ENDED = zakończona." }, "SafetyInformation": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "TEXT", "NO_SAFETY_INFORMATION", "ATTACHMENTS" ] }, "description": { "type": "string", "description": "Treść informacji (dla TEXT)." } }, "required": [ "type" ], "description": "Informacje o bezpieczeństwie produktu (GPSR).", "additionalProperties": true }, "OfferDescription": { "type": "object", "properties": { "sections": { "type": "array", "items": { "type": "object", "properties": { "items": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "TEXT", "IMAGE" ] }, "content": { "type": "string", "description": "HTML (TEXT)." }, "url": { "type": "string", "description": "Adres obrazka (IMAGE — pomijany)." } }, "required": [ "type" ] } } }, "required": [ "items" ] } } }, "required": [ "sections" ], "description": "Opis w sekcjach Allegro. allee zapisuje go jako tekst (znaczniki formatowania, skrypty i style znikają); odczyt zwraca jedną sekcję TEXT z odtworzonym prostym HTML: akapity

i
, a nagłówek tuż przed listą wraca jako

+
  • . Nie porównuj opisu 1:1 z wysłanym." }, "ProductOfferInput": { "type": "object", "properties": { "productSet": { "type": "array", "items": { "type": "object", "properties": { "product": { "type": "object", "properties": { "name": { "type": "string", "description": "Tytuł: 10–75 znaków, żadne słowo dłuższe niż 30 znaków." }, "category": { "type": "object", "properties": { "id": { "type": "string", "description": "Id kategorii Allegro." }, "alleeId": { "type": [ "integer", "string" ], "description": "Id allee — gdy podano oba, wygrywa alleeId." } } }, "parameters": { "type": "array", "items": { "$ref": "#/components/schemas/OfferParameterInput" } }, "images": { "type": "array", "items": { "anyOf": [ { "type": "string", "format": "uri" }, { "type": "object", "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] } ] }, "description": "1–16 adresów https: lista tekstów albo obiektów {url} (jak w odczycie Allegro).", "maxItems": 16 }, "id": { "type": "string", "description": "Karta produktu Allegro — pomijana; samo id bez danych → 422 CATALOG_PRODUCT_NOT_SUPPORTED." } } }, "responsibleProducer": { "type": [ "object", "null" ], "properties": { "type": { "type": "string", "enum": [ "ID" ] }, "id": { "type": "string", "format": "uuid" } }, "required": [ "type", "id" ] }, "responsiblePerson": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "safetyInformation": { "anyOf": [ { "$ref": "#/components/schemas/SafetyInformation" }, { "type": "null" } ] } }, "required": [ "product" ] }, "description": "Dokładnie 1 element.", "minItems": 1, "maxItems": 1 }, "parameters": { "type": "array", "items": { "$ref": "#/components/schemas/OfferParameterInput" }, "description": "Parametry oferty (Stan 11323 — przyjmowany w każdej kategorii)." }, "sellingMode": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "BUY_NOW" ] }, "price": { "$ref": "#/components/schemas/MoneyInput" } }, "description": "Cena wymagana: 1,00–10 000 000,00 zł." }, "stock": { "type": "object", "properties": { "available": { "type": [ "integer", "string" ], "description": "0–99 999 (przy POST co najmniej 1)." }, "unit": { "type": "string", "enum": [ "UNIT" ] } } }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": [ "string", "integer" ], "description": "SKU (do 100 znaków), unikalne na koncie — dubel → 409 OfferDuplicate." } } }, "description": { "$ref": "#/components/schemas/OfferDescription" }, "publication": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ACTIVE", "INACTIVE" ], "description": "Tylko w POST; brak = INACTIVE (szkic)." } }, "additionalProperties": true }, "delivery": { "type": "object", "properties": { "handlingTime": { "type": [ "string", "null" ], "description": "Czas ISO 8601 do 60 dni, np. PT24H, P3D, PT72H (jak w odczycie Allegro). Zapisywany jako jedna z wartości PT0S, PT24H, P2D, P3D, P4D, P5D, P7D, P10D, P14D, P21D, P30D, P60D; wartość pośrednia — w górę, z ostrzeżeniem w validation.warnings." }, "shippingRates": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ], "description": "Twój cennik — wymagany w POST." }, "additionalInfo": { "description": "Bez skutku." }, "shipmentDate": { "description": "Bez skutku." } } }, "afterSalesServices": { "type": "object", "properties": { "returnPolicy": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "warranty": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "impliedWarranty": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] } } }, "taxSettings": { "type": [ "object", "null" ], "properties": { "rates": { "type": "array", "items": { "type": "object", "properties": { "rate": { "type": "string", "enum": [ "0.00", "5.00", "8.00", "23.00" ], "description": "Tekst, nie liczba." }, "countryCode": { "type": "string" } }, "required": [ "rate" ] } } }, "required": [ "rates" ] }, "payments": { "type": "object", "properties": { "invoice": { "type": [ "string", "null" ], "enum": [ "VAT", "VAT_MARGIN", "WITHOUT_VAT", "NO_INVOICE", null ] } } }, "location": { "type": [ "object", "null" ], "additionalProperties": true, "description": "Do 300 znaków JSON." }, "images": { "type": "array", "items": { "type": "string" }, "description": "Alternatywnie zdjęcia na wierzchu." }, "category": { "type": "object", "properties": { "id": { "type": "string" }, "alleeId": { "type": [ "integer", "string" ] } }, "description": "Alternatywnie kategoria na wierzchu." }, "name": { "type": "string", "description": "Tytuł oferty (jak Allegro) — w POST i PATCH; ma pierwszeństwo przed productSet[0].product.name." }, "id": { "description": "Tylko do odczytu — pomijane." }, "validation": { "description": "Tylko do odczytu — pomijane." }, "warnings": { "description": "Tylko do odczytu — pomijane." }, "createdAt": { "description": "Tylko do odczytu — pomijane." }, "updatedAt": { "description": "Tylko do odczytu — pomijane." }, "aiCoCreatedContent": { "description": "Tylko do odczytu — pomijane." }, "allee": { "description": "Tylko do odczytu — pomijane." }, "language": { "description": "Przyjmowane bez skutku." }, "additionalMarketplaces": { "description": "Bez skutku." }, "b2b": { "description": "Bez skutku." }, "discounts": { "description": "Bez skutku." }, "compatibilityList": { "description": "Bez skutku." }, "tecdocSpecification": { "description": "Bez skutku." }, "contact": { "description": "Bez skutku." }, "messageToSellerSettings": { "description": "Bez skutku." }, "attachments": { "description": "Bez skutku." }, "fundraisingCampaign": { "description": "Bez skutku." }, "additionalServices": { "description": "Bez skutku." }, "sizeTable": { "description": "Bez skutku." }, "promotion": { "description": "Bez skutku." } }, "required": [ "productSet" ], "description": "Oferta w żądaniu (kształt Allegro). Można wysłać przepisany odczyt GET (allee albo Allegro): pola tylko do odczytu są pomijane, a w PATCH także niezmienione publication i images. Inne nieznane pola na wierzchu → 422 UnknownJSONProperty." }, "ValidationResult": { "type": "object", "properties": { "validateOnly": { "type": "boolean", "enum": [ true ], "description": "Odpowiedź podglądu — nic nie zapisano." }, "status": { "type": "string", "enum": [ "VALID", "INVALID" ] }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ListingIssue" } }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/Error" }, "description": "Przy INVALID: te same błędy co przy prawdziwym zapisie." } }, "required": [ "validateOnly", "status", "issues" ], "description": "Wynik validateOnly=true (rozszerzenie allee)." }, "OfferListItem": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "category": { "$ref": "#/components/schemas/CategoryRef" }, "primaryImage": { "type": [ "object", "null" ], "properties": { "url": { "type": "string", "format": "uri" } }, "required": [ "url" ] }, "sellingMode": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "BUY_NOW", "AUCTION" ] }, "price": { "$ref": "#/components/schemas/Money" } }, "required": [ "format", "price" ] }, "stock": { "type": "object", "properties": { "available": { "type": "integer" }, "sold": { "type": "integer", "description": "Sprzedane w ostatnich 30 dniach (bez anulowanych i zwróconych)." } }, "required": [ "available", "sold" ] }, "publication": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/PublicationStatus" }, "endedBy": { "type": [ "string", "null" ], "enum": [ "USER", "EMPTY_STOCK", "ADMIN", "EXPIRATION", null ] } }, "required": [ "status", "endedBy" ] }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" } }, "required": [ "id" ] } }, "required": [ "id", "name", "category", "primaryImage", "sellingMode", "stock", "publication", "external" ], "description": "Oferta na liście." }, "OfferList": { "type": "object", "properties": { "offers": { "type": "array", "items": { "$ref": "#/components/schemas/OfferListItem" } }, "count": { "type": "integer", "description": "Ofert na tej stronie." }, "totalCount": { "type": "integer", "description": "Wszystkich pasujących." } }, "required": [ "offers", "count", "totalCount" ] }, "Buyability": { "type": "object", "properties": { "buyable": { "type": "boolean", "description": "Czy oferta da się teraz kupić." }, "problems": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "OFFER_NOT_ACTIVE", "OUT_OF_STOCK", "RESPONSIBLE_PRODUCER_NOT_SPECIFIED", "SAFETY_INFO_NOT_DEFINED", "SHIPPING_RATES_NOT_FOUND", "DELIVERY_NOT_CONFIGURED" ] }, "message": { "type": "string" } }, "required": [ "code", "message" ] } } }, "required": [ "buyable", "problems" ], "description": "Kupowalność oferty (rozszerzenie allee)." }, "UnfilledParametersList": { "type": "object", "properties": { "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "parameters": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "alleeId": { "type": "integer" }, "name": { "type": "string" }, "required": { "type": "boolean" } }, "required": [ "id", "alleeId", "name", "required" ] } } }, "required": [ "id", "parameters" ] } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "offers", "count", "totalCount" ], "description": "Oferty z nieuzupełnionymi parametrami kategorii (Allegro GET /sale/offers/unfilled-parameters)." }, "OfferVariantSetInput": { "type": "object", "properties": { "name": { "type": "string", "description": "Nazwa zestawu (1–50 znaków).", "minLength": 1, "maxLength": 50, "examples": [ "Buty biegowe X — rozmiary" ] }, "parameters": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Id parametru Allegro (np. „54” = Rozmiar) albo „color/pattern”.", "examples": [ "54" ] }, "alleeId": { "type": "integer", "description": "Rozszerzenie allee: id parametru allee." } } }, "description": "Parametry wyboru (1–2).", "minItems": 1, "maxItems": 2 }, "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator oferty." }, "colorPattern": { "type": [ "string", "null" ], "description": "Kolor/wzór oferty (gdy parametr color/pattern), ≤ 64 znaki.", "maxLength": 64 } }, "required": [ "id" ] }, "description": "Oferty-warianty (2–500), w kolejności wyświetlania.", "minItems": 2, "maxItems": 500 } }, "required": [ "name", "parameters", "offers" ], "description": "Zestaw wariantów — ciało PUT/POST (Allegro)." }, "OfferVariantSet": { "type": "object", "properties": { "id": { "type": "string", "description": "setId (UUID).", "format": "uuid" }, "name": { "type": "string" }, "parameters": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Id parametru Allegro albo „color/pattern”." } }, "required": [ "id" ] } }, "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "colorPattern": { "type": [ "string", "null" ] } }, "required": [ "id", "colorPattern" ] } }, "allee": { "type": "object", "properties": { "setId": { "type": "integer", "description": "Numer wewnętrzny zestawu." }, "category": { "type": "object", "properties": { "id": { "type": [ "string", "null" ], "description": "Kategoria Allegro." }, "alleeId": { "type": "integer", "description": "Kategoria allee." } }, "required": [ "id", "alleeId" ] }, "parameters": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "alleeId": { "type": "integer", "description": "0 = color/pattern." }, "name": { "type": [ "string", "null" ] } }, "required": [ "id", "alleeId", "name" ] } }, "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "values": { "type": "array", "items": { "type": "object", "properties": { "parameterId": { "type": "string" }, "name": { "type": [ "string", "null" ] }, "value": { "type": "string", "description": "Wartość wyboru oferty (np. 42)." }, "valueId": { "type": [ "string", "null" ], "description": "Id wartości słownika Allegro." } }, "required": [ "parameterId", "name", "value", "valueId" ] } }, "publication": { "type": "object", "properties": { "status": { "anyOf": [ { "$ref": "#/components/schemas/PublicationStatus" }, { "type": "null" } ] } }, "required": [ "status" ] }, "stock": { "type": "object", "properties": { "available": { "type": [ "integer", "null" ] } }, "required": [ "available" ] }, "sellingMode": { "type": [ "object", "null" ], "properties": { "price": { "$ref": "#/components/schemas/Money" } }, "required": [ "price" ] }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" } }, "required": [ "id" ] }, "url": { "type": [ "string", "null" ], "description": "Strona oferty-wariantu na allee.pl.", "format": "uri" } }, "required": [ "id", "values", "publication", "stock", "sellingMode", "external", "url" ] } }, "createdAt": { "type": "string", "format": "date-time" }, "updatedAt": { "type": "string", "format": "date-time" } }, "required": [ "setId", "category", "parameters", "offers", "createdAt", "updatedAt" ], "description": "Rozszerzenie allee." } }, "required": [ "id", "name", "parameters", "offers", "allee" ], "description": "Zestaw wariantów (Allegro: oferty wielowariantowe) + blok allee." }, "OfferVariantSetList": { "type": "object", "properties": { "offerVariants": { "type": "array", "items": { "$ref": "#/components/schemas/OfferVariantSet" } }, "count": { "type": "integer", "description": "Zestawów na tej stronie." }, "totalCount": { "type": "integer", "description": "Wszystkich zestawów sprzedawcy." } }, "required": [ "offerVariants", "count", "totalCount" ], "description": "Lista zestawów (Allegro GET /sale/offer-variants)." }, "OfferEventList": { "type": "object", "properties": { "offerEvents": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Kursor zdarzenia (do parametru from)." }, "type": { "type": "string", "enum": [ "OFFER_ACTIVATED", "OFFER_CHANGED", "OFFER_ENDED", "OFFER_STOCK_CHANGED", "OFFER_PRICE_CHANGED", "OFFER_ARCHIVED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "offer": { "type": "object", "properties": { "id": { "type": "string" }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" } }, "required": [ "id" ] } }, "required": [ "id" ], "additionalProperties": true }, "allee": { "type": "object", "properties": { "reason": { "type": [ "string", "null" ], "enum": [ "MODERATION", "EMPTY_STOCK", "IMAGE_FAILED", null ], "description": "Powód zmiany nadany przez allee." }, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] } }, "additionalProperties": true } }, "required": [ "id", "type", "occurredAt", "offer" ], "description": "Zdarzenie oferty.", "additionalProperties": true } } }, "required": [ "offerEvents" ], "description": "Zdarzenia ofert (Allegro GET /sale/offer-events)." }, "ImageUploaded": { "type": "object", "properties": { "location": { "type": "string", "description": "Adres zdjęcia do użycia w ofercie (images).", "format": "uri" }, "expiresAt": { "type": "string", "format": "date-time", "description": "Do kiedy adres trzeba użyć w ofercie." } }, "required": [ "location", "expiresAt" ], "description": "Zdjęcie przyjęte (Allegro POST /sale/images)." }, "UploadDestination": { "type": "object", "properties": { "uploadId": { "type": "string", "format": "uuid" }, "method": { "type": "string", "enum": [ "PUT" ] }, "url": { "type": "string", "description": "Podpisany adres PUT do magazynu plików (ważny 5 min).", "format": "uri" }, "headers": { "type": "object", "additionalProperties": { "type": "string" }, "description": "Nagłówki, które MUSISZ wysłać z PUT (Content-Type)." }, "location": { "type": "string", "description": "Adres zdjęcia po wgraniu — wpisz go do images oferty.", "format": "uri" }, "expiresAt": { "type": "string", "format": "date-time" }, "maxBytes": { "type": "integer", "description": "Największy dozwolony rozmiar pliku." } }, "required": [ "uploadId", "method", "url", "headers", "location", "expiresAt", "maxBytes" ], "description": "Miejsce wgrania pliku wprost do magazynu (Amazon Uploads API)." }, "FeePreview": { "type": "object", "properties": { "commissions": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "fee": { "$ref": "#/components/schemas/Money" } }, "required": [ "name", "type", "fee" ] } }, "quotes": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" }, "fee": { "$ref": "#/components/schemas/Money" }, "cycleDuration": { "type": [ "string", "null" ] } }, "required": [ "name", "type", "fee", "cycleDuration" ] } }, "allee": { "type": "object", "properties": { "total": { "$ref": "#/components/schemas/Money" }, "feeScheduleVersion": { "type": "string", "description": "Wersja cennika opłat." }, "note": { "type": "string" } }, "required": [ "total", "feeScheduleVersion", "note" ] } }, "required": [ "commissions", "quotes", "allee" ], "description": "Podgląd opłat (Allegro POST /pricing/offer-fee-preview)." }, "FeesEstimateResult": { "type": "object", "properties": { "feesEstimates": { "type": "array", "items": { "type": "object", "properties": { "identifier": { "type": "string" }, "status": { "type": "string", "enum": [ "SUCCESS", "CLIENT_ERROR" ] }, "totalFees": { "anyOf": [ { "$ref": "#/components/schemas/Money" }, { "type": "null" } ] }, "feeDetails": { "type": "array", "items": { "type": "object", "properties": { "feeType": { "type": "string", "enum": [ "LISTING_FEE", "SUCCESS_COMMISSION" ] }, "feeAmount": { "$ref": "#/components/schemas/Money" } }, "required": [ "feeType", "feeAmount" ] } }, "error": { "type": [ "object", "null" ], "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "path": { "type": "string" } }, "required": [ "code", "message", "path" ] } }, "required": [ "identifier", "status", "totalFees", "feeDetails", "error" ] } }, "feeScheduleVersion": { "type": "string" } }, "required": [ "feesEstimates", "feeScheduleVersion" ], "description": "Wyceny opłat wsadowo (Amazon getMyFeesEstimates)." }, "OfferCriteria": { "type": "array", "items": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "CONTAINS_OFFERS" ] }, "offers": { "type": "array", "items": { "$ref": "#/components/schemas/IdRef" }, "description": "Najwyżej 1000 różnych ofert.", "minItems": 1, "maxItems": 1000 } }, "required": [ "type", "offers" ] }, "description": "Wybór ofert polecenia.", "minItems": 1 }, "CommandResult": { "type": "object", "properties": { "id": { "type": "string", "description": "commandId (UUID).", "format": "uuid" }, "taskCount": { "type": "object", "properties": { "total": { "type": "integer" }, "success": { "type": "integer" }, "failed": { "type": "integer" } }, "required": [ "total", "success", "failed" ] }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "taskCount", "createdAt" ], "description": "Wynik polecenia. allee wykonuje polecenie od razu — taskCount jest ostateczny już w odpowiedzi PUT." }, "CommandTaskList": { "type": "object", "properties": { "tasks": { "type": "array", "items": { "type": "object", "properties": { "offer": { "$ref": "#/components/schemas/IdRef" }, "status": { "type": "string", "enum": [ "SUCCESS", "FAIL" ] }, "message": { "type": "string" }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/Error" } }, "finishedAt": { "type": "string", "format": "date-time" } }, "required": [ "offer", "status", "message", "errors", "finishedAt" ] } } }, "required": [ "tasks" ], "description": "Zadania polecenia (po jednym na ofertę, posortowane po id oferty)." }, "QuantityChangeCommand": { "type": "object", "properties": { "modification": { "type": "object", "properties": { "changeType": { "type": "string", "enum": [ "FIXED", "GAIN" ], "description": "FIXED = ustaw, GAIN = dodaj (może być ujemne)." }, "value": { "type": "integer" } }, "required": [ "changeType", "value" ] }, "offerCriteria": { "$ref": "#/components/schemas/OfferCriteria" } }, "required": [ "modification", "offerCriteria" ], "description": "Polecenie zmiany liczby sztuk." }, "PriceChangeCommand": { "type": "object", "properties": { "modification": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "FIXED_PRICE" ] }, "price": { "$ref": "#/components/schemas/MoneyInput" } }, "required": [ "type", "price" ] }, "offerCriteria": { "$ref": "#/components/schemas/OfferCriteria" } }, "required": [ "modification", "offerCriteria" ], "description": "Polecenie zmiany ceny." }, "ModificationCommand": { "type": "object", "properties": { "modification": { "type": "object", "properties": { "delivery": { "type": "object", "properties": { "handlingTime": { "type": "string" }, "shippingRates": { "$ref": "#/components/schemas/IdRef" } } }, "afterSalesServices": { "type": "object", "properties": { "returnPolicy": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "warranty": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "impliedWarranty": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] } } } }, "description": "Tylko delivery i afterSalesServices (inne pole → zadanie FAIL UnknownJSONProperty)." }, "offerCriteria": { "$ref": "#/components/schemas/OfferCriteria" } }, "required": [ "modification", "offerCriteria" ], "description": "Polecenie zmiany ustawień ofert." }, "PublicationCommand": { "type": "object", "properties": { "publication": { "type": "object", "properties": { "action": { "type": "string", "enum": [ "ACTIVATE", "END" ] } }, "required": [ "action" ] }, "offerCriteria": { "$ref": "#/components/schemas/OfferCriteria" } }, "required": [ "publication", "offerCriteria" ], "description": "Polecenie publikacji: aktywuj albo zakończ." }, "ListingIssue": { "type": "object", "properties": { "code": { "type": "string", "description": "Kod problemu (ten sam słownik co błędy walidacji oferty)." }, "message": { "type": "string" }, "severity": { "type": "string", "enum": [ "ERROR", "WARNING", "INFO" ], "description": "ERROR blokuje zapis/publikację, WARNING nie blokuje." }, "attributeNames": { "type": "array", "items": { "type": "string" }, "description": "Atrybuty, których dotyczy problem." }, "categories": { "type": "array", "items": { "type": "string" }, "description": "Grupy problemu, np. MISSING_ATTRIBUTE, INVALID_ATTRIBUTE, GPSR." }, "path": { "type": [ "string", "null" ], "description": "Pole w kształcie Allegro (np. productSet[0].product.parameters)." }, "messageId": { "type": "integer", "description": "Numer komunikatu wsadu (tylko w raporcie wsadu)." } }, "required": [ "code", "message", "severity", "attributeNames", "categories" ], "description": "Problem oferty (Amazon issues[])." }, "ListingAttributes": { "type": "object", "properties": { "name": { "type": "string", "description": "Tytuł (10–75 znaków)." }, "category": { "type": "object", "properties": { "alleeId": { "type": "integer" }, "id": { "type": "string" } }, "description": "Kategoria (alleeId ma pierwszeństwo)." }, "parameters": { "type": "object", "additionalProperties": { "type": "object", "properties": { "valuesIds": { "type": "array", "items": { "type": "string" } }, "alleeValuesIds": { "type": "array", "items": { "type": "integer" } }, "values": { "type": "array", "items": { "type": [ "string", "number" ] } } } }, "description": "Parametry: klucz = id parametru Allegro (patrz schemat kategorii)." }, "images": { "type": "array", "items": { "type": "string", "format": "uri" }, "description": "1–16 adresów." }, "description": { "type": "string", "description": "Opis (tekst, 20–20 000 znaków)." }, "price": { "$ref": "#/components/schemas/MoneyInput" }, "stock": { "type": "integer", "description": "Sztuki (0–99 999)." }, "ean": { "type": "string", "description": "GTIN (EAN)." }, "shippingRatesId": { "type": "string", "description": "Twój cennik.", "format": "uuid" }, "handlingTime": { "type": "string", "description": "PT0S, PT24H, P2D…P60D." }, "returnPolicyId": { "type": [ "string", "null" ] }, "warrantyId": { "type": [ "string", "null" ] }, "impliedWarrantyId": { "type": [ "string", "null" ] }, "responsibleProducerId": { "type": [ "string", "null" ] }, "responsiblePersonId": { "type": [ "string", "null" ] }, "safetyInformation": { "anyOf": [ { "$ref": "#/components/schemas/SafetyInformation" }, { "type": "null" } ] }, "taxRate": { "type": [ "string", "null" ], "enum": [ "0.00", "5.00", "8.00", "23.00", null ] }, "invoice": { "type": [ "string", "null" ], "enum": [ "VAT", "VAT_MARGIN", "WITHOUT_VAT", "NO_INVOICE", null ] }, "location": { "type": [ "object", "null" ], "additionalProperties": true } }, "description": "Atrybuty listingu (płaskie, nazwy jak w schemacie kategorii GET /allee/categories/{id}/schema)." }, "ListingPutRequest": { "type": "object", "properties": { "requirements": { "type": "string", "enum": [ "LISTING", "LISTING_OFFER_ONLY" ], "description": "LISTING (domyślnie) = pełna oferta; LISTING_OFFER_ONLY = tylko cena, stan, dostawa… istniejącego SKU." }, "status": { "type": "string", "enum": [ "ACTIVE", "INACTIVE" ], "description": "ACTIVE = publikuj (wymaga GPSR), INACTIVE = szkic." }, "attributes": { "$ref": "#/components/schemas/ListingAttributes" }, "productType": { "type": "string", "description": "Przyjmowane bez skutku (zgodność z klientami Amazon)." }, "marketplaceIds": { "type": "array", "items": { "type": "string" }, "description": "Bez skutku." }, "issueLocale": { "type": "string", "description": "Bez skutku." } }, "required": [ "attributes" ], "description": "Utworzenie albo zastąpienie oferty po SKU." }, "ListingPatchRequest": { "type": "object", "properties": { "patches": { "type": "array", "items": { "type": "object", "properties": { "op": { "type": "string", "enum": [ "replace", "add", "delete" ] }, "path": { "type": "string", "description": "Ścieżka /attributes/{nazwa}, np. /attributes/price, /attributes/stock.", "examples": [ "/attributes/price" ] }, "value": { "description": "Nowa wartość (dla replace i add)." } }, "required": [ "op", "path" ] }, "description": "Zmiany JSON Patch (RFC 6902, podzbiór).", "minItems": 1 }, "status": { "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] }, "productType": { "type": "string" }, "marketplaceIds": { "type": "array", "items": { "type": "string" } }, "issueLocale": { "type": "string" } }, "required": [ "patches" ], "description": "Częściowa zmiana oferty po SKU." }, "ListingSubmissionResponse": { "type": "object", "properties": { "sku": { "type": "string" }, "status": { "type": "string", "enum": [ "ACCEPTED", "INVALID", "VALID" ], "description": "ACCEPTED = zapisano; VALID = podgląd poprawny (nic nie zapisano); INVALID = błędy (nic nie zapisano)." }, "submissionId": { "type": "string", "description": "Identyfikator zgłoszenia (= X-Request-Id)." }, "offerId": { "type": [ "string", "null" ] }, "change": { "type": [ "string", "null" ], "enum": [ "CREATED", "UPDATED", "UNCHANGED", "DELETED", "ENDED", null ], "description": "Co się stało z ofertą." }, "publicationStatus": { "anyOf": [ { "$ref": "#/components/schemas/PublicationStatus" }, { "type": "null" } ] }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ListingIssue" } }, "errors": { "type": "array", "items": { "$ref": "#/components/schemas/Error" }, "description": "Przy INVALID: te same problemy w kształcie Allegro." } }, "required": [ "sku", "status", "submissionId", "offerId", "change", "publicationStatus", "issues" ], "description": "Wynik zapisu listingu (Amazon ListingsItemSubmissionResponse)." }, "ListingSummary": { "type": "object", "properties": { "marketplaceId": { "type": "string", "enum": [ "allee-pl" ] }, "offerId": { "type": "string" }, "category": { "$ref": "#/components/schemas/CategoryRef" }, "status": { "type": "array", "items": { "type": "string", "enum": [ "BUYABLE", "DISCOVERABLE" ] }, "description": "BUYABLE = da się kupić; DISCOVERABLE = widoczna." }, "publicationStatus": { "$ref": "#/components/schemas/PublicationStatus" }, "itemName": { "type": "string" }, "conditionType": { "type": [ "string", "null" ], "enum": [ "new_new", "used_good", "refurbished_refurbished", "used_acceptable", null ], "description": "Stan (nazwy Amazona)." }, "createdDate": { "type": "string", "format": "date-time" }, "lastUpdatedDate": { "type": "string", "format": "date-time" }, "mainImage": { "type": [ "object", "null" ], "properties": { "link": { "type": "string", "format": "uri" } }, "required": [ "link" ] }, "url": { "type": "string", "format": "uri" } }, "required": [ "marketplaceId", "offerId", "category", "status", "publicationStatus", "itemName", "conditionType", "createdDate", "lastUpdatedDate", "mainImage", "url" ], "description": "Podsumowanie listingu." }, "ListingItem": { "type": "object", "properties": { "sku": { "type": "string" }, "summaries": { "type": "array", "items": { "$ref": "#/components/schemas/ListingSummary" } }, "attributes": { "$ref": "#/components/schemas/ListingAttributes" }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ListingIssue" } }, "offers": { "type": "array", "items": { "type": "object", "properties": { "marketplaceId": { "type": "string", "enum": [ "allee-pl" ] }, "offerType": { "type": "string", "enum": [ "B2C" ] }, "price": { "$ref": "#/components/schemas/Money" }, "sellingFormat": { "type": "string", "enum": [ "BUY_NOW", "AUCTION" ] } }, "required": [ "marketplaceId", "offerType", "price", "sellingFormat" ] } }, "fulfillmentAvailability": { "type": "array", "items": { "type": "object", "properties": { "fulfillmentChannelCode": { "type": "string", "enum": [ "DEFAULT" ] }, "quantity": { "type": "integer" }, "handlingTime": { "type": [ "string", "null" ] } }, "required": [ "fulfillmentChannelCode", "quantity", "handlingTime" ] } } }, "required": [ "sku" ], "description": "Listing (Amazon Item) — sekcje wg includedData." }, "ListingSearchResult": { "type": "object", "properties": { "numberOfResults": { "type": "integer" }, "pagination": { "type": "object", "properties": { "nextToken": { "type": [ "string", "null" ], "description": "Token następnej strony (parametr pageToken)." } }, "required": [ "nextToken" ] }, "items": { "type": "array", "items": { "$ref": "#/components/schemas/ListingItem" } } }, "required": [ "numberOfResults", "pagination", "items" ], "description": "Wyszukiwanie listingów (Amazon searchListingsItems)." }, "FeedMessage": { "type": "object", "properties": { "messageId": { "type": "integer", "description": "Numer komunikatu w wsadzie (unikalny)." }, "sku": { "type": "string", "description": "SKU oferty." }, "offerId": { "type": "string", "description": "Albo id oferty." }, "operationType": { "type": "string", "enum": [ "UPDATE", "PARTIAL_UPDATE", "PATCH", "DELETE" ], "description": "UPDATE = utwórz/zastąp (jak PUT), PARTIAL_UPDATE = zmień podane atrybuty, PATCH = JSON Patch, DELETE = usuń szkic / zakończ." }, "requirements": { "type": "string", "enum": [ "LISTING", "LISTING_OFFER_ONLY" ] }, "status": { "type": "string", "enum": [ "ACTIVE", "INACTIVE" ] }, "attributes": { "$ref": "#/components/schemas/ListingAttributes" }, "patches": { "type": "array", "items": { "type": "object", "additionalProperties": true } } }, "required": [ "messageId", "operationType" ], "description": "Komunikat wsadu JSON_LISTINGS_FEED." }, "FeedDocument": { "type": "object", "properties": { "header": { "type": "object", "properties": { "sellerId": { "type": "string" }, "version": { "type": "string", "enum": [ "2.0" ] } }, "additionalProperties": true }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/FeedMessage" }, "description": "Do 10 000 komunikatów.", "minItems": 1, "maxItems": 10000 } }, "required": [ "messages" ], "description": "Dokument wsadu JSON_LISTINGS_FEED." }, "CreateFeedRequest": { "type": "object", "properties": { "feedType": { "type": "string", "enum": [ "JSON_LISTINGS_FEED" ] }, "content": { "$ref": "#/components/schemas/FeedDocument" }, "messages": { "type": "array", "items": { "$ref": "#/components/schemas/FeedMessage" }, "description": "Albo sama lista komunikatów." }, "header": { "type": "object", "additionalProperties": true, "description": "Nagłówek przy podaniu messages." }, "inputFeedDocumentId": { "type": "string", "description": "Albo dokument wgrany przez POST /allee/feeds/documents.", "format": "uuid" }, "uploadId": { "type": "string", "description": "Alias inputFeedDocumentId." }, "marketplaceIds": { "type": "array", "items": { "type": "string" } }, "feedOptions": { "type": "object", "additionalProperties": true } }, "required": [ "feedType" ], "description": "Nowy wsad: dokładnie jedno z content, messages, inputFeedDocumentId." }, "Feed": { "type": "object", "properties": { "feedId": { "type": "string", "format": "uuid" }, "feedType": { "type": "string", "enum": [ "JSON_LISTINGS_FEED" ] }, "marketplaceIds": { "type": "array", "items": { "type": "string" } }, "createdTime": { "type": "string", "format": "date-time" }, "processingStatus": { "type": "string", "enum": [ "IN_QUEUE", "IN_PROGRESS", "DONE", "CANCELLED", "FATAL" ] }, "processingStartTime": { "type": [ "string", "null" ], "format": "date-time" }, "processingEndTime": { "type": [ "string", "null" ], "format": "date-time" }, "resultFeedDocumentId": { "type": [ "string", "null" ], "description": "Gdy DONE: wynik pod GET /allee/feeds/{feedId}/result." }, "allee": { "type": "object", "properties": { "source": { "type": "string", "enum": [ "INLINE", "DOKUMENT", "POLECENIE" ], "description": "Skąd wsad: treść żądania, dokument, polecenie wsadowe Allegro." }, "messages": { "type": "object", "properties": { "total": { "type": "integer" }, "processed": { "type": "integer" }, "accepted": { "type": "integer" }, "invalid": { "type": "integer" }, "withWarnings": { "type": "integer" } }, "required": [ "total", "processed", "accepted", "invalid", "withWarnings" ] }, "fatalError": { "type": [ "string", "null" ], "description": "Powód przerwania całego wsadu (FATAL)." } }, "required": [ "source", "messages", "fatalError" ] } }, "required": [ "feedId", "feedType", "marketplaceIds", "createdTime", "processingStatus", "processingStartTime", "processingEndTime", "resultFeedDocumentId", "allee" ], "description": "Wsad (Amazon Feed)." }, "FeedList": { "type": "object", "properties": { "feeds": { "type": "array", "items": { "$ref": "#/components/schemas/Feed" } }, "nextToken": { "type": [ "string", "null" ] } }, "required": [ "feeds", "nextToken" ] }, "FeedResult": { "type": "object", "properties": { "header": { "type": "object", "properties": { "sellerId": { "type": "string" }, "feedId": { "type": "string" }, "version": { "type": "string" } }, "required": [ "sellerId", "feedId", "version" ] }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ListingIssue" } }, "summary": { "type": "object", "properties": { "errors": { "type": "integer" }, "warnings": { "type": "integer" }, "messagesProcessed": { "type": "integer" }, "messagesAccepted": { "type": "integer" }, "messagesInvalid": { "type": "integer" } }, "required": [ "errors", "warnings", "messagesProcessed", "messagesAccepted", "messagesInvalid" ] }, "allee": { "type": "object", "properties": { "processingStatus": { "type": "string", "enum": [ "DONE", "FATAL" ] }, "fatalError": { "type": [ "string", "null" ] }, "results": { "type": "array", "items": { "type": "object", "properties": { "messageId": { "type": "integer" }, "sku": { "type": [ "string", "null" ] }, "offerId": { "type": [ "string", "null" ] }, "status": { "type": "string", "enum": [ "ACCEPTED", "INVALID" ] }, "change": { "type": [ "string", "null" ], "enum": [ "CREATED", "UPDATED", "UNCHANGED", "DELETED", "ENDED", null ] }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ListingIssue" } } }, "required": [ "messageId", "sku", "offerId", "status", "change", "issues" ] }, "description": "Wynik każdego komunikatu." } }, "required": [ "processingStatus", "fatalError", "results" ] } }, "required": [ "header", "issues", "summary", "allee" ], "description": "Raport przetwarzania wsadu." }, "FeedDocumentUpload": { "type": "object", "properties": { "feedDocumentId": { "type": "string", "format": "uuid" }, "method": { "type": "string", "enum": [ "PUT" ] }, "url": { "type": "string", "format": "uri" }, "headers": { "type": "object", "additionalProperties": { "type": "string" } }, "expiresAt": { "type": "string", "format": "date-time" }, "maxBytes": { "type": "integer" } }, "required": [ "feedDocumentId", "method", "url", "headers", "expiresAt", "maxBytes" ], "description": "Miejsce wgrania dokumentu wsadu (do 10 MB)." }, "BulkModificationRequest": { "type": "object", "properties": { "offers": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "Id oferty." }, "external": { "type": "object", "properties": { "id": { "type": "string", "description": "SKU." } }, "required": [ "id" ] }, "sellingMode": { "type": "object", "properties": { "price": { "$ref": "#/components/schemas/MoneyInput" } }, "required": [ "price" ] }, "stock": { "type": "object", "properties": { "available": { "type": "integer" } }, "required": [ "available" ] } } }, "description": "Do 10 000 pozycji.", "minItems": 1, "maxItems": 10000 } }, "required": [ "offers" ], "description": "Wsad cen i stanów w kształcie poleceń Allegro." }, "CreateReportRequest": { "type": "object", "properties": { "reportType": { "type": "string", "enum": [ "OFFERS_ALL", "OFFERS_ISSUES", "ORDERS_BY_DATE", "BILLING_ENTRIES", "RETURNS", "API_USAGE" ] }, "dataStartTime": { "type": "string", "format": "date-time", "description": "Początek okresu (domyślnie 30 dni wstecz; najwyżej 92 dni)." }, "dataEndTime": { "type": "string", "format": "date-time", "description": "Koniec okresu (domyślnie teraz)." }, "reportOptions": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "CSV", "JSON" ] } } }, "marketplaceIds": { "type": "array", "items": { "type": "string" } } }, "required": [ "reportType" ], "description": "Zamówienie raportu." }, "Report": { "type": "object", "properties": { "reportId": { "type": "string", "format": "uuid" }, "reportType": { "type": "string" }, "marketplaceIds": { "type": "array", "items": { "type": "string" } }, "dataStartTime": { "type": [ "string", "null" ], "format": "date-time" }, "dataEndTime": { "type": [ "string", "null" ], "format": "date-time" }, "createdTime": { "type": "string", "format": "date-time" }, "processingStatus": { "type": "string", "enum": [ "IN_QUEUE", "IN_PROGRESS", "DONE", "CANCELLED", "FATAL" ] }, "processingStartTime": { "type": [ "string", "null" ], "format": "date-time" }, "processingEndTime": { "type": [ "string", "null" ], "format": "date-time" }, "reportDocumentId": { "type": [ "string", "null" ] }, "allee": { "type": "object", "properties": { "format": { "type": "string", "enum": [ "CSV", "JSON" ] }, "rows": { "type": [ "integer", "null" ], "description": "Liczba wierszy (gdy DONE)." }, "personalData": { "type": "boolean", "description": "Czy raport zawiera dane osobowe kupujących (zakres orders:pii)." }, "documentExpiresAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Dokument jest usuwany po 7 dniach." }, "error": { "type": [ "string", "null" ] } }, "required": [ "format", "rows", "personalData", "documentExpiresAt", "error" ] } }, "required": [ "reportId", "reportType", "marketplaceIds", "dataStartTime", "dataEndTime", "createdTime", "processingStatus", "processingStartTime", "processingEndTime", "reportDocumentId", "allee" ], "description": "Raport (Amazon Report)." }, "ReportList": { "type": "object", "properties": { "reports": { "type": "array", "items": { "$ref": "#/components/schemas/Report" } }, "nextToken": { "type": [ "string", "null" ] } }, "required": [ "reports", "nextToken" ] }, "ReportDocument": { "type": "object", "properties": { "reportDocumentId": { "type": "string" }, "url": { "type": "string", "description": "Podpisany adres pobrania (ważny 5 minut, bez tokenu).", "format": "uri" }, "compressionAlgorithm": { "type": "string", "enum": [ "GZIP" ] }, "contentType": { "type": "string", "enum": [ "text/csv", "application/json" ] }, "expiresAt": { "type": "string", "format": "date-time" } }, "required": [ "reportDocumentId", "url", "compressionAlgorithm", "contentType", "expiresAt" ], "description": "Dokument raportu." }, "CheckoutForm": { "type": "object", "properties": { "id": { "type": "string", "description": "Identyfikator zamówienia (checkoutForm.id).", "format": "uuid" }, "status": { "type": "string", "enum": [ "BOUGHT", "FILLED_IN", "READY_FOR_PROCESSING", "CANCELLED" ], "description": "Status zakupu. API pokazuje zamówienia od READY_FOR_PROCESSING." }, "updatedAt": { "type": "string", "format": "date-time" }, "revision": { "type": "string", "description": "Rewizja (tekst) — rośnie przy każdej zmianie statusu; podaj w PUT …/fulfillment?checkoutForm.revision." }, "marketplace": { "type": "object", "properties": { "id": { "type": "string", "enum": [ "allee-pl" ] } }, "required": [ "id" ] }, "messageToSeller": { "type": [ "string", "null" ], "description": "Wiadomość kupującego do sprzedawcy." }, "buyer": { "type": "object", "properties": { "id": { "type": "string" }, "email": { "type": [ "string", "null" ], "description": "E-mail kupującego (null bez zakresu allee:api:orders:pii dla nowych aplikacji)." }, "login": { "type": "string" }, "firstName": { "type": [ "string", "null" ], "description": "Zawsze null — imię i nazwisko odbiorcy są w delivery.address." }, "lastName": { "type": [ "string", "null" ] }, "companyName": { "type": [ "string", "null" ] }, "phoneNumber": { "type": [ "string", "null" ] }, "guest": { "type": "boolean" } }, "required": [ "id", "email", "login", "firstName", "lastName", "companyName", "phoneNumber", "guest" ] }, "payment": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "type": { "type": "string", "enum": [ "ONLINE", "CASH_ON_DELIVERY" ] }, "provider": { "type": [ "string", "null" ] }, "finishedAt": { "type": [ "string", "null" ], "format": "date-time" }, "paidAmount": { "anyOf": [ { "$ref": "#/components/schemas/Money" }, { "type": "null" } ], "description": "Zapłacono (płatność online); null przy pobraniu." } }, "required": [ "id", "type", "provider", "finishedAt", "paidAmount" ] }, "fulfillment": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/FulfillmentStatus" }, "shipmentSummary": { "type": "object", "properties": { "lineItemsSent": { "type": "string", "enum": [ "NONE", "SOME", "ALL" ] } }, "required": [ "lineItemsSent" ] } }, "required": [ "status", "shipmentSummary" ] }, "delivery": { "type": "object", "properties": { "method": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "address": { "type": [ "object", "null" ], "properties": { "firstName": { "type": [ "string", "null" ] }, "lastName": { "type": [ "string", "null" ] }, "street": { "type": [ "string", "null" ] }, "city": { "type": [ "string", "null" ] }, "zipCode": { "type": [ "string", "null" ] }, "countryCode": { "type": [ "string", "null" ] }, "companyName": { "type": [ "string", "null" ] }, "phoneNumber": { "type": [ "string", "null" ] } }, "required": [ "firstName", "lastName", "street", "city", "zipCode", "countryCode", "companyName", "phoneNumber" ], "description": "Adres dostawy (dane osobowe — patrz zakres orders:pii)." }, "pickupPoint": { "type": [ "object", "null" ], "additionalProperties": true, "description": "Punkt odbioru (dziś zawsze null)." }, "cost": { "$ref": "#/components/schemas/Money", "description": "Koszt dostawy zapłacony przez kupującego." }, "time": { "type": [ "object", "null" ], "additionalProperties": true }, "smart": { "type": "boolean" }, "calculatedNumberOfPackages": { "type": "integer" } }, "required": [ "method", "address", "pickupPoint", "cost", "time", "smart", "calculatedNumberOfPackages" ] }, "invoice": { "type": "object", "properties": { "required": { "type": "boolean", "description": "Czy kupujący chce faktury (podał NIP)." }, "address": { "type": [ "object", "null" ], "properties": { "street": { "type": [ "string", "null" ], "description": "Ulica i numer (zerowane bez dostępu do danych kupujących)." }, "city": { "type": [ "string", "null" ] }, "zipCode": { "type": [ "string", "null" ] }, "countryCode": { "type": [ "string", "null" ] }, "company": { "type": "object", "properties": { "name": { "type": [ "string", "null" ] }, "taxId": { "type": [ "string", "null" ] } }, "required": [ "name", "taxId" ] } }, "required": [ "company" ], "description": "Dane do faktury (od 10.11 z adresem siedziby)." } }, "required": [ "required", "address" ] }, "lineItems": { "type": "array", "items": { "$ref": "#/components/schemas/CheckoutFormLineItem" } }, "summary": { "type": "object", "properties": { "totalToPay": { "$ref": "#/components/schemas/Money", "description": "Do zapłaty: produkty + dostawa." } }, "required": [ "totalToPay" ] }, "allee": { "type": "object", "properties": { "test": { "type": "boolean", "description": "Płatność testowa (payment.provider TEST_BLIK) — nie księgować." }, "commission": { "type": "object", "properties": { "amount": { "type": "string", "description": "Prowizja allee za zamówienie (dziś 0.00 — allee nie pobiera prowizji)." }, "currency": { "type": "string" }, "rate": { "type": "string", "description": "Stawka w procentach, np. „0.00”." }, "base": { "type": "string", "enum": [ "PRODUCTS" ], "description": "Podstawa: cena × sztuki pozycji, bez kosztu dostawy." }, "final": { "type": "boolean", "description": "true = kwota już się nie zmieni." }, "priceListVersion": { "type": "string", "description": "Wersja cennika allee użyta do wyliczenia." } }, "required": [ "amount", "currency", "rate", "base", "final", "priceListVersion" ] } }, "required": [ "test", "commission" ], "description": "Rozszerzenia allee (10.11.2026)." } }, "required": [ "id", "status", "updatedAt", "revision", "marketplace", "messageToSeller", "buyer", "payment", "fulfillment", "delivery", "invoice", "lineItems", "summary", "allee" ], "description": "Zamówienie (kształt Allegro checkout-form)." }, "CheckoutFormLineItem": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "offer": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" } }, "required": [ "id" ] } }, "required": [ "id", "name", "external" ] }, "quantity": { "type": "integer" }, "originalPrice": { "$ref": "#/components/schemas/Money", "description": "Cena sprzed obniżki (Omnibus) albo równa price." }, "price": { "$ref": "#/components/schemas/Money", "description": "Cena jednostkowa zapłacona." }, "tax": { "type": [ "object", "null" ], "properties": { "rate": { "type": [ "string", "null" ] } }, "required": [ "rate" ], "description": "Stawka VAT z oferty." }, "boughtAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "offer", "quantity", "originalPrice", "price", "tax", "boughtAt" ], "description": "Pozycja zamówienia." }, "FulfillmentStatus": { "type": "string", "enum": [ "NEW", "PROCESSING", "READY_FOR_SHIPMENT", "READY_FOR_PICKUP", "SENT", "PICKED_UP", "CANCELLED", "SUSPENDED", "RETURNED" ], "description": "Status realizacji (tylko do przodu)." }, "CheckoutFormList": { "type": "object", "properties": { "checkoutForms": { "type": "array", "items": { "$ref": "#/components/schemas/CheckoutForm" } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "checkoutForms", "count", "totalCount" ] }, "OrderEvent": { "type": "object", "properties": { "id": { "type": "string", "description": "Kursor (parametr from)." }, "type": { "type": "string", "enum": [ "BOUGHT", "FILLED_IN", "READY_FOR_PROCESSING", "BUYER_CANCELLED", "FULFILLMENT_STATUS_CHANGED", "BUYER_MODIFIED", "AUTO_CANCELLED", "SHIPMENT_ADDED", "SHIPMENT_STAGE_CHANGED" ] }, "occurredAt": { "type": "string", "format": "date-time" }, "changedBy": { "type": "string", "enum": [ "SELLER_PANEL", "SELLER_API", "BUYER", "CARRIER", "ALLEE" ], "description": "Kto wywołał zmianę (allee, 10.11.2026)." }, "changedByAppId": { "type": [ "string", "null" ], "description": "Id aplikacji OAuth, gdy changedBy = SELLER_API przez aplikację — po nim rozpoznasz echa własnych zmian." }, "order": { "type": "object", "properties": { "seller": { "$ref": "#/components/schemas/IdRef" }, "checkoutForm": { "type": "object", "properties": { "id": { "type": "string" }, "revision": { "type": "string" } }, "required": [ "id", "revision" ] }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "offer": { "type": "object", "properties": { "id": { "type": "string" }, "external": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" } }, "required": [ "id" ] } }, "required": [ "id", "external" ] } }, "required": [ "id", "offer" ] } } }, "required": [ "seller", "checkoutForm", "lineItems" ] } }, "required": [ "id", "type", "occurredAt", "changedBy", "changedByAppId", "order" ], "description": "Zdarzenie zamówienia (Allegro /order/events)." }, "OrderEventList": { "type": "object", "properties": { "events": { "type": "array", "items": { "$ref": "#/components/schemas/OrderEvent" } } }, "required": [ "events" ] }, "OrderEventStats": { "type": "object", "properties": { "latestEvent": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "occurredAt" ] } }, "required": [ "latestEvent" ], "description": "Ostatnie zdarzenie — punkt startu kursora." }, "FulfillmentInput": { "type": "object", "properties": { "status": { "$ref": "#/components/schemas/FulfillmentStatus" }, "shipmentSummary": { "description": "Pomijane." } }, "required": [ "status" ], "description": "Nowy status realizacji." }, "Carrier": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" } }, "required": [ "id", "name" ] }, "CarrierList": { "type": "object", "properties": { "carriers": { "type": "array", "items": { "$ref": "#/components/schemas/Carrier" } } }, "required": [ "carriers" ] }, "ShipmentInput": { "type": "object", "properties": { "carrierId": { "type": "string", "description": "Kod przewoźnika z GET /order/carriers (wielkość liter bez znaczenia)." }, "waybill": { "type": "string", "description": "Numer przesyłki: [A-Za-z0-9._-/], 1–64 znaki.", "maxLength": 64 }, "carrierName": { "type": "string", "description": "Wymagane dla ALLEGRO i OTHER (do 60 znaków)." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "lineItem": { "$ref": "#/components/schemas/IdRef" }, "quantity": { "type": "integer", "description": "Rozszerzenie allee: część sztuk pozycji." } } }, "description": "Brak albo pusta lista = całe zamówienie." } }, "required": [ "carrierId", "waybill" ], "description": "Nowa przesyłka. Para (carrierId, waybill) w zamówieniu jest idempotentna (ponowienie → 200)." }, "Shipment": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "waybill": { "type": "string" }, "carrierId": { "type": "string" }, "carrierName": { "type": [ "string", "null" ] }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "quantity": { "type": "integer" } }, "required": [ "id", "quantity" ] } }, "createdAt": { "type": "string", "format": "date-time" }, "allee": { "type": "object", "properties": { "trackingUrl": { "type": [ "string", "null" ], "description": "Link śledzenia, który widzi kupujący (null — przewoźnik bez publicznej strony śledzenia).", "format": "uri" }, "warnings": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "WAYBILL_FORMAT_UNUSUAL" ] }, "path": { "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "path", "message" ] }, "description": "Ostrzeżenia (numer zapisany): nietypowy format dla DPD, InPost, Poczty Polskiej." } }, "required": [ "trackingUrl", "warnings" ], "description": "Rozszerzenia allee (10.11.2026)." } }, "required": [ "id", "waybill", "carrierId", "carrierName", "lineItems", "createdAt", "allee" ], "description": "Przesyłka." }, "ShipmentList": { "type": "object", "properties": { "shipments": { "type": "array", "items": { "$ref": "#/components/schemas/Shipment" } } }, "required": [ "shipments" ] }, "Tracking": { "type": "object", "properties": { "carrierId": { "type": "string" }, "waybills": { "type": "array", "items": { "type": "object", "properties": { "waybill": { "type": "string" }, "trackingDetails": { "type": [ "object", "null" ], "properties": { "createdAt": { "type": [ "string", "null" ], "format": "date-time" }, "updatedAt": { "type": [ "string", "null" ], "format": "date-time" }, "statuses": { "type": "array", "items": { "type": "object", "properties": { "occurredAt": { "type": "string", "format": "date-time" }, "code": { "type": "string" }, "description": { "type": [ "string", "null" ] } }, "required": [ "occurredAt", "code" ], "additionalProperties": true } } }, "required": [ "createdAt", "updatedAt", "statuses" ] }, "allee": { "type": "object", "properties": { "trackingUrl": { "type": [ "string", "null" ], "description": "Strona śledzenia u przewoźnika.", "format": "uri" } }, "required": [ "trackingUrl" ], "additionalProperties": true } }, "required": [ "waybill", "trackingDetails", "allee" ] } } }, "required": [ "carrierId", "waybills" ], "description": "Śledzenie przesyłek (Allegro GET /order/carriers/{carrierId}/tracking)." }, "Invoice": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" }, "invoiceNumber": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time" }, "file": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "uploadedAt": { "type": [ "string", "null" ], "format": "date-time" }, "securityVerification": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ACCEPTED", "REJECTED", "PENDING" ] }, "passedChecks": { "type": "array", "items": { "type": "string" } }, "failedChecks": { "type": "array", "items": { "type": "string" } } }, "required": [ "status", "passedChecks", "failedChecks" ], "description": "Kontrola bezpieczeństwa PDF (nagłówek, brak treści aktywnych, rozmiar)." } }, "required": [ "id", "name", "uploadedAt", "securityVerification" ], "description": "Plik PDF (null dla faktury-linku albo przed wgraniem pliku)." }, "allee": { "type": "object", "properties": { "type": { "type": "string", "enum": [ "FILE", "LINK" ] }, "status": { "type": "string", "enum": [ "READY", "WAITING_FOR_FILE" ] }, "size": { "type": [ "integer", "null" ] }, "url": { "type": [ "string", "null" ], "description": "Adres faktury-linku." }, "downloadUrl": { "type": [ "string", "null" ], "description": "Podpisany adres pobrania pliku (5 minut).", "format": "uri" }, "downloadUrlExpiresAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "type", "status", "size", "url", "downloadUrl", "downloadUrlExpiresAt" ] } }, "required": [ "id", "invoiceNumber", "createdAt", "file", "allee" ], "description": "Faktura zamówienia." }, "InvoiceList": { "type": "object", "properties": { "invoices": { "type": "array", "items": { "$ref": "#/components/schemas/Invoice" } }, "hasExternalInvoices": { "type": "boolean", "description": "Czy są faktury dodane przez integratora." } }, "required": [ "invoices", "hasExternalInvoices" ] }, "InvoiceCreate": { "type": "object", "properties": { "file": { "type": "object", "properties": { "name": { "type": "string", "description": "Nazwa pliku PDF." } }, "required": [ "name" ] }, "invoiceNumber": { "type": "string", "description": "Numer faktury." } }, "required": [ "file" ], "description": "Zapowiedź faktury (krok 1 z 2, jak Allegro)." }, "InvoiceCreated": { "type": "object", "properties": { "id": { "type": "string", "format": "uuid" } }, "required": [ "id" ] }, "InvoiceLinkInput": { "type": "object", "properties": { "url": { "type": "string", "description": "Adres https faktury u Ciebie.", "format": "uri" }, "invoiceNumber": { "type": "string" } }, "required": [ "url" ], "description": "Faktura jako link." }, "MessageThread": { "type": "object", "properties": { "id": { "type": "string" }, "read": { "type": "boolean", "description": "Czy sprzedawca przeczytał." }, "lastMessageDateTime": { "type": [ "string", "null" ], "format": "date-time" }, "interlocutor": { "type": "object", "properties": { "login": { "type": [ "string", "null" ] }, "avatarUrl": { "type": [ "string", "null" ] } }, "required": [ "login", "avatarUrl" ], "description": "Kupujący (login allee, bez e-maila)." }, "allee": { "type": "object", "properties": { "kind": { "type": "string", "enum": [ "QUESTION", "ORDER", "RETURN" ] }, "subject": { "type": [ "string", "null" ] }, "unreadCount": { "type": "integer" }, "order": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "offer": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "kind", "subject", "unreadCount", "order", "offer", "createdAt" ] } }, "required": [ "id", "read", "lastMessageDateTime", "interlocutor", "allee" ], "description": "Wątek (Allegro messaging thread)." }, "MessageThreadList": { "type": "object", "properties": { "threads": { "type": "array", "items": { "$ref": "#/components/schemas/MessageThread" } }, "offset": { "type": "integer" }, "limit": { "type": "integer" } }, "required": [ "threads", "offset", "limit" ] }, "Message": { "type": "object", "properties": { "id": { "type": "string" }, "status": { "type": "string", "enum": [ "DELIVERED" ] }, "type": { "type": "string", "enum": [ "ASK_QUESTION", "MESSAGE_CENTER" ] }, "createdAt": { "type": "string", "format": "date-time" }, "thread": { "$ref": "#/components/schemas/IdRef" }, "author": { "type": "object", "properties": { "login": { "type": "string" }, "isInterlocutor": { "type": "boolean", "description": "true = napisał kupujący." } }, "required": [ "login", "isInterlocutor" ] }, "text": { "type": "string" }, "subject": { "type": [ "string", "null" ] }, "relatesTo": { "type": "object", "properties": { "offer": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "order": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] } }, "required": [ "offer", "order" ] }, "hasAdditionalAttachments": { "type": "boolean" }, "attachments": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Zawsze puste (allee bez załączników)." }, "allee": { "type": "object", "properties": { "sender": { "type": "string", "enum": [ "BUYER", "SELLER", "SYSTEM" ] }, "reported": { "type": "boolean", "description": "Zgłoszona do moderacji." } }, "required": [ "sender", "reported" ] } }, "required": [ "id", "status", "type", "createdAt", "thread", "author", "text", "subject", "relatesTo", "hasAdditionalAttachments", "attachments", "allee" ], "description": "Wiadomość." }, "MessageList": { "type": "object", "properties": { "messages": { "type": "array", "items": { "$ref": "#/components/schemas/Message" } }, "offset": { "type": "integer" }, "limit": { "type": "integer" } }, "required": [ "messages", "offset", "limit" ] }, "MessageInput": { "type": "object", "properties": { "text": { "type": "string", "description": "Treść (bez linków zewnętrznych; limit 20 wiadomości na godzinę)." }, "attachments": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "description": "Tylko pusta lista.", "maxItems": 0 } }, "required": [ "text" ] }, "NewMessageInput": { "type": "object", "properties": { "text": { "type": "string" }, "order": { "$ref": "#/components/schemas/IdRef", "description": "Zamówienie allee.pl (checkoutForm.id) — nową rozmowę sprzedawca zaczyna tylko w sprawie zamówienia." }, "recipient": { "type": "object", "properties": { "login": { "type": "string", "description": "Login kupującego (sprawdzany)." } }, "required": [ "login" ] }, "attachments": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "maxItems": 0 } }, "required": [ "text", "order" ] }, "CustomerReturn": { "type": "object", "properties": { "id": { "type": "string", "description": "Numer zwrotu ZW-…" }, "createdAt": { "type": "string", "format": "date-time" }, "referenceNumber": { "type": "string" }, "orderId": { "type": "string", "description": "checkoutForm.id" }, "buyer": { "type": "object", "properties": { "login": { "type": [ "string", "null" ] }, "email": { "type": [ "string", "null" ], "description": "Tylko z zakresem allee:api:orders:pii." } }, "required": [ "login", "email" ] }, "items": { "type": "array", "items": { "type": "object", "properties": { "offerId": { "type": [ "string", "null" ] }, "quantity": { "type": "integer" }, "name": { "type": "string" }, "price": { "$ref": "#/components/schemas/Money" }, "reason": { "type": "object", "properties": { "type": { "type": [ "string", "null" ], "enum": [ "PARCEL_NOT_COLLECTED", null ] }, "userComment": { "type": [ "string", "null" ] } }, "required": [ "type", "userComment" ] } }, "required": [ "offerId", "quantity", "name", "price", "reason" ] } }, "parcels": { "type": "array", "items": { "type": "object", "properties": { "createdAt": { "type": [ "string", "null" ], "format": "date-time" }, "waybill": { "type": "string" }, "transportingWaybill": { "type": "string" }, "carrierId": { "type": [ "string", "null" ] }, "transportingCarrierId": { "type": [ "string", "null" ] } }, "required": [ "createdAt", "waybill", "transportingWaybill", "carrierId", "transportingCarrierId" ] } }, "marketplaceId": { "type": "string", "enum": [ "allee-pl" ] }, "status": { "type": "string", "enum": [ "CREATED", "IN_TRANSIT", "DELIVERED", "FINISHED", "REJECTED", "COMMISSION_REFUND_CLAIMED", "COMMISSION_REFUNDED" ] }, "refund": { "type": [ "object", "null" ], "properties": { "value": { "$ref": "#/components/schemas/Money", "description": "Zadeklarowany zwrot pieniędzy." } }, "required": [ "value" ] }, "rejection": { "type": [ "object", "null" ], "properties": { "reason": { "type": [ "string", "null" ] } }, "required": [ "reason" ] } }, "required": [ "id", "createdAt", "referenceNumber", "orderId", "buyer", "items", "parcels", "marketplaceId", "status", "refund", "rejection" ], "description": "Zwrot (Allegro customer-return, zasób BETA)." }, "CustomerReturnList": { "type": "object", "properties": { "customerReturns": { "type": "array", "items": { "$ref": "#/components/schemas/CustomerReturn" } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "customerReturns", "count", "totalCount" ] }, "CustomerReturnUpdate": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "DELIVERED" ], "description": "Paczka zwrotna dotarła." }, "allee": { "type": "object", "properties": { "refund": { "type": "object", "properties": { "value": { "$ref": "#/components/schemas/MoneyInput" } }, "required": [ "value" ] } }, "required": [ "refund" ], "description": "Deklaracja zwrotu pieniędzy (kończy zwrot; allee nie przenosi pieniędzy)." } } }, "CustomerReturnRejection": { "type": "object", "properties": { "rejection": { "type": "object", "properties": { "code": { "type": "string", "enum": [ "REFUND_REJECTED" ] }, "reason": { "type": "string", "description": "Uzasadnienie dla kupującego (do 500 znaków, bez linków)." } }, "required": [ "reason" ] } }, "required": [ "rejection" ] }, "Issue": { "type": "object", "properties": { "id": { "type": "string", "description": "RK-… (reklamacja) albo DS-… (dyskusja)." }, "type": { "type": "string", "enum": [ "CLAIM", "DISPUTE" ] }, "referenceNumber": { "type": "string" }, "status": { "type": "string", "enum": [ "CLAIM_SUBMITTED", "CLAIM_ACCEPTED", "CLAIM_REJECTED", "DISPUTE_ONGOING", "DISPUTE_CLOSED" ] }, "subject": { "type": "string" }, "description": { "type": [ "string", "null" ] }, "buyer": { "type": "object", "properties": { "id": { "type": "string" }, "login": { "type": [ "string", "null" ] } }, "required": [ "id", "login" ] }, "checkoutForm": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "createdAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "id", "createdAt" ] }, "offer": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] }, "expectations": { "type": "array", "items": { "type": "string", "enum": [ "REPAIR", "EXCHANGE", "DIFFERENCE_REFUND", "REFUND", "OTHER" ] } }, "openedDate": { "type": "string", "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "decisionDueDate": { "type": [ "string", "null" ], "format": "date-time", "description": "Termin odpowiedzi (sprawa otwarta)." }, "chat": { "type": "object", "properties": { "messagesCount": { "type": "integer" }, "lastMessageDateTime": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "messagesCount", "lastMessageDateTime" ] }, "allee": { "type": "object", "properties": { "responseDeadline": { "type": [ "string", "null" ], "format": "date-time", "description": "Termin ustawowy (14 dni, art. 7a upk)." }, "deadlinePassed": { "type": "boolean" }, "legalBasis": { "type": [ "string", "null" ] }, "demand": { "type": [ "string", "null" ], "description": "Żądanie kupującego." }, "result": { "type": [ "string", "null" ], "enum": [ "ACCEPTED", "REJECTED", "RESOLVED", null ] }, "resolution": { "type": [ "string", "null" ] }, "closedAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "responseDeadline", "deadlinePassed", "legalBasis", "demand", "result", "resolution", "closedAt" ] } }, "required": [ "id", "type", "referenceNumber", "status", "subject", "description", "buyer", "checkoutForm", "offer", "expectations", "openedDate", "createdAt", "decisionDueDate", "chat", "allee" ], "description": "Reklamacja albo dyskusja (Allegro post-purchase issue, BETA)." }, "IssueList": { "type": "object", "properties": { "issues": { "type": "array", "items": { "$ref": "#/components/schemas/Issue" } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "issues", "count", "totalCount" ] }, "IssueChatMessage": { "type": "object", "properties": { "id": { "type": "string" }, "text": { "type": "string" }, "type": { "type": "string", "enum": [ "REGULAR" ] }, "createdAt": { "type": "string", "format": "date-time" }, "author": { "type": "object", "properties": { "login": { "type": "string" }, "role": { "type": "string", "enum": [ "BUYER", "SELLER", "ADMIN" ] } }, "required": [ "login", "role" ] }, "attachments": { "type": "array", "items": { "type": "object", "additionalProperties": true } }, "allee": { "type": "object", "properties": { "sender": { "type": "string", "enum": [ "BUYER", "SELLER", "SYSTEM" ] } }, "required": [ "sender" ] } }, "required": [ "id", "text", "type", "createdAt", "author", "attachments", "allee" ] }, "IssueChat": { "type": "object", "properties": { "chat": { "type": "array", "items": { "$ref": "#/components/schemas/IssueChatMessage" }, "description": "Najstarsza pierwsza (do 200 ostatnich)." } }, "required": [ "chat" ] }, "IssueMessageInput": { "type": "object", "properties": { "text": { "type": "string" }, "type": { "type": "string", "enum": [ "REGULAR" ] }, "attachments": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "maxItems": 0 } }, "required": [ "text" ] }, "IssueStatusInput": { "type": "object", "properties": { "status": { "type": "string", "enum": [ "ACCEPTED", "REJECTED", "RESOLVED", "CLAIM_ACCEPTED", "CLAIM_REJECTED", "DISPUTE_CLOSED" ], "description": "Reklamacja: ACCEPTED/REJECTED; dyskusja: RESOLVED." }, "message": { "type": "string", "description": "Odpowiedź do kupującego (wymagana)." }, "solution": { "type": "string", "description": "Krótko, jak rozwiązano (do 80 znaków)." } }, "required": [ "status", "message" ] }, "NotificationTypeList": { "type": "object", "properties": { "notificationTypes": { "type": "array", "items": { "type": "object", "properties": { "notificationType": { "type": "string" }, "description": { "type": "string" }, "requiredScopes": { "type": "array", "items": { "type": "string" } } }, "required": [ "notificationType", "description", "requiredScopes" ] } }, "signature": { "type": "object", "properties": { "header": { "type": "string", "enum": [ "Allee-Signature" ] }, "format": { "type": "string" }, "toleranceSeconds": { "type": "integer" } }, "required": [ "header", "format", "toleranceSeconds" ] } }, "required": [ "notificationTypes", "signature" ] }, "DestinationInput": { "type": "object", "properties": { "url": { "type": "string", "description": "Adres https Twojego serwera (port 443, publiczny IP, bez przekierowań).", "format": "uri" }, "name": { "type": "string", "description": "Nazwa (do 100 znaków)." }, "resourceSpecification": { "type": "object", "properties": { "url": { "type": "string" } }, "required": [ "url" ], "description": "Alternatywnie kształt Amazona." } }, "required": [ "url" ] }, "Destination": { "type": "object", "properties": { "destinationId": { "type": "string", "format": "uuid" }, "name": { "type": "string" }, "url": { "type": "string" }, "status": { "type": "string", "enum": [ "ACTIVE", "DISABLED" ] }, "disabledReason": { "type": [ "string", "null" ] }, "secretLast4": { "type": "string", "description": "Ostatnie 4 znaki sekretu podpisu." }, "previousSecretExpiresAt": { "type": [ "string", "null" ], "format": "date-time", "description": "Do kiedy podpisujemy też starym sekretem (po rotacji)." }, "verifiedAt": { "type": [ "string", "null" ], "format": "date-time" }, "createdAt": { "type": "string", "format": "date-time" }, "lastSuccessAt": { "type": [ "string", "null" ], "format": "date-time" }, "lastFailureAt": { "type": [ "string", "null" ], "format": "date-time" }, "consecutiveFailures": { "type": "integer" }, "subscriptions": { "type": "array", "items": { "type": "string" }, "description": "Typy subskrybowane na tę destynację." }, "application": { "type": "string", "description": "API albo PANEL." }, "applicationName": { "type": [ "string", "null" ] } }, "required": [ "destinationId", "name", "url", "status", "disabledReason", "secretLast4", "previousSecretExpiresAt", "verifiedAt", "createdAt", "lastSuccessAt", "lastFailureAt", "consecutiveFailures", "subscriptions", "application" ], "description": "Destynacja powiadomień." }, "DestinationCreated": { "allOf": [ { "$ref": "#/components/schemas/Destination" }, { "type": "object", "properties": { "secret": { "type": [ "string", "null" ], "description": "Sekret podpisu allee_whsec_… — pokazany TYLKO RAZ (w powtórce z Idempotency-Key: null)." }, "allee": { "type": "object", "properties": { "secretRedacted": { "type": "boolean" } }, "required": [ "secretRedacted" ] } }, "required": [ "secret" ] } ], "description": "Nowa destynacja + sekret." }, "DestinationList": { "type": "object", "properties": { "destinations": { "type": "array", "items": { "$ref": "#/components/schemas/Destination" } } }, "required": [ "destinations" ] }, "DestinationTestResult": { "type": "object", "properties": { "notificationId": { "type": "string" }, "delivered": { "type": "boolean" }, "httpStatus": { "type": [ "integer", "null" ] }, "durationMs": { "type": "integer" }, "error": { "type": [ "string", "null" ] } }, "required": [ "notificationId", "delivered", "httpStatus", "durationMs", "error" ] }, "SecretRotation": { "type": "object", "properties": { "destinationId": { "type": "string" }, "previousSecretExpiresAt": { "type": [ "string", "null" ], "format": "date-time" }, "secret": { "type": [ "string", "null" ], "description": "Nowy sekret — pokazany raz." }, "allee": { "type": "object", "properties": { "secretRedacted": { "type": "boolean" } }, "required": [ "secretRedacted" ] } }, "required": [ "destinationId", "previousSecretExpiresAt", "secret" ] }, "SubscriptionInput": { "type": "object", "properties": { "destinationId": { "type": "string", "format": "uuid" }, "payloadVersion": { "type": "string", "description": "Bez skutku (1.0)." } }, "required": [ "destinationId" ] }, "Subscription": { "type": "object", "properties": { "subscriptionId": { "type": "string", "format": "uuid" }, "notificationType": { "type": "string" }, "destinationId": { "type": "string" }, "status": { "type": "string", "enum": [ "ACTIVE", "PAUSED" ] }, "createdAt": { "type": "string", "format": "date-time" } }, "required": [ "subscriptionId", "notificationType", "destinationId", "status", "createdAt" ] }, "SubscriptionList": { "type": "object", "properties": { "subscriptions": { "type": "array", "items": { "$ref": "#/components/schemas/Subscription" } } }, "required": [ "subscriptions" ] }, "DeliveryList": { "type": "object", "properties": { "deliveries": { "type": "array", "items": { "type": "object", "properties": { "deliveryId": { "type": "string" }, "notificationId": { "type": "string" }, "notificationType": { "type": "string" }, "destinationId": { "type": "string" }, "status": { "type": "string", "enum": [ "PENDING", "RETRYING", "DELIVERED", "FAILED", "CANCELLED" ] }, "attempts": { "type": "integer" }, "lastHttpStatus": { "type": [ "integer", "null" ] }, "lastDurationMs": { "type": [ "integer", "null" ] }, "lastError": { "type": [ "string", "null" ] }, "createdAt": { "type": "string", "format": "date-time" }, "nextAttemptAt": { "type": [ "string", "null" ], "format": "date-time" }, "deliveredAt": { "type": [ "string", "null" ], "format": "date-time" } }, "required": [ "deliveryId", "notificationId", "notificationType", "destinationId", "status", "attempts", "lastHttpStatus", "lastDurationMs", "lastError", "createdAt", "nextAttemptAt", "deliveredAt" ] } }, "totalCount": { "type": "integer" }, "count": { "type": "integer" } }, "required": [ "deliveries", "totalCount", "count" ], "description": "Dziennik dostaw (30 dni)." }, "NotificationOrderChange": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "ORDER_CHANGE" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "orderChange": { "type": "object", "properties": { "eventId": { "type": "string" }, "eventType": { "type": "string", "description": "Typ zdarzenia jak w /order/events." }, "orderId": { "type": [ "string", "null" ] }, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "orderStatus": { "type": [ "string", "null" ] }, "fulfillmentStatus": { "type": [ "string", "null" ] }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "eventId", "eventType", "orderId", "from", "to", "orderStatus", "fulfillmentStatus", "occurredAt" ] } }, "required": [ "orderChange" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "ORDER_CHANGE — zmiana zamówienia." }, "NotificationOfferStatusChange": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "OFFER_STATUS_CHANGE" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "offer": { "type": "object", "properties": { "id": { "type": "string" }, "sku": { "type": [ "string", "null" ] } }, "required": [ "id", "sku" ] }, "eventType": { "type": "string" }, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "reason": { "type": [ "string", "null" ], "enum": [ "IMAGE_FAILED", "MODERATION", "EMPTY_STOCK", null ] }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "offer", "eventType", "from", "to", "reason", "occurredAt" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "OFFER_STATUS_CHANGE — aktywacja, zakończenie." }, "NotificationOfferIssuesChange": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "OFFER_ISSUES_CHANGE" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "offer": { "type": "object", "properties": { "id": { "type": "string" }, "sku": { "type": [ "string", "null" ] } }, "required": [ "id", "sku" ] }, "reason": { "type": "string", "enum": [ "IMAGE_FAILED", "MODERATION" ] }, "issues": { "type": "array", "items": { "$ref": "#/components/schemas/ListingIssue" } }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "offer", "reason", "issues", "occurredAt" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "OFFER_ISSUES_CHANGE — nowe problemy oferty." }, "NotificationMessageReceived": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "MESSAGE_RECEIVED" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "message": { "type": "object", "properties": { "id": { "type": "string" }, "threadId": { "type": "string" }, "sentAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "threadId", "sentAt" ] }, "thread": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string" }, "relatesTo": { "type": "object", "properties": { "orderId": { "type": [ "string", "null" ] }, "offerId": { "type": [ "string", "null" ] } }, "required": [ "orderId", "offerId" ] } }, "required": [ "id", "type", "relatesTo" ] } }, "required": [ "message", "thread" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "MESSAGE_RECEIVED — nowa wiadomość kupującego (bez treści — pobierz GET /messaging/messages/{id})." }, "NotificationReturnChange": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "RETURN_CHANGE" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "customerReturn": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "orderId": { "type": [ "string", "null" ] }, "eventType": { "type": "string" }, "status": { "type": [ "string", "null" ] }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "orderId", "eventType", "status", "occurredAt" ] } }, "required": [ "customerReturn" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "RETURN_CHANGE — zwrot." }, "NotificationIssueChange": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "ISSUE_CHANGE" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "issue": { "type": "object", "properties": { "id": { "type": [ "string", "null" ] }, "orderId": { "type": [ "string", "null" ] }, "eventType": { "type": "string" }, "from": { "type": [ "string", "null" ] }, "to": { "type": [ "string", "null" ] }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "orderId", "eventType", "from", "to", "occurredAt" ] } }, "required": [ "issue" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "ISSUE_CHANGE — reklamacja lub dyskusja." }, "NotificationFeedFinished": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "FEED_PROCESSING_FINISHED" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "feedId": { "type": "string" }, "feedType": { "type": "string" }, "processingStatus": { "type": "string", "enum": [ "DONE", "FATAL", "CANCELLED" ] }, "summary": { "type": "object", "properties": { "messagesProcessed": { "type": "integer" }, "messagesAccepted": { "type": "integer" }, "messagesInvalid": { "type": "integer" } }, "required": [ "messagesProcessed", "messagesAccepted", "messagesInvalid" ] } }, "required": [ "feedId", "feedType", "processingStatus", "summary" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "FEED_PROCESSING_FINISHED — wsad przetworzony." }, "NotificationReportFinished": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "REPORT_PROCESSING_FINISHED" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "reportId": { "type": "string" }, "reportType": { "type": "string" }, "processingStatus": { "type": "string", "enum": [ "DONE", "FATAL" ] }, "reportDocumentId": { "type": [ "string", "null" ] } }, "required": [ "reportId", "reportType", "processingStatus", "reportDocumentId" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "REPORT_PROCESSING_FINISHED — raport gotowy." }, "NotificationSellerComplianceChanged": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "SELLER_COMPLIANCE_CHANGED" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "sellerId": { "type": "string" }, "previousStatus": { "type": "string", "enum": [ "ACTIVE", "INCOMPLETE", "RESTRICTED", "SUSPENDED", "CLOSED" ] }, "status": { "type": "string", "enum": [ "ACTIVE", "INCOMPLETE", "RESTRICTED", "SUSPENDED", "CLOSED" ] }, "summary": { "type": "object", "properties": { "errors": { "type": "integer" }, "warnings": { "type": "integer" } }, "required": [ "errors", "warnings" ] }, "missingCodes": { "type": "array", "items": { "type": "string" } } }, "required": [ "sellerId", "previousStatus", "status", "summary", "missingCodes" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "SELLER_COMPLIANCE_CHANGED — zmienił się stan zgodności (status, braki, oświadczenia albo blokada). Szczegóły: GET /allee/sellers/compliance. Bez danych osobowych." }, "NotificationSecurityEvent": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "API_KEY_SECURITY_EVENT" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "securityEvent": { "type": "object", "properties": { "id": { "type": "string" }, "type": { "type": "string", "description": "np. kwarantanna, nowa_siec, ip_poza_lista, refresh_replay." }, "severity": { "type": "string", "enum": [ "INFO", "UWAGA", "ALARM" ] }, "keyId": { "type": [ "string", "null" ] }, "occurredAt": { "type": "string", "format": "date-time" } }, "required": [ "id", "type", "severity", "keyId", "occurredAt" ] } }, "required": [ "securityEvent" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "API_KEY_SECURITY_EVENT — zdarzenie bezpieczeństwa klucza lub aplikacji." }, "NotificationTest": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "TEST_NOTIFICATION" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "destinationId": { "type": "string" }, "message": { "type": "string" } }, "required": [ "destinationId", "message" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "TEST_NOTIFICATION — wysyłane przez …/test." }, "NotificationVerification": { "type": "object", "properties": { "notificationId": { "type": "string", "description": "Identyfikator powiadomienia (UUID) — ten sam przy ponowieniach; użyj go do odrzucania duplikatów.", "format": "uuid" }, "notificationType": { "type": "string", "enum": [ "DESTINATION_VERIFICATION" ] }, "notificationVersion": { "type": "string", "enum": [ "1.0" ] }, "eventTime": { "type": "string", "format": "date-time", "description": "Czas zdarzenia (UTC)." }, "sellerId": { "type": "string", "description": "Identyfikator konta sprzedawcy." }, "payload": { "type": "object", "properties": { "destinationId": { "type": "string" }, "challenge": { "type": "string", "description": "Odeślij tę wartość w treści odpowiedzi 2xx: {\"challenge\": \"…\"}." } }, "required": [ "destinationId", "challenge" ] } }, "required": [ "notificationId", "notificationType", "notificationVersion", "eventTime", "sellerId", "payload" ], "description": "DESTINATION_VERIFICATION — weryfikacja adresu przy zakładaniu destynacji." }, "BillingTypeList": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "description": { "type": "string" } }, "required": [ "id", "description" ] }, "description": "Typy operacji rozliczeniowych (dziś pusta lista — allee nie pobiera opłat)." }, "BillingEntryList": { "type": "object", "properties": { "billingEntries": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "occurredAt": { "type": "string", "format": "date-time" }, "type": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": [ "string", "null" ] } }, "required": [ "id", "name" ] }, "offer": { "type": [ "object", "null" ], "properties": { "id": { "type": "string" }, "name": { "type": [ "string", "null" ] } }, "required": [ "id", "name" ] }, "value": { "$ref": "#/components/schemas/Money" }, "tax": { "type": [ "object", "null" ], "properties": { "percentage": { "type": "string" } }, "required": [ "percentage" ] }, "balance": { "anyOf": [ { "$ref": "#/components/schemas/Money" }, { "type": "null" } ] }, "order": { "anyOf": [ { "$ref": "#/components/schemas/IdRef" }, { "type": "null" } ] } }, "required": [ "id", "occurredAt", "type", "offer", "value", "tax", "balance", "order" ], "additionalProperties": true } }, "count": { "type": "integer" }, "totalCount": { "type": "integer" } }, "required": [ "billingEntries", "count", "totalCount" ], "description": "Operacje rozliczeniowe (Allegro /billing/billing-entries)." }, "TokenResponse": { "type": "object", "properties": { "access_token": { "type": "string", "description": "Token dostępu (12 h). Nowe aplikacje: allee_at_…" }, "token_type": { "type": "string", "enum": [ "bearer" ] }, "refresh_token": { "type": "string", "description": "Refresh token (90 dni, rotacja przy każdym użyciu). Brak przy client_credentials." }, "expires_in": { "type": "integer", "description": "Ważność access tokenu w sekundach (43200)." }, "scope": { "type": "string", "description": "Przyznane zakresy rozdzielone spacją — zapisz je." }, "jti": { "type": "string" }, "allee": { "type": "object", "additionalProperties": true } }, "required": [ "access_token", "token_type", "expires_in", "scope" ], "description": "Odpowiedź /auth/oauth/token (RFC 6749 §5.1)." }, "RevokeResponse": { "type": "object", "properties": { "revoked": { "type": "boolean", "enum": [ true ] } }, "required": [ "revoked" ], "description": "Zawsze true po poprawnym uwierzytelnieniu klienta (RFC 7009)." }, "SandboxOrderInput": { "type": "object", "properties": { "offerId": { "type": "string", "description": "Oferta konta demo (np. offers.sampleOfferId z GET /allee/sandbox)." }, "quantity": { "type": "integer", "description": "1–100.", "minimum": 1, "maximum": 100 }, "paymentType": { "type": "string", "enum": [ "ONLINE", "CASH_ON_DELIVERY" ] }, "status": { "type": "string", "enum": [ "BOUGHT", "FILLED_IN", "READY_FOR_PROCESSING" ], "description": "Do którego etapu doprowadzić zakup." }, "deliveryMethodId": { "type": "string", "description": "Metoda dostawy ze słownika." }, "invoice": { "type": "boolean", "description": "Kupujący chce faktury (NIP)." }, "messageToSeller": { "type": "string" } }, "required": [ "offerId" ], "description": "Zamówienie kupującego demo." }, "SandboxReturnInput": { "type": "object", "properties": { "checkoutFormId": { "type": "string", "description": "Zamówienie wysłane (po SENT)." }, "lineItems": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "quantity": { "type": "integer" } }, "required": [ "id" ] } }, "reason": { "type": "string", "enum": [ "Bez podania przyczyny", "Nie spełnia oczekiwań", "Zamówiłem przez pomyłkę", "Znalazłem taniej", "Inny wariant niż zamówiony", "Inny powód" ], "description": "Powód z listy formularza zwrotu allee.pl (inna wartość = „Bez podania przyczyny”)." } }, "required": [ "checkoutFormId" ], "description": "Zwrot kupującego demo." }, "SandboxReturnCreated": { "type": "object", "properties": { "id": { "type": "string" }, "referenceNumber": { "type": "string" }, "orderId": { "type": "string" }, "status": { "type": "string", "enum": [ "CREATED" ] } }, "required": [ "id", "referenceNumber", "orderId", "status" ] }, "SandboxMessageInput": { "type": "object", "properties": { "text": { "type": "string" }, "checkoutFormId": { "type": "string", "description": "Wiadomość w sprawie zamówienia…" }, "offerId": { "type": "string", "description": "…albo pytanie o ofertę." } }, "required": [ "text" ], "description": "Wiadomość kupującego demo." }, "SandboxMessageCreated": { "type": "object", "properties": { "thread": { "$ref": "#/components/schemas/IdRef" }, "message": { "$ref": "#/components/schemas/IdRef" } }, "required": [ "thread", "message" ] }, "LeakReportItem": { "type": "object", "properties": { "token": { "type": "string", "description": "Wykryty sekret." }, "type": { "type": "string", "description": "Typ wzorca u GitHuba." }, "url": { "type": "string", "description": "Gdzie znaleziono." }, "source": { "type": "string" } }, "required": [ "token" ], "description": "Pozycja zgłoszenia GitHub secret scanning.", "additionalProperties": true }, "LeakReportResult": { "type": "array", "items": { "type": "object", "properties": { "token_hash": { "type": "string", "description": "SHA-256 tokenu (zamiast jawnego)." }, "token_type": { "type": "string" }, "label": { "type": "string", "enum": [ "true_positive", "false_positive" ] } }, "required": [ "token_hash", "token_type", "label" ] } } }, "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "bearerFormat": "allee_sk_live_… | allee_sk_test_… | token OAuth", "description": "Nagłówek `Authorization: Bearer …`:\n- **klucz osobisty** sprzedawcy z panelu (Klucze API): `allee_sk_live_…` (produkcja) albo `allee_sk_test_…` (sandbox) — zakresy wybrane przy tworzeniu klucza;\n- **access token OAuth** aplikacji (12 h) — zakresy ze zgody sprzedawcy." }, "oauth2": { "type": "oauth2", "description": "OAuth 2.0 zgodny z Allegro: Authorization Code z PKCE (tylko S256), rotacja refresh tokenów, token aplikacji (client_credentials) do danych publicznych.", "flows": { "authorizationCode": { "authorizationUrl": "https://api.allee.pl/auth/oauth/authorize", "tokenUrl": "https://api.allee.pl/auth/oauth/token", "refreshUrl": "https://api.allee.pl/auth/oauth/token", "scopes": { "allegro:api:profile:read": "Odczyt danych konta (login, e-mail, dane firmy)", "allegro:api:sale:offers:read": "Odczyt Twoich ofert", "allegro:api:sale:offers:write": "Wystawianie i zmiana ofert (cena, stan, zakończenie)", "allegro:api:sale:settings:read": "Odczyt ustawień sprzedaży (cenniki dostaw, warunki, GPSR)", "allegro:api:sale:settings:write": "Zmiana ustawień sprzedaży (cenniki dostaw, warunki, GPSR)", "allegro:api:orders:read": "Odczyt zamówień z allee.pl", "allegro:api:orders:write": "Obsługa zamówień (status realizacji, numery przesyłek)", "allegro:api:billing:read": "Odczyt rozliczeń", "allegro:api:messaging": "Wiadomości z kupującymi (odczyt i odpowiedzi)", "allegro:api:disputes": "Dyskusje i reklamacje (odczyt i odpowiedzi)", "allegro:api:messaging:read": "Odczyt wiadomości z kupującymi (bez wysyłania)", "allegro:api:messaging:write": "Wysyłanie wiadomości do kupujących i oznaczanie rozmów jako przeczytane", "allegro:api:disputes:read": "Odczyt dyskusji i reklamacji (bez odpowiedzi i decyzji)", "allegro:api:disputes:write": "Odpowiedzi w dyskusjach i reklamacjach, uznanie lub odrzucenie reklamacji", "allegro:api:shipments:read": "Odczyt przesyłek i ich śledzenia", "allegro:api:shipments:write": "Nadawanie przesyłek i numerów przesyłek", "allee:api:orders:pii": "Dane osobowe kupujących: imię, nazwisko, adres, telefon i e-mail", "allee:api:notifications": "Powiadomienia push o zdarzeniach na koncie (subskrypcje)", "allee:api:reports": "Raporty (zestawienia ofert, zamówień i rozliczeń)" } }, "clientCredentials": { "tokenUrl": "https://api.allee.pl/auth/oauth/token", "scopes": {} } } }, "clientBasic": { "type": "http", "scheme": "basic", "description": "Uwierzytelnienie aplikacji na /auth/oauth/token i /revoke: client_id:client_secret." } }, "parameters": { "IdempotencyKey": { "name": "Idempotency-Key", "in": "header", "required": false, "description": "Ochrona przed podwójnym wykonaniem (jak Stripe/Amazon): powtórzony POST z tym samym kluczem i tą samą treścią w ciągu 24 h zwraca zapisaną odpowiedź z nagłówkiem `Idempotent-Replayed: true` i niczego nie wykonuje drugi raz. Inna treść → 422 `IDEMPOTENCY_KEY_REUSED`; żądanie jeszcze trwa → 409 `IDEMPOTENCY_KEY_IN_USE`. 1–100 znaków ASCII (np. UUID).", "schema": { "type": "string", "maxLength": 100, "pattern": "^[\\x21-\\x7E]{1,100}$" } } }, "headers": { "X-Request-Id": { "description": "Identyfikator żądania (16 znaków szesnastkowych) — podawaj przy zgłoszeniach.", "schema": { "type": "string" } }, "X-RateLimit-Limit": { "description": "Limit żądań na minutę dla pary aplikacja × sprzedawca (klucz).", "schema": { "type": "integer" } }, "X-RateLimit-Remaining": { "description": "Ile żądań zostało w bieżącej minucie.", "schema": { "type": "integer" } }, "X-RateLimit-Reset": { "description": "Sekundy do odnowienia okna minutowego.", "schema": { "type": "integer" } }, "X-Allee-RateLimit": { "description": "Plan i grupa limitu tej operacji: plan=pro; group=read; rate=50; burst=150 (tylko plany start/standard/pro).", "schema": { "type": "string" } }, "X-Allee-Mode": { "description": "„test” — odpowiedź z sandboxu (klucz testowy).", "schema": { "type": "string", "enum": [ "test" ] } }, "Retry-After": { "description": "Po ilu sekundach ponowić.", "schema": { "type": "integer" } }, "Location": { "description": "Adres utworzonego zasobu albo przekierowania.", "schema": { "type": "string" } }, "ETag": { "description": "Wersja zasobu — do If-None-Match.", "schema": { "type": "string" } }, "Idempotent-Replayed": { "description": "true — odpowiedź odtworzona z Idempotency-Key.", "schema": { "type": "string", "enum": [ "true" ] } }, "WWW-Authenticate": { "description": "Bearer realm=\"allee\", error=\"invalid_token\" (albo Basic realm=\"allee\" na /token).", "schema": { "type": "string" } } } }, "externalDocs": { "description": "Portal dla deweloperów allee.pl (przewodniki, przykłady w 7 językach)", "url": "https://allee.pl/dla-deweloperow" } }