REST API
GET/ api/ v1/ lessons/ { id}
Карточка урока/эфира по коду: видео, конспект, таймкоды, промпты, ссылки, задание.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | course: |
| operationId | lessonGet |
Описание#
Карточка урока/эфира по коду: видео, конспект, таймкоды, промпты, ссылки, задание. Закрытый gated-урок требует завершённой анкеты, иначе ONBOARDING_.
Auth: сессия кабинета (cookie) / TMA bearer / API-ключ или OAuth access token. Scope: course: (для ключей).
Path (обязателен каждый параметр):
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
id | string | да | длина ≤ 32; pattern см. полную схему |
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, LessonDetail.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"id": "1.1",
"week": 1,
"title": "Тестовый урок: как устроен кабинет и тьютор",
"minutes": 10,
"tools": [
"telegram",
"claude"
],
"summary": "Где лежат уроки, эфиры и «Мой план». Как задавать вопросы тьютору и подключить своего агента.",
"task": "Задайте тьютору вопрос по уроку и проверьте, что ссылка открывает видео на нужной минуте.",
"kind": "lesson",
"sectionId": "agentos3.week.1",
"gated": true,
"locked": false,
"video": {
"provider": "placeholder",
"url": null,
"durationSec": 600
},
"konspekt": "## Что в этом уроке\n- Где лежат уроки, эфиры и «Мой план».\n- Как задавать вопросы тьютору и как он ссылается на таймкоды.\n- Как подключить своего агента к курсу через MCP.\n",
"timecodes": [
{
"t": 0,
"label": "Вступление",
"text": null
},
{
"t": 130,
"label": "Навигация по кабинету",
"text": "Слева – уроки по неделям, эфиры открыты всегда."
},
{
"t": 310,
"label": "Тьютор и источники",
"text": "Тьютор отвечает по материалам курса и ставит ссылку на минуту урока."
},
{
"t": 480,
"label": "Подключить агента",
"text": null
}
],
"prompts": [
{
"title": "Проверка тьютора",
"text": "Объясни, что было в тестовом уроке на 05:10"
},
{
"title": "Проверка MCP",
"text": "Через MCP AgentOS получи список уроков и открой 1.1"
}
],
"links": [
{
"title": "AgentOS – поток 3",
"url": "https://agentos.edgelab.space/3potok",
"description": "Страница потока: расписание и программа"
},
{
"title": "MCP",
"url": "https://modelcontextprotocol.io",
"description": null
}
]
}Ошибки: 401 , 403 , 503 , 429 , 404 , 403 , 403 , 403 ; общие ошибки.
Лимиты: Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
curl -sS -i https://aos.edgelab.space/api/v1/lessons/1.1 \
-H 'Authorization: Bearer aos_live_...'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | LessonDetail | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, NOT_FOUND, ONBOARDING_REQUIRED |
Машиночитаемый контракт: openapi.json, операция lessonGet.