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

REST API

GET/api/v1/lessons

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

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

Описание#

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

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

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

Query:

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

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

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

Ответ: 200 application/json, 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; общие ошибки.

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

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

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

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