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.
Uzyskanie tokenu
Dział zatytułowany „Uzyskanie tokenu”Z panelu (zalecane na start)
Dział zatytułowany „Z panelu (zalecane na start)”- Zaloguj się do panelu Sellrocket.
- Otwórz menu konta i wybierz Generuj klucz API OMS.
- Skopiuj token — jest ważny 30 dni.
Przez API — odnawianie tokenu
Dział zatytułowany „Przez API — odnawianie tokenu”Mając ważny token, możesz wygenerować kolejny — z własnym czasem życia:
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.
Ograniczenia tokenu
Dział zatytułowany „Ograniczenia tokenu”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ę
401z 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:Failedz kodem403). 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.
Wygaśnięcie i błędy
Dział zatytułowany „Wygaśnięcie i błędy”| 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 |
Dobre praktyki
Dział zatytułowany „Dobre praktyki”- 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).

