# GET /api/v1/tutor/messages

История единого диалога.

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

## Описание

История единого диалога. `before` – cursor из `nextBefore`, новые страницы содержат более старые сообщения; внутри страницы сообщения идут от старых к новым. Default `limit=20`, максимум 50.

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

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

**Query:**

| Поле     | Тип       | Обязательно | Ограничения                             |
| -------- | --------- | ----------- | --------------------------------------- |
| `before` | `string`  | нет         | формат "uuid"; pattern см. полную схему |
| `limit`  | `integer` | нет         | ≥ 1; ≤ 50                               |

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

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

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

Краткая форма: `{ messages: (TutorMessage)[], nextBefore: string | null }`.

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

```json
{
  "messages": [
    {
      "id": "5f0e1c2a-8b3d-4e6f-9a7b-1c2d3e4f5a61",
      "role": "user",
      "text": "Как подключить MCP к Claude Code?",
      "sources": [],
      "citations": [],
      "error": false,
      "feedback": null,
      "attachments": [
        {
          "id": "7a1c2e3f-4b5d-4e6f-8a9b-0c1d2e3f4a51",
          "name": "скрин ошибки.png",
          "mime": "image/png",
          "kind": "image",
          "size": 184320
        }
      ],
      "createdAt": "2026-11-06T09:00:00.000Z"
    },
    {
      "id": "5f0e1c2a-8b3d-4e6f-9a7b-1c2d3e4f5a62",
      "role": "assistant",
      "text": "Подключите сервер командой `claude mcp add` и проверьте его через `/mcp` [1]. Перед запуском пройдите чек-лист [2]. Зачем агенту MCP, коротко описано в каталоге скиллов [3][1].",
      "sources": [
        {
          "kind": "lesson",
          "label": "Урок 1.1 · 05:10",
          "lesson": "1.1",
          "seconds": 310
        },
        {
          "kind": "material",
          "label": "Материал · Чек-лист подключения MCP",
          "id": "mcp"
        },
        {
          "kind": "skill",
          "label": "Скилл · MCP",
          "id": "mcp"
        }
      ],
      "citations": [
        {
          "source": 0,
          "start": 73,
          "end": 76
        },
        {
          "source": 1,
          "start": 111,
          "end": 114
        },
        {
          "source": 2,
          "start": 169,
          "end": 172
        },
        {
          "source": 0,
          "start": 172,
          "end": 175
        }
      ],
      "error": false,
      "feedback": "up",
      "attachments": [],
      "createdAt": "2026-11-06T09:00:04.000Z"
    }
  ],
  "nextBefore": null
}
```

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

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

```bash
curl -sS -i 'https://aos.edgelab.space/api/v1/tutor/messages?limit=20' \
  --cookie '__Host-aos_sess=SESSION_PLACEHOLDER'
```

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

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

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