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

REST API

POST/api/v1/auth/password/reset

Однократно использовать токен письма: задать пароль, погасить ссылки и отозвать все сессии.

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

Описание#

Однократно использовать токен письма: задать пароль, погасить ссылки и отозвать все сессии. Сам endpoint не выполняет вход; ответ содержит проверенный email.

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

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

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

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

ПолеТипОбязательноОграничения
tokenstringдаpattern см. полную схему
passwordstringдадлина ≥ 8; длина ≤ 128

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

Ответ: 200 application/json, PasswordResetResponse.

Краткая форма: { email: string }.

Пример JSON; значения демонстрационные.

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

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

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

Запрос · JSON

json
{
  "token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA",
  "password": "Example-password-123"
}

Пример · curl

bash
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.

СтатусТипСхемаОписание
200application/jsonPasswordResetResponseУспех
ошибкаapplication/jsonErrorBodyОшибка; коды: VALIDATION_FAILED, ORIGIN_REJECTED, RATE_LIMITED, LINK_INVALID

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