API Reference

ReadyNextOS udostępnia RESTful API do integracji z zewnętrznymi systemami.

Autentykacja

API używa tokenów Bearer (Sanctum):

curl -X POST https://api.example.com/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com", "password": "secret"}'

Odpowiedź:

{
  "token": "1|abc123...",
  "user": { "id": "...", "name": "..." }
}

Użycie tokenu:

curl https://api.example.com/api/documents \
  -H "Authorization: Bearer 1|abc123..."

Endpointy

Dokumenty

Metoda	Endpoint	Opis
GET	/api/documents	Lista dokumentów
POST	/api/documents	Utwórz dokument
GET	/api/documents/{id}	Pobierz dokument
PUT	/api/documents/{id}	Aktualizuj dokument
DELETE	/api/documents/{id}	Usuń dokument

Kontakty

Metoda	Endpoint	Opis
GET	/api/contacts	Lista kontaktów
POST	/api/contacts	Utwórz kontakt
GET	/api/contacts/{id}	Pobierz kontakt

Poczta

Metoda	Endpoint	Opis
GET	/api/mail/accounts	Lista kont
GET	/api/mail/folders	Lista folderów
GET	/api/mail/messages	Lista wiadomości
POST	/api/mail/send	Wyślij wiadomość

Paginacja

Wszystkie listy wspierają paginację:

GET /api/documents?page=1&per_page=25

Filtry

GET /api/documents?status=draft&created_after=2025-01-01

Kody odpowiedzi

Kod	Znaczenie
200	Sukces
201	Utworzono
400	Błąd walidacji
401	Brak autoryzacji
403	Brak uprawnień
404	Nie znaleziono
500	Błąd serwera