Przejdź do treści

Klucz osobisty czy OAuth

Klucz osobistyAplikacja OAuth
Dla kogoSprzedawca integruje własne konto (sklep, ERP, skrypt)Integrator obsługujący wielu sprzedawców (jak SelleeTools)
Jak zacząćPanel sprzedaży → Klucze API → Nowy klucz (od ręki)Panel → Klucze API → Własne aplikacje. Prywatna działa od razu dla Twojego konta; publiczną (dla innych sprzedawców) zatwierdza allee
NagłówekAuthorization: Bearer allee_sk_live_…Authorization: Bearer <access_token> (12 h, odświeżany)
UprawnieniaWybierasz przy tworzeniu klucza (presety albo pojedyncze zakresy)Zakresy z parametru scope, zatwierdza sprzedawca na stronie zgody
Ważność30, 90, 180, 365 dni albo bezterminowo; rotacja z oknemAccess 12 h, refresh 90 dni z rotacją
OchronaLista IP, osobny limit, monitoring każdego klucza w paneluMonitoring pary aplikacja × sprzedawca, kwarantanna
WzórStripe API keys, Amazon self-authorizationAllegro REST API (1:1)

Uprawnienia kluczy (presety panelu)

Uprawnienia w paneluZakresy
Tylko odczytprofile:read sale:offers:read sale:settings:read orders:read shipments:read billing:read
Oferty i magazynprofile:read sale:offers:read sale:offers:write sale:settings:read sale:settings:write
Zamówienia i wysyłkaprofile:read sale:offers:read orders:read orders:write shipments:read shipments:write
Obsługa klientaprofile:read orders:read messaging disputes
Pełny dostępprofile:read sale:offers:read sale:offers:write sale:settings:read sale:settings:write orders:read orders:write billing:read messaging disputes shipments:read shipments:write notifications reports

Dane osobowe kupujących (adres, telefon, e-mail) to osobny przełącznik — zakres allee:api:orders:pii. Zobacz Dane osobowe kupujących.

Wszystkie zakresy

ZakresCo daje
allegro:api:profile:readOdczyt danych konta (login, e-mail, dane firmy)
allegro:api:sale:offers:readOdczyt Twoich ofert
allegro:api:sale:offers:writeWystawianie i zmiana ofert (cena, stan, zakończenie)
allegro:api:sale:settings:readOdczyt ustawień sprzedaży (cenniki dostaw, warunki, GPSR)
allegro:api:sale:settings:writeZmiana ustawień sprzedaży (cenniki dostaw, warunki, GPSR)
allegro:api:orders:readOdczyt zamówień z allee.pl
allegro:api:orders:writeObsługa zamówień (status realizacji, numery przesyłek)
allegro:api:billing:readOdczyt rozliczeń
allegro:api:messagingWiadomości z kupującymi (odczyt i odpowiedzi)
allegro:api:disputesDyskusje i reklamacje (odczyt i odpowiedzi)
allegro:api:messaging:readOdczyt wiadomości z kupującymi (bez wysyłania)
allegro:api:messaging:writeWysyłanie wiadomości do kupujących i oznaczanie rozmów jako przeczytane
allegro:api:disputes:readOdczyt dyskusji i reklamacji (bez odpowiedzi i decyzji)
allegro:api:disputes:writeOdpowiedzi w dyskusjach i reklamacjach, uznanie lub odrzucenie reklamacji
allegro:api:shipments:readOdczyt przesyłek i ich śledzenia
allegro:api:shipments:writeNadawanie przesyłek i numerów przesyłek
allee:api:orders:piiDane osobowe kupujących: imię, nazwisko, adres, telefon i e-mail
allee:api:notificationsPowiadomienia push o zdarzeniach na koncie (subskrypcje)
allee:api:reportsRaporty (zestawienia ofert, zamówień i rozliczeń)

Nazwy z przedrostkiem allegro:api: i allee:api: są równoważne (poza zakresami tylko allee). Introspekcja: GET /me/token.

curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/me/token" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'