К содержанию
AgentOSДокументация
  • Загружаем индекс…
llms.txtКабинет

REST API

POST/api/v1/auth/password/forgot

Запросить письмо со ссылкой сброса пароля (30 минут).

ПолеЗначение
URLPOST https://aos.edgelab.space/api/v1/auth/password/forgot
ДоступБез авторизации
Scope для ключейне требуется
operationIdauthPasswordForgot

Описание#

Запросить письмо со ссылкой сброса пароля (30 минут). После валидации и лимитов всегда 204, независимо от наличия аккаунта; при отключённой почте – 404.

Auth: без авторизации. Scope: не требуется.

Path: параметров нет.

Query: нет объявленных полей.

Body: application/json, PasswordForgotRequest. Все вложенные поля и варианты – по ссылке.

ПолеТипОбязательноОграничения
emailstringдадлина ≤ 254; формат "email"; pattern см. полную схему

Ответ · статус и структура

Ответ: 204, без тела.

Ошибки: 422 VALIDATION_FAILED, 403 ORIGIN_REJECTED, 429 RATE_LIMITED, 404 NOT_FOUND; общие ошибки.

Лимиты: Защита от перебора: при превышении – 429 RATE_LIMITED, повторить после Retry-After.

Запрос · JSON

json
{
  "email": "student@example.com"
}

Пример · curl

bash
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/jsonErrorBodyОшибка; коды: VALIDATION_FAILED, ORIGIN_REJECTED, RATE_LIMITED, NOT_FOUND

Машиночитаемый контракт: openapi.json, операция authPasswordForgot.