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

REST API

POST/api/v1/auth/link/redeem

Однократно обменять ссылку из бота на web-сессию.

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

Описание#

Однократно обменять ссылку из бота на web-сессию. Ссылка действует 5 минут; при гонке или повторе – LINK_INVALID.

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

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

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

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

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

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

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

Краткая форма: { student: Student, flow: "agentos3", tier: Tier, mentoring?: MentoringKind | null, offer?: Offer | null, access: { state: "active" | "grace", checkedAt: string }, onboarding: { status: OnboardingStatus, done: boolean }, planReady: boolean, authKind: "cookie" | "tma", features: { tutor: boolean, agentKeys: boolean, dictation: boolean }, limits: { tutorMessagesPerDay: integer, tutorUsdPerDay: number } }.

Устанавливает или очищает cookie входа; login создаёт __Host-aos_sess на 30 дней (фактический срок сессии дополнительно проверяет БД).

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

json
{
  "student": {
    "id": "0b9a6f2e-4c1d-4f7e-9a51-3c2d8e7f6a10",
    "tgId": 100000001,
    "name": "Александр Петров",
    "username": "alex_petrov",
    "avatarUrl": null
  },
  "flow": "agentos3",
  "tier": "personal",
  "access": {
    "state": "active",
    "checkedAt": "2026-11-04T09:00:00Z"
  },
  "onboarding": {
    "status": "draft",
    "done": false
  },
  "planReady": false,
  "authKind": "cookie",
  "features": {
    "tutor": false,
    "agentKeys": false,
    "dictation": true
  },
  "limits": {
    "tutorMessagesPerDay": 100,
    "tutorUsdPerDay": 2.5
  }
}

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

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

Запрос · JSON

json
{
  "token": "AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"
}

Пример · curl

bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/link/redeem \
  -H 'Origin: https://aos.edgelab.space' \
  -H 'Content-Type: application/json' \
  -d '{"token":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA"}'

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

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

СтатусТипСхемаОписание
200application/jsonMeOK (sets or clears a cookie)
ошибкаapplication/jsonErrorBodyОшибка; коды: VALIDATION_FAILED, ORIGIN_REJECTED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, LINK_INVALID

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