# GET /api/v1/auth/sessions

Список действующих web- и TMA-сессий студента.

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

## Описание

Список действующих web- и TMA-сессий студента; текущая помечена `current`.

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

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

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

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

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

**Ответ:** 200 `application/json`, [SessionList](/docs/schemas#sessionlist).

Краткая форма: `{ sessions: (SessionInfo)[] }`.

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

```json
{
  "sessions": [
    {
      "id": "7d1c2b3a-0e4f-4a5b-8c6d-1e2f3a4b5c6d",
      "kind": "cookie",
      "createdAt": "2026-11-04T09:00:00Z",
      "lastSeenAt": "2026-11-04T09:20:00Z",
      "device": "Chrome · macOS",
      "current": true
    },
    {
      "id": "8e2d3c4b-1f50-4b6c-9d7e-2f3a4b5c6d7e",
      "kind": "tma",
      "createdAt": "2026-11-04T08:40:00Z",
      "lastSeenAt": null,
      "device": "Telegram Mini App",
      "current": false
    }
  ]
}
```

**Ошибки:** `401 UNAUTHENTICATED`, `403 NO_ENTITLEMENT`, `503 ENTITLEMENT_UNAVAILABLE`, `429 RATE_LIMITED`, `403 CREDENTIAL_NOT_ALLOWED`; [общие ошибки](/docs/errors).

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

```bash
curl -sS -i https://aos.edgelab.space/api/v1/auth/sessions \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER'
```

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

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

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