Przejdź do głównej zawartości

Uwierzytelnianie

Wszystkie serwisy REST Sellrocket używają tokenów JWT przekazywanych w nagłówku:

Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...

Token jest wystawiany dla konkretnego użytkownika instancji i ma jego uprawnienia (role). Ten sam token działa we wszystkich serwisach tej instancji — OMS, PIM, pola elastyczne, automatyzacje itd.

  1. Zaloguj się do panelu Sellrocket.
  2. Otwórz menu konta i wybierz Generuj klucz API OMS.
  3. Skopiuj token — jest ważny 30 dni.

Mając ważny token, możesz wygenerować kolejny — z własnym czasem życia:

Okno terminala
curl -X POST "https://{instancja}-smerp-api.enterprise.sellrocket.pl/api/v3/Tokens" \
-H "Authorization: Bearer $SR_TOKEN" \
-H "Content-Type: application/json" \
-d '{ "expiresInSeconds": 2592000 }'
{
"success": true,
"jwt": "eyJhbGciOi...",
"issuedAt": "2026-10-05T10:00:00Z",
"expiredAt": "2026-11-04T10:00:00Z"
}
Pole żądania Opis
expiresInSeconds Czas życia nowego tokenu w sekundach. Domyślnie 30 dni.
apiRateLimit Opcjonalny, niższy limit zapytań na minutę dla tego tokenu (np. dla mniej zaufanego systemu). Musi być większy od 0 (inaczej 400); wartość wyższa niż limit użytkownika zostanie obniżona do tego limitu.

Zalecany wzorzec: przechowuj token w bezpiecznym magazynie sekretów i odnawiaj go automatycznie kilka dni przed expiredAt. Tokeny nie mają mechanizmu refresh token — odnowienie to po prostu wystawienie nowego.

Referencja: Tokeny API.

Administrator instancji może dla każdego użytkownika ustawić (Uprawnienia):

  • Dozwolone adresy IP — token działa tylko z wymienionych adresów (dokładne dopasowanie, bez zakresów CIDR). Żądanie z innego adresu kończy się 401 z treścią IP address is not allowed.
  • Limit zapytań — maksymalna liczba zapytań na minutę.
  • Dostęp do statusów — jeśli użytkownik ma ograniczoną listę statusów, widzi przez API tylko zamówienia w tych statusach, a zmiana zamówienia w statusie bez prawa zapisu (np. oznaczonym jako „tylko do odczytu”) kończy się 403 (w zadaniu asynchronicznym: Failed z kodem 403). To ograniczenie jest sprawdzane przy każdym żądaniu i nie dotyczy administratorów. Przy problemach z „brakującymi” zamówieniami sprawdź najpierw listę statusów użytkownika integracyjnego.
Sytuacja Odpowiedź
Brak tokenu / token nieprawidłowy 401 Unauthorized
Token wygasł 401 (część serwisów dodaje nagłówek Token-Expired: true)
Adres IP spoza listy dozwolonych 401, treść IP address is not allowed
Brak uprawnień do operacji lub do zamówienia w danym statusie 403 Forbidden
  • Traktuj token jak hasło — nie umieszczaj go w kodzie frontendowym ani w repozytorium.
  • Ustaw listę dozwolonych IP dla użytkownika integracyjnego, jeśli Twoje serwery mają stałe adresy.
  • Wygenerowanego tokenu nie da się unieważnić przed czasem — wybieraj rozsądny czas życia (dni/tygodnie, nie lata).