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-токен.

Связанные статьи

← Аутентификация