API Documentation

REST API Allbag B2B umożliwia integrację z systemami ERP, sklepami i aplikacjami zewnętrznymi.

Autentykacja

Wszystkie endpointy wymagają klucza API w nagłówku Authorization:

Authorization: Bearer alb_your_api_key_here

Klucze API można wygenerować w Panelu Admina → Klucze API.

Endpointy

GET/api/v1/products

Lista produktów z paginacją i filtrami

?page=1&perPage=50&category=slug&search=query

GET/api/v1/orders

Lista zamówień zalogowanego użytkownika

?page=1&perPage=20&status=PENDING

GET/api/v1/categories

Lista kategorii z liczbą produktów

GET/api/v1/stock

Sprawdzenie stanów magazynowych po SKU

?skus=SKU1,SKU2,SKU3

GET/api/v1/search

Wyszukiwanie produktów z synonimami

?q=keyword&limit=10

GET/api/v1/webhooks

Lista zarejestrowanych webhooków

POST/api/v1/webhooks

Rejestracja nowego webhooka

Body: { url, events[] }

GET/api/health

Health check: status serwera i bazy danych

Format odpowiedzi

{
  "data": [...],
  "meta": {
    "page": 1,
    "perPage": 50,
    "total": 1332,
    "totalPages": 27
  }
}