Dokumentacja API

Rejestracja użytkownika

POST /api/v1/auth/register

Endpoint tworzy nowe konto użytkownika i zwraca token dostępu.

Nagłówki requestu

Accept: application/json
Content-Type: application/json

Pola request body

Pole Typ Wymagane Opis
name string tak Nazwa lub imię użytkownika.
email string tak Unikalny adres e-mail użytkownika.
password string tak Hasło użytkownika.
password_confirmation string tak Powtórzenie hasła.
device_name string nie Nazwa urządzenia, np. web, android, ios.

Walidacja

  • name — wymagane, string, min. 2 znaki, max. 100 znaków
  • email — wymagane, poprawny email, unikalny
  • password — wymagane, min. 8 znaków, zgodne z password_confirmation
  • device_name — opcjonalne, string

Możliwe odpowiedzi

Status Opis
201 Rejestracja zakończona sukcesem.
422 Błąd walidacji danych wejściowych.
500 Błąd serwera.

Przykładowy request

{
  "name": "Jan Kowalski",
  "email": "jan@example.com",
  "password": "Secret123!",
  "password_confirmation": "Secret123!",
  "device_name": "web"
}

Przykładowa odpowiedź 201

{
  "success": true,
  "message": "Registration successful.",
  "data": {
    "user": {
      "id": 1,
      "name": "Jan Kowalski",
      "email": "jan@example.com",
      "created_at": "2026-04-05T12:00:00Z",
      "updated_at": "2026-04-05T12:00:00Z"
    },
    "token": "1|example_token"
  }
}

Live test