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

REST API

GET/api/v1/tutor/messages

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

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

Описание#

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

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

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

Query:

ПолеТипОбязательноОграничения
beforestringнетформат "uuid"; pattern см. полную схему
limitintegerнет≥ 1; ≤ 50

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

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

Ответ: 200 application/json, 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; общие ошибки.

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

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

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

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

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