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

REST API

POST/api/v1/auth/password/setup

Запросить письмо установки/смены email.

ПолеЗначение
URLPOST https://aos.edgelab.space/api/v1/auth/password/setup
ДоступCookie кабинета · Mini App (TMA)
Scope для ключейключи не принимаются – только кабинет (403 CREDENTIAL_NOT_ALLOWED)
operationIdauthPasswordSetup

Описание#

Запросить письмо установки/смены email. Ровно одно из email и orderEmail: true; во втором случае полный адрес заказа разрешается сервером и не возвращается. Нужен Telegram-вход не старше 10 минут либо правильный currentPassword, если пароль уже есть. Вход по email-коду не считается свежим Telegram-входом. Успех всегда 204, даже если адрес занят; без mailer – 404.

Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.

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

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

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

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

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

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

Ошибки: 401 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 403 ORIGIN_REJECTED, 422 VALIDATION_FAILED, 401 LOGIN_INVALID, 401 REAUTH_REQUIRED, 409 VERSION_CONFLICT, 404 NOT_FOUND, 403 CREDENTIAL_NOT_ALLOWED; общие ошибки.

Лимиты: 3/10 min/student; защита от перебора: при превышении – 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/setup \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER' \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: application/json' \
  -d '{"email":"student@example.com"}'

Ответы по контракту#

Тело запроса: PasswordSetupRequest.

СтатусТипСхемаОписание
204––Успех
ошибкаapplication/jsonErrorBodyОшибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, ORIGIN_REJECTED, VALIDATION_FAILED, LOGIN_INVALID, REAUTH_REQUIRED, VERSION_CONFLICT, NOT_FOUND

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