Przejdź do treści

Konto sprzedawcy

GET /me

zgodna z Allegroallegro:api:profile:readlimit: read

Dane konta, do którego należy token lub klucz. Konto nieaktywne → 403 ACCOUNT_INACTIVE z details: {id, login}.

Zgodność: zgodna z Allegro REST API (ten sam kształt) — GET /me.
Uprawnienie: zakres allegro:api:profile:read.
Grupa limitu: read.

Odpowiedzi

200 Konto. · Me
id string zawsze

Identyfikator konta sprzedawcy.

login string zawsze

Login na allee.pl.

email string zawsze

E-mail konta.

firstName string · null zawsze

allee nie przechowuje imienia — zawsze null.

lastName string · null zawsze

Zawsze null.

company object · null zawsze

Dane firmy — tylko konto firmowe; null dla konta prywatnego.

Pola obiektu
name string · null zawsze

Nazwa firmy.

taxId string · null zawsze

NIP.

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/me" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "id": "980000001",
  "login": "sklep_przykladowy_0e60e9",
  "email": "[email protected]",
  "firstName": null,
  "lastName": null,
  "company": {
    "name": null,
    "taxId": null
  }
}

Co może ten token lub klucz

GET /me/token

tylko alleelimit: read

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).

Zgodność: tylko allee — Stripe/Amazon: introspekcja poświadczenia.
Uprawnienie: dowolny ważny token lub klucz.
Grupa limitu: read.

Odpowiedzi

200 Poświadczenie. · TokenInfo
type string zawsze

Rodzaj poświadczenia.

Wartości: OAUTH_ACCESS_TOKEN, PERSONAL_API_KEY, APPLICATION_TOKEN
key object · null zawsze

Tylko dla klucza osobistego.

Pola obiektu
id string zawsze

Numer klucza osobistego (bez sekretu).

application object zawsze

Aplikacja (dla kluczy osobistych: ukryta aplikacja „Klucze osobiste”; w trybie test pola są null).

Pola obiektu
clientId string · null zawsze

client_id aplikacji.

name string · null zawsze

Nazwa aplikacji.

user object zawsze
Pola obiektu
id string zawsze
login string · null zawsze

Login (w trybie test null).

active boolean zawsze

Czy konto sprzedawcy jest aktywne.

scopes array<string> zawsze

Zakresy tego poświadczenia (nazwy z przedrostkiem allegro:api: albo allee:api:).

expiresAt string · date-time · null zawsze

Kiedy token/klucz wygasa; null = bezterminowy klucz.

usagePlan UsagePlan zawsze

Plan użycia i limity.

Pola obiektu
name string zawsze

Plan użycia: „allegro” = aplikacje sprzed kluczy (okno minutowe), start/standard/pro = limity grup GCRA.

Wartości: allegro, start, standard, pro
perMinute integer zawsze

Sufit żądań na minutę dla pary aplikacja × sprzedawca (nagłówek X-RateLimit-Limit).

groups object · null zawsze

Limity grup operacji (algorytm GCRA); null w planie „allegro” (tylko okno minutowe).

Pola obiektu
read RateGroup zawsze

Limit grupy operacji.

Pola obiektu
rate number zawsze

Stałe tempo: żądań na sekundę.

burst integer zawsze

Ile żądań naraz ponad tempo.

write RateGroup zawsze

Limit grupy operacji.

Pola obiektu
rate number zawsze

Stałe tempo: żądań na sekundę.

burst integer zawsze

Ile żądań naraz ponad tempo.

bulk RateGroup zawsze

Limit grupy operacji.

Pola obiektu
rate number zawsze

Stałe tempo: żądań na sekundę.

burst integer zawsze

Ile żądań naraz ponad tempo.

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/me/token" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "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
      }
    }
  }
}

Konto, plan użycia i ograniczenia

GET /allee/sellers/account

wzór Amazon SP-APIallegro:api:profile:readlimit: read

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.

Zgodność: wzorowana na Amazon Selling Partner API — Sellers — getMarketplaceParticipations + nagłówki limitów.
Uprawnienie: zakres allegro:api:profile:read.
Grupa limitu: read.

Odpowiedzi

200 Konto. · SellerAccount
sellerId string zawsze
login string zawsze
accountType string zawsze

Konto firmowe albo prywatne.

Wartości: BUSINESS, INDIVIDUAL
status string zawsze
Wartości: ACTIVE, INACTIVE
businessVerification object · null zawsze

Tylko konto firmowe.

