Dokumentacja API

Work Time Events API

CRUD zdarzeń startu pracy, przerw i zakończenia pracy.

GET /api/v1/work-time-events
POST /api/v1/work-time-events
GET /api/v1/work-time-events/{id}
PATCH /api/v1/work-time-events/{id}
DELETE /api/v1/work-time-events/{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.
event_type enum tak start_work, start_break, end_break albo end_work.
occurred_at datetime nie Czas zdarzenia.
source string nie Źródło zdarzenia, np. mobile.

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}
event_type={wartosc}
source={wartosc}
per_page=25

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

Przykładowy request

{
    "employee_id": 1,
    "event_type": "start_work",
    "occurred_at": "2026-03-01T08:30:00Z",
    "source": "mobile"
}

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