REST API
GET/ api/ v1/ tutor/ messages
История единого диалога.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) |
| Scope для ключей | ключи не принимаются – только кабинет (403 CREDENTIAL_) |
| operationId | tutorMessages |
Описание#
История единого диалога. before – cursor из nextBefore, новые страницы содержат более старые сообщения; внутри страницы сообщения идут от старых к новым. Default limit=, максимум 50.
Auth: сессия кабинета (cookie) / TMA bearer. Scope: не требуется.
Path: параметров нет.
Query:
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
before | string | нет | формат "uuid"; pattern см. полную схему |
limit | integer | нет | ≥ 1; ≤ 50 |
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, TutorMessagesPage.
Краткая форма: {.
Пример 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 , 403 , 503 , 429 , 422 , 403 ; общие ошибки.
Лимиты: Отдельного throttle в коде нет.
curl -sS -i 'https://aos.edgelab.space/api/v1/tutor/messages?limit=20' \
--cookie '__Host-aos_sess=SESSION_PLACEHOLDER'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | TutorMessagesPage | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, VALIDATION_FAILED |
Машиночитаемый контракт: openapi.json, операция tutorMessages.