Dokumentacja API

Leave Balances API

CRUD sald urlopowych pracowników.

GET /api/v1/leave-balances
POST /api/v1/leave-balances
GET /api/v1/leave-balances/{id}
PATCH /api/v1/leave-balances/{id}
DELETE /api/v1/leave-balances/{id}

200 201 401 422 500

Nagłówki

Accept: application/json
Content-Type: application/json
Authorization: Bearer {token}

Wszystkie endpointy tej sekcji działają pod middleware auth:sanctum.

Pola request body

Pole Typ Wymagane przy POST Opis
employee_id integer tak ID pracownika.
leave_type_id integer tak ID typu urlopu.
year integer tak Rok salda.
limit_days/used_days/pending_days/remaining_days decimal nie Wartości salda w dniach.

Przy PATCH można wysłać tylko pola, które mają zostać zmienione.

Filtry listy

Endpoint listy przyjmuje query string z filtrami:

employee_id={wartosc}
leave_type_id={wartosc}
year={wartosc}
per_page=25

Jeżeli per_page nie zostanie podane, API zwróci pełną kolekcję.

Przykładowy request

{
    "employee_id": 1,
    "leave_type_id": 1,
    "year": 2026,
    "limit_days": 26,
    "used_days": 5,
    "pending_days": 2,
    "remaining_days": 19
}

Przykładowa odpowiedź

{
  "data": {
    "id": 1,
    "...": "pola zasobu",
    "created_at": "2026-07-21T10:00:00.000000Z",
    "updated_at": "2026-07-21T10:00:00.000000Z"
  }
}

Live test