POST/api/auth/reset-password
Встановлює новий пароль за допомогою токена скидання з листа.
Надішліть `token` (із посилання листа для скидання) і новий `password` у тілі JSON. Вхід для цього не потрібен. Пароль повинен відповідати мінімальним вимогам Zentor App. У разі успіху сервер відповідає `{"ok":true}`; після цього користувач входить із новим паролем. Недійсний, застарілий або вже використаний токен, а також пароль, що не відповідає мінімальним вимогам, призводять до коду 400 `VALIDATION_ERROR`. Токен витрачається після успішного використання; для повторної зміни запустіть новий процес через `POST /api/auth/forgot-password`. Кінцевий пункт обмежено 10 запитами за 15 хвилин на IP-адресу. Передавайте токен і пароль лише в тілі запиту через HTTPS, ніколи як параметри URL.
Огляд
Виклик: POST /api/auth/reset-password. Цей ендпоінт належить до групи «Автентифікація» API Zentor App. Він загальнодоступний і не потребує автентифікації. Виклик не ідемпотентний: кожен успішний виклик знову запускає дію. Обов’язкові параметри: token (тіло), password (тіло). Задокументовані випадки помилок: 400 VALIDATION_ERROR. Приклад відповіді нижче показує структуру успішної відповіді у форматі JSON.
Автентифікація та захист
Автентифікація не потрібна
Ідемпотентний: Ні
Параметри
token(body, string, обов'язково)— Токен скидання з листаpassword(body, string, обов'язково)— Новий парольПриклад запиту
{"token":"<токен із листа для скидання пароля>","password":"NoveNadiineParol!"}Приклад відповіді
{"ok":true}Коди помилок
400 VALIDATION_ERROR — Токен недійсний, застарілий або вже використаний, або пароль не відповідає мінімальним вимогам.Перевірена поведінка
Недійсний токен повертає 400 `VALIDATION_ERROR`. Успішний випадок (200 `{"ok":true}`) описано на основі документованого процесу.
Автентифікація
POST /api/auth/loginВиконує вхід користувача за email або іменем користувача та паролем і видає токен доступу (JWT) і refresh-токен.POST /api/auth/refreshОбмінює дійсний refresh-токен на нову пару токена доступу та refresh-токена.POST /api/auth/forgot-passwordЗапускає скидання пароля: якщо акаунт із вказаним email існує, на нього надходить лист із посиланням для скидання.POST /api/auth/sso/exchangeОстанній крок входу через SSO (SAML/OIDC): обмінює одноразовий код із переспрямування на токен доступу та refresh-токен.