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

REST API

GET/api/v1/lessons/{id}

Карточка урока/эфира по коду: видео, конспект, таймкоды, промпты, ссылки, задание.

ПолеЗначение
URLGET https://aos.edgelab.space/api/v1/lessons/{id}
ДоступCookie кабинета · Mini App (TMA) · API-ключ / OAuth
Scope для ключейcourse:read
operationIdlessonGet

Описание#

Карточка урока/эфира по коду: видео, конспект, таймкоды, промпты, ссылки, задание. Закрытый gated-урок требует завершённой анкеты, иначе ONBOARDING_REQUIRED.

Auth: сессия кабинета (cookie) / TMA bearer / API-ключ или OAuth access token. Scope: course:read (для ключей).

Path (обязателен каждый параметр):

ПолеТипОбязательноОграничения
idstringдадлина ≤ 32; pattern см. полную схему

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

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

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

Ответ: 200 application/json, LessonDetail.

Краткая форма: { id: LessonCode, week: integer, title: string, minutes: integer, tools: (string)[], summary: string, task: string, kind: LessonKind, sectionId: string, gated: boolean, locked: boolean, video: LessonVideo, konspekt: string, timecodes: (Timecode)[], prompts: (LessonPrompt)[], links: (LessonLink)[] }.

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

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 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 404 NOT_FOUND, 403 ONBOARDING_REQUIRED, 403 CREDENTIAL_NOT_ALLOWED, 403 INSUFFICIENT_SCOPE; общие ошибки.

Лимиты: Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.

bash
curl -sS -i https://aos.edgelab.space/api/v1/lessons/1.1 \
  -H 'Authorization: Bearer aos_live_...'

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

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

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