# GET /api/v1/lessons

Уроки и эфиры, при необходимости фильтр по разделу и kind.

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

## Описание

Уроки и эфиры, при необходимости фильтр по разделу и kind. В списке видно `locked`; закрытые уроки не раскрывают детали.

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

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

**Query:**

| Поле        | Тип                              | Обязательно | Ограничения           |
| ----------- | -------------------------------- | ----------- | --------------------- |
| `sectionId` | `string`                         | нет         | длина ≥ 1; длина ≤ 64 |
| `kind`      | `"lesson" \| "tech" \| "stream"` | нет         | –                     |

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

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

**Ответ:** 200 `application/json`, [LessonList](/docs/schemas#lessonlist).

Краткая форма: `{ lessons: (LessonCard)[] }`.

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

```json
{
  "lessons": [
    {
      "id": "stream.1",
      "week": 0,
      "title": "Приветственный эфир",
      "minutes": 90,
      "tools": [
        "claude",
        "mcp"
      ],
      "summary": "Знакомство с потоком, как устроены недели и кабинет.",
      "task": "Придите на эфир с одним вопросом про свой проект.",
      "kind": "stream",
      "sectionId": "agentos3.efirs",
      "gated": false,
      "locked": false
    },
    {
      "id": "1.1",
      "week": 1,
      "title": "Тестовый урок: как устроен кабинет и тьютор",
      "minutes": 10,
      "tools": [
        "telegram",
        "claude"
      ],
      "summary": "Где лежат уроки, эфиры и «Мой план». Как задавать вопросы тьютору и подключить своего агента.",
      "task": "Задайте тьютору вопрос по уроку и проверьте, что ссылка открывает видео на нужной минуте.",
      "kind": "lesson",
      "sectionId": "agentos3.week.1",
      "gated": true,
      "locked": true
    }
  ]
}
```

**Ошибки:** `401 UNAUTHENTICATED`, `403 NO_ENTITLEMENT`, `503 ENTITLEMENT_UNAVAILABLE`, `429 RATE_LIMITED`, `422 VALIDATION_FAILED`, `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?kind=lesson' \
  -H 'Authorization: Bearer aos_live_...'
```

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

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

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