REST API

Endpointy dla operacji biznesowych i specyficznych funkcji.

Autentykacja

Endpoint	Metoda	Opis
/api/auth/login	POST	Logowanie
/api/auth/refresh	POST	Refresh token
/api/auth/logout	POST	Wylogowanie
/api/auth/me	GET	Bieżący użytkownik

CRM

# Konwersja leada do klienta
POST /api/crm/leads/{id}/convert

# Wyszukiwanie klientów
GET /api/crm/search?q=ABC&type=client

# Pipeline summary
GET /api/crm/pipeline/summary

Faktury

# Wyślij fakturę emailem
POST /api/invoices/{id}/send

# Generuj PDF
GET /api/invoices/{id}/pdf

# Zarejestruj płatność
POST /api/invoices/{id}/payments
{
  "amount": 1000.00,
  "date": "2025-01-15",
  "method": "transfer"
}

Baza Wiedzy

# Wyszukiwanie semantyczne
GET /api/kb/search?q=jak dodać klienta

# Sugestie artykułów dla ticketa
GET /api/kb/suggest?ticketId=123

Dokumenty

# Upload pliku
POST /api/documents/upload
Content-Type: multipart/form-data

# Generuj public link
POST /api/documents/{id}/share

# Pobierz plik
GET /api/documents/{id}/download

AI Assistant

# Wyślij wiadomość do AI
POST /api/ai/chat
{
  "message": "Pokaż podsumowanie klienta ABC",
  "context": {
    "module": "crm",
    "entityId": 123
  }
}

# Streaming response
GET /api/ai/chat/stream?sessionId=xxx

BI / NLQ

# Natural Language Query
POST /api/bi/nlq
{
  "question": "Pokaż przychody per miesiąc"
}

# Eksport raportu
POST /api/bi/reports/{id}/export
{
  "format": "xlsx"
}

Webhooks

# Zarejestruj webhook
POST /api/webhooks
{
  "url": "https://example.com/webhook",
  "events": ["invoice.created", "invoice.paid"]
}

Błędy

Wszystkie błędy zwracają strukturę:

{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid email format",
    "details": [
      { "field": "email", "message": "Must be valid email" }
    ]
  }
}

Kod HTTP	Znaczenie
400	Błąd walidacji
401	Brak autentykacji
403	Brak uprawnień
404	Nie znaleziono
429	Rate limit
500	Błąd serwera