Pola obiektu
status string zawsze

Weryfikacja firmy w rejestrach (NIP).

Wartości: VERIFIED, PENDING, FAILED, MISSING, NOT_STARTED
checkedAt string · date-time · null zawsze
taxId string · null zawsze

NIP.

companyName string · null zawsze
createdAt string · date-time · null zawsze

Data założenia konta.

marketplace Marketplace zawsze

Rynek.

Pola obiektu
id string zawsze
Wartości: allee-pl
countryCode string zawsze
Wartości: PL
currency string zawsze
Wartości: PLN
language string zawsze
Wartości: pl-PL
usagePlan UsagePlan zawsze

Plan użycia i limity.

Pola obiektu
name string zawsze

Plan użycia: „allegro” = aplikacje sprzed kluczy (okno minutowe), start/standard/pro = limity grup GCRA.

Wartości: allegro, start, standard, pro
perMinute integer zawsze

Sufit żądań na minutę dla pary aplikacja × sprzedawca (nagłówek X-RateLimit-Limit).

groups object · null zawsze

Limity grup operacji (algorytm GCRA); null w planie „allegro” (tylko okno minutowe).

Pola obiektu
read RateGroup zawsze

Limit grupy operacji.

Pola obiektu
rate number zawsze

Stałe tempo: żądań na sekundę.

burst integer zawsze

Ile żądań naraz ponad tempo.

write RateGroup zawsze

Limit grupy operacji.

Pola obiektu
rate number zawsze

Stałe tempo: żądań na sekundę.

burst integer zawsze

Ile żądań naraz ponad tempo.

bulk RateGroup zawsze

Limit grupy operacji.

Pola obiektu
rate number zawsze

Stałe tempo: żądań na sekundę.

burst integer zawsze

Ile żądań naraz ponad tempo.

rateLimitHeader string · null zawsze

Dokładnie to, co zawiera nagłówek X-Allee-RateLimit tej odpowiedzi (null w planie allegro).

credential object zawsze

Poświadczenie tego żądania.

Pola obiektu
type string zawsze
Wartości: OAUTH_ACCESS_TOKEN, PERSONAL_API_KEY, APPLICATION_TOKEN
keyId string · null zawsze
scopes array<string> zawsze
expiresAt string · date-time · null zawsze
offers object zawsze
Pola obiektu
active integer zawsze

Aktywne oferty.

all integer zawsze

Wszystkie oferty konta (sprzedawca, API, integracje).

ordersIntegration object zawsze
Pola obiektu
owner string zawsze

Kto obsługuje zamówienia allee.pl tego sprzedawcy (jedna integracja naraz).

Wartości: PANEL, THIS_APPLICATION, OTHER_APPLICATION, BASELINKER
restrictions array<object> zawsze

Ograniczenia konta, które wpływają na API.

Pola obiektu
code string zawsze
Wartości: ACCOUNT_INACTIVE, QUARANTINE_READ_ONLY, SUSPENDED, ADULT_CONTENT_NOT_CONFIRMED, PRIVATE_ACCOUNT_LIMITS
message string zawsze

Błędy

HTTPKodZnaczenie
401invalid_tokenBrak, zły, wygasły albo odwołany token lub klucz (format OAuth, nagłówek WWW-Authenticate).
403ACCOUNT_INACTIVEKonto sprzedawcy jest nieaktywne.
403AccessDeniedBrak zakresu albo zasób innego sprzedawcy.
403KEY_QUARANTINEDKwarantanna: działa tylko odczyt (wykryto nietypowe użycie).
403KEY_SUSPENDEDKlucz albo dostęp aplikacji wstrzymany (przez sprzedawcę albo ochronę).
404NOT_FOUNDNie ma takiego zasobu (albo należy do innego sprzedawcy — dla wątków, zwrotów i spraw odpowiedź jest ta sama).
429TOO_MANY_REQUESTSPrzekroczony limit (minutowy, grupy operacji albo IP).
500INTERNAL_ERRORBłąd serwera allee.
Przykład
curl -sS -X GET "${ALLEE_API_URL:-https://api.allee.pl}/allee/sellers/account" \
  -H "Authorization: Bearer $ALLEE_API_KEY" \
  -H "Accept: application/vnd.allegro.public.v1+json" \
  -w '\nHTTP %{http_code}\n'
Odpowiedź (środowisko testowe)
HTTP 200 application/vnd.allegro.public.v1+json
{
  "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."
    }
  ]
}