REST API
POST/ api/ v1/ auth/ password/ forgot
Запросить письмо со ссылкой сброса пароля (30 минут).
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Без авторизации |
| Scope для ключей | не требуется |
| operationId | authPasswordForgot |
Описание#
Запросить письмо со ссылкой сброса пароля (30 минут). После валидации и лимитов всегда 204, независимо от наличия аккаунта; при отключённой почте – 404.
Auth: без авторизации. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: application/, PasswordForgotRequest. Все вложенные поля и варианты – по ссылке.
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
email | string | да | длина ≤ 254; формат "email"; pattern см. полную схему |
Ответ · статус и структура
Ответ: 204, без тела.
Ошибки: 422 , 403 , 429 , 404 ; общие ошибки.
Лимиты: Защита от перебора: при превышении – 429 , повторить после Retry-.
Запрос · JSON
{
"email": "student@example.com"
}Пример · curl
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/password/forgot \
-H 'Origin: https://aos.edgelab.space' \
-H 'Content-Type: application/json' \
-d '{"email":"student@example.com"}'Ответы по контракту#
Тело запроса: PasswordForgotRequest.
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 204 | – | – | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: VALIDATION_FAILED, ORIGIN_REJECTED, RATE_LIMITED, NOT_FOUND |
Машиночитаемый контракт: openapi.json, операция authPasswordForgot.