Test REST API (CakePHP 5)

Testowy serwis REST API: klienci (customers), ich auta (cars) i użytkownicy (users), uwierzytelnianie tokenem JWT, dokumentacja Swagger UI.

Uruchomienie

composer install
bin/cake migrations migrate        # tworzy tabele users, customers, cars
bin/cake seeds run DatabaseSeed    # 2 konta, 100 klientów, 1-5 aut na klienta (czyści tabele!)
bin/cake server -p 8765

Dokumentacja i konsola testowa: http://localhost:8765/docs (specyfikacja: webroot/openapi.yaml).

Konfiguracja bazy i sekretu JWT: config/app_local.php (Datasources.default, Jwt.secret, Jwt.ttl). Sekret można też podać zmienną środowiskową JWT_SECRET.

Konta testowe

Rola	E-mail	Hasło
admin	admin@example.com	Admin123!
user	user@example.com	User1234!

• admin – wszystko, w tym CRUD użytkowników.
• user – logowanie, własny profil, CRUD klientów i aut.

Endpointy

Metoda	Ścieżka	Opis
POST	/api/auth/login	logowanie, zwraca token JWT
GET / PUT / PATCH	/api/auth/me	własny profil
GET / POST	/api/customers	lista (filtry, paginacja) / dodanie
GET / PUT / PATCH / DELETE	/api/customers/{id}	klient (GET zwraca też auta)
GET / POST	/api/customers/{id}/cars	auta klienta / dodanie auta klientowi
GET / POST	/api/cars	lista aut / dodanie
GET / PUT / PATCH / DELETE	/api/cars/{id}	auto (GET zwraca też właściciela)
GET / POST	/api/users	użytkownicy (tylko admin)
GET / PUT / PATCH / DELETE	/api/users/{id}	użytkownik (tylko admin)

Przykład:

TOKEN=$(curl -s -X POST http://localhost:8765/api/auth/login \
  -H 'Content-Type: application/json' \
  -d '{"email":"user@example.com","password":"User1234!"}' | jq -r .data.token)

curl -s "http://localhost:8765/api/customers?q=nowak&with_cars=1" -H "Authorization: Bearer $TOKEN"

Pola

Klient – wymagane: first_name, last_name, email (unikalny), phone; opcjonalne: type (individual/company, dla company wymagane company_name), company_name, tax_id (NIP, 10 cyfr), street, city, postal_code (00-000), country (ISO, domyślnie PL), birth_date (YYYY-MM-DD), notes.

Auto – wymagane: customer_id, make, model, production_year, vin (17 znaków, unikalny), registration_number (unikalny), fuel_type (petrol/diesel/lpg/hybrid/electric); opcjonalne: color, engine_capacity (cm³), power_hp, transmission (manual/automatic), mileage (km), notes.

Użytkownik – wymagane: email (unikalny), password (min. 8 znaków), first_name, last_name; opcjonalne: role (admin/user, domyślnie user), active (nieaktywny nie może się zalogować).

Format odpowiedzi

• sukces: {"success": true, "data": ..., "meta": {...paginacja}}
• błąd: {"success": false, "error": {"code": 422, "message": "Validation failed.", "fields": {...}}}
• kody: 200, 201 (+ nagłówek Location), 204 (DELETE), 400, 401, 403, 404, 405, 422