# POST /api/v1/auth/tma/refresh

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

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

## Описание

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

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

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

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

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

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

**Ответ:** 200 `application/json`, [TmaToken](/docs/schemas#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`; [общие ошибки](/docs/errors).

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

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

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

| Статус | Тип | Схема | Описание |
| --- | --- | --- | --- |
| 200 | application/json | [TmaToken](/docs/schemas#tmatoken) | Успех |
| ошибка | application/json | [ErrorBody](/docs/schemas#errorbody) | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED |

Машиночитаемый контракт: [openapi.json](/docs/openapi.json), операция `authTmaRefresh`.
