# GET /api/v1/lessons/{id}

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

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

## Описание

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

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

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

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

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

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

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

**Ответ:** 200 `application/json`, [LessonDetail](/docs/schemas#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`; [общие ошибки](/docs/errors).

**Лимиты:** 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_...'
```

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

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

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