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

REST API

POST/api/v1/auth/tma/refresh

Продлить тот же TMA token: sliding expiry 15 минут, абсолютный срок не более 12 часов.

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

Описание#

Продлить тот же TMA token: sliding expiry 15 минут, абсолютный срок не более 12 часов. Refresh не обновляет время исходной аутентификации.

Auth: TMA bearer. Scope: не требуется.

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

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

Body: не требуется.

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

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

Краткая форма: { token: string, expiresAt: string, absoluteExpiresAt: string }.

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

json
{
  "token": "aos3.tt_Zml4dHVyZS1vbmx5LW5vdC1hLXJlYWwtdG1hLXRva21",
  "expiresAt": "2026-11-04T09:30:00Z",
  "absoluteExpiresAt": "2026-11-04T21:00:00Z"
}

Ошибки: 401 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 403 CREDENTIAL_NOT_ALLOWED; общие ошибки.

Лимиты: Отдельного throttle в коде нет.

bash
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/tma/refresh \
  -H 'Authorization: Bearer TMA_TOKEN_PLACEHOLDER'

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

СтатусТипСхемаОписание
200application/jsonTmaTokenУспех
ошибкаapplication/jsonErrorBodyОшибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED

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