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":"NovyiNadezhnyiParol!"}Пример ответа
{"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-токен.