API: Konto

Wszystkie endpointy w tej sekcji działają na aktualnie zalogowanym użytkowniku.

Bieżący użytkownik

GET /api/me

{
  "id": "019f7462-ac2a-73e3-ab40-be2e43f943f9",
  "email": "greta@example.com",
  "firstName": "Greta",
  "lastName": "Lengl",
  "avatarUrl": "/api/avatars/019f7462-ac2a-73e3-ab40-be2e43f943f9?v=3",
  "locale": "de",
  "createdAt": "2025-11-02T09:14:52Z"
}

createdAt to moment utworzenia konta.

Zmiana imienia i nazwiska

PUT /api/me/profile

{ "firstName": "Greta", "lastName": "Lengl" }

Zwraca 204. Błędy: 400, gdy któreś z pól jest puste.

Zmiana hasła

PUT /api/me/password

{ "currentPassword": "…", "newPassword": "…" }

Zwraca 204; wszystkie pozostałe sesje zostają wylogowane. Błędy: 403, gdy obecne hasło jest błędne, 400, gdy nowe hasło jest nieprawidłowe (8–72 znaki).

Żądanie zmiany adresu e-mail

POST /api/me/email

{ "newEmail": "new@example.com" }

Zwraca 202 w każdym przypadku — 6-cyfrowy kod potwierdzający jest wysyłany tylko wtedy, gdy adres faktycznie nadaje się do użycia (ochrona przed enumeracją: odpowiedź nigdy nie zdradza, czy adres jest już zajęty). Błędy: 400 dla nieprawidłowo sformułowanego adresu.

Potwierdzenie zmiany adresu e-mail

POST /api/me/email/confirm

{ "code": "123456" }

Zwraca 204: adres e-mail zostaje zmieniony, a wszystkie pozostałe sesje zostają wylogowane. Błędy: 400 dla nieprawidłowego lub wygasłego kodu (kody wygasają po 15 minutach).

Rejestracja urządzenia do push

PUT /api/me/push-tokens

{ "platform": "IOS", "token": "<raw APNs device token>" }

Zwraca 204. Idempotentne — rejestracja już znanego tokenu nie zmienia niczego, a token ostatnio zarejestrowany przez inne konto przechodzi na wywołującego (przekazane komuś urządzenie nigdy nie może otrzymywać cudzych powiadomień). Platformy: IOS (APNs) i ANDROID (FCM). Błędy: 400 dla pustego lub zbyt długiego tokenu.

Wyrejestrowanie urządzenia

DELETE /api/me/push-tokens/{token}

Zwraca 204, także gdy nic nie pasowało. Usuwana jest wyłącznie rejestracja wywołującego. Tokeny urządzeń są też usuwane automatycznie, gdy Apple zgłosi je jako martwe, oraz razem z kontem.

Eksport danych

GET /api/me/export

Zwraca dokument JSON z danymi konta i całą treścią utworzoną przez użytkownika, dostarczany jako plik do pobrania (Content-Disposition: attachment) — przenoszalność danych zgodna z RODO.

Usunięcie konta

POST /api/me/delete

{ "password": "…" }

Zwraca 204 — konto zostaje trwale usunięte: osobisty obszar roboczy, załączniki i profil zostają wymazane; zadania, których użytkownik był autorem, we wspólnych obszarach roboczych innych osób pozostają, przypisane do zarezerwowanego użytkownika „Nieaktywny użytkownik”. Błędy: 403, gdy hasło jest błędne, 409, dopóki użytkownik nadal posiada wspólne obszary robocze (najpierw je usuń lub przekaż własność).