Workplaces API
CRUD lokalizacji i biur, do których przypisani są pracownicy.
GET
/api/v1/workplaces
POST
/api/v1/workplaces
GET
/api/v1/workplaces/{id}
PATCH
/api/v1/workplaces/{id}
DELETE
/api/v1/workplaces/{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 |
|---|---|---|---|
name |
string | tak | Nazwa miejsca pracy. |
street |
string | tak | Ulica i numer. |
postal_code |
string | tak | Kod pocztowy. |
city |
string | tak | Miasto. |
country |
string | nie | Kraj, domyślnie Polska. |
Przy PATCH można wysłać tylko pola, które mają zostać zmienione.
Filtry listy
Endpoint listy przyjmuje query string z filtrami:
city={wartosc}
country={wartosc}
per_page=25
Jeżeli per_page nie zostanie podane, API zwróci pełną kolekcję.
Przykładowy request
{
"name": "HQ Warszawa",
"street": "ul. Prosta 1",
"postal_code": "00-001",
"city": "Warszawa",
"country": "Polska"
}
Przykładowa odpowiedź
{
"data": {
"id": 1,
"...": "pola zasobu",
"created_at": "2026-07-21T10:00:00.000000Z",
"updated_at": "2026-07-21T10:00:00.000000Z"
}
}