REST API
POST/ api/ v1/ auth/ tma/ refresh
Продлить тот же TMA token: sliding expiry 15 минут, абсолютный срок не более 12 часов.
| Поле | Значение |
|---|---|
| URL | POST |
| Доступ | Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | authTmaRefresh |
Описание#
Продлить тот же TMA token: sliding expiry 15 минут, абсолютный срок не более 12 часов. Refresh не обновляет время исходной аутентификации.
Auth: TMA bearer. Scope: не требуется.
Path: параметров нет.
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, TmaToken.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"token": "aos3.tt_Zml4dHVyZS1vbmx5LW5vdC1hLXJlYWwtdG1hLXRva21",
"expiresAt": "2026-11-04T09:30:00Z",
"absoluteExpiresAt": "2026-11-04T21:00:00Z"
}Ошибки: 401 , 403 , 503 , 429 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i -X POST https://aos.edgelab.space/api/v1/auth/tma/refresh \
-H 'Authorization: Bearer TMA_TOKEN_PLACEHOLDER'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | TmaToken | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED |
Машиночитаемый контракт: openapi.json, операция authTmaRefresh.