REST API
POST/ api/ v1/ auth/ password/ reset
Однократно использовать токен письма: задать пароль, погасить ссылки и отозвать все сессии.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Без авторизации |
| Scope для ключей | не требуется |
| operationId | authPasswordReset |
Описание#
Однократно использовать токен письма: задать пароль, погасить ссылки и отозвать все сессии. Сам endpoint не выполняет вход; ответ содержит проверенный email.
Auth: без авторизации. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: application/, PasswordResetRequest. Все вложенные поля и варианты – по ссылке.
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
token | string | да | pattern см. полную схему |
password | string | да | длина ≥ 8; длина ≤ 128 |
Ответ · статус и структура
Ответ: 200 application/, PasswordResetResponse.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"email": "alex@example.com"
}Ошибки: 422 , 403 , 429 , 401 ; общие ошибки.
Лимиты: Защита от перебора: при превышении – 429 , повторить после Retry-.
Запрос · JSON
{
"token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
"password": "Example-password-123"
}Пример · curl
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/password/reset \
-H 'Origin: https://aos.edgelab.space' \
-H 'Content-Type: application/json' \
-d '{"token":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","password":"Example-password-123"}'Ответы по контракту#
Тело запроса: PasswordResetRequest.
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | PasswordResetResponse | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: VALIDATION_FAILED, ORIGIN_REJECTED, RATE_LIMITED, LINK_INVALID |
Машиночитаемый контракт: openapi.json, операция authPasswordReset.