Dokumentacja API

Dokumentacja API Pasejo

REST API z pełną dokumentacją OpenAPI/Swagger. Integruj swój sklep z dowolnym systemem zewnętrznym.

Przegląd API

Pasejo udostępnia RESTful API z autentykacją JWT, obsługą wielu tenantów i pełną dokumentacją OpenAPI.

REST API

Standardowy REST API z JSON payload. Wersjonowane endpointy (v1).

Base URL: https://api.pasejo.pl/api/v1

Autentykacja

JWT Bearer Token dla klientów, SSO Cookie dla adminów, API Key (X-Shop-Id) dla identyfikacji tenanta.

OpenAPI 3.0

Pełna specyfikacja OpenAPI ze Swagger UI. Testuj endpointy bezpośrednio z przeglądarki.

Główne grupy endpointów

API dzieli się na dwie części: Storefront (publiczne) i Admin (wymaga autoryzacji).

Storefront API

GET/v1/storefront/products

Katalog produktów, warianty, filtrowanie i wyszukiwanie.

GET/v1/storefront/categories

Drzewo kategorii produktowych.

GET/v1/storefront/cart

Koszyk zakupowy — dodawanie, edycja, usuwanie pozycji.

GET/v1/storefront/orders

Składanie zamówień i śledzenie statusów.

GET/v1/storefront/payments

Inicjowanie płatności i obsługa callbacków.

GET/v1/storefront/search

Wyszukiwanie pełnotekstowe produktów.

GET/v1/auth/login

Logowanie klientów i zarządzanie sesjami.

Admin API

CRUD/v1/admin/products

Zarządzanie katalogiem produktów, wariantami i zdjęciami.

CRUD/v1/admin/orders

Obsługa zamówień, statusy, faktury.

CRUD/v1/admin/categories

Zarządzanie drzewem kategorii.

CRUD/v1/admin/settings

Konfiguracja sklepu, domeny, płatności, wysyłka.

CRUD/v1/admin/files

Upload i zarządzanie plikami mediów.

CRUD/v1/admin/promo-codes

Kody rabatowe i kampanie promocyjne.

CRUD/v1/admin/stats

Statystyki sprzedaży, konwersji i ruchu.

Szybki start

Rozpocznij integrację w kilka minut.

1. Uzyskaj token

Zaloguj się przez /v1/auth/login aby otrzymać JWT token. Użyj go w nagłówku Authorization: Bearer <token>.

2. Wybierz sklep

Dodaj nagłówek X-Shop-Id z identyfikatorem Twojego sklepu do każdego zapytania.

3. Wywołaj API

Używaj standardowych metod HTTP: GET, POST, PUT, PATCH, DELETE. Odpowiedzi w formacie JSON.