Dokumentacja API

Notifications API

CRUD powiadomień użytkowników.

GET /api/v1/notifications
POST /api/v1/notifications
GET /api/v1/notifications/{id}
PATCH /api/v1/notifications/{id}
DELETE /api/v1/notifications/{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
recipient_user_id integer tak ID odbiorcy.
type enum tak request, work_time, payroll, reimbursement albo system.
title string tak Tytuł powiadomienia.
body text|null nie Treść powiadomienia.
read_at datetime|null nie Data odczytu.

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

Filtry listy

Endpoint listy przyjmuje query string z filtrami:

recipient_user_id={wartosc}
type={wartosc}
related_entity_type={wartosc}
related_entity_id={wartosc}
per_page=25

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

Przykładowy request

{
    "recipient_user_id": 1,
    "type": "request",
    "title": "Nowy wniosek",
    "body": "Wniosek oczekuje na decyzję.",
    "related_entity_type": "request",
    "related_entity_id": 1,
    "read_at": null
}

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