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

REST API

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

Полный transcript по коду, segments с началом в секундах.

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

Описание#

Полный transcript по коду, segments с началом в секундах. Неизвестный или некорректный код – 404; для gated-урока нужна анкета.

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

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

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

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

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

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

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

Краткая форма: { lessonId: LessonCode, segments: (object)[] }.

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

json
{
  "lessonId": "1.1",
  "segments": [
    {
      "t": 0,
      "text": "Привет! Это тестовый урок. Настоящие уроки появятся здесь перед стартом."
    },
    {
      "t": 130,
      "text": "Слева – уроки по неделям, эфиры открыты всегда, уроки открываются после анкеты."
    },
    {
      "t": 310,
      "text": "Тьютор отвечает по материалам курса и ставит ссылку на минуту урока."
    },
    {
      "t": 480,
      "text": "Во вкладке «Подключить агента» – адрес MCP и личный ключ."
    }
  ]
}

Ошибки: 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; дополнительно 20/min/key для этого тяжёлого метода.

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

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

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

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