v2.0.0

Partner Portal API

Unified People-based authentication z multi-role RBAC, przełączaniem perspektyw i wielometodowym logowaniem.

Swagger UI

Interaktywna dokumentacja API z możliwością testowania endpointów bezpośrednio w przeglądarce.

/api/v1/docs/ui/

OpenAPI JSON

Specyfikacja OpenAPI 3.0 w formacie JSON — do importu w Postman, generatorach kodu i narzędziach CI/CD.

/api/v1/docs/openapi.json

OpenAPI YAML

Surowy plik specyfikacji YAML — źródło prawdy dla kontraktu API.

/api/v1/docs/openapi.yaml

Kolekcja Postman

Gotowa kolekcja z przykładowymi requestami pogrupowanymi tagami. Import: Postman → Import → Link.

/api/v1/docs/postman.json

Health Check

Status usługi, połączenie z bazą danych, Redis i czas działania.

/health

Endpointy uwierzytelniania (Auth)

Unified People-based authentication — multi-method login, role switching, brute-force protection.

POST /api/session/login Logowanie (multi-method: PASSWORD, TOKEN_URL, SMS_OTP, EMAIL_OTP, OAuth)
POST /api/session/refresh Odświeżenie tokenów (token rotation)
GET /api/session/me Profil użytkownika z activeRole, roleContexts
POST /api/session/switch-role Przełączenie aktywnej roliNEW
POST /api/session/logout Wylogowanie (unieważnienie sesji)

Role i uprawnienia (RBAC)

Jedna osoba — wiele ról. Przełączaj perspektywę bez ponownego logowania.

CUSTOMER orders:read, notifications:read, support:read
EXECUTOR orders:read, operations:read, quality:*, notifications:*, nps:read
PARTNER orders:read, operations:read, finance:read, quality:*, nps:*, analytics:read, kepler:*
SUPER_USER Pełny dostęp + cms:access + vendor-context:switch

Diagnostyka i monitoring

GET /health Status usługi
GET /metrics Metryki runtime (Prometheus-compatible)
GET /api/diagnostics/system Diagnostyka systemu
GET /api/diagnostics/s3 Diagnostyka S3