REST API
GET/ api/ v1/ lessons/ { id} / transcript
Полный transcript по коду, segments с началом в секундах.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | course: |
| operationId | lessonTranscript |
Описание#
Полный transcript по коду, segments с началом в секундах. Неизвестный или некорректный код – 404; для gated-урока нужна анкета.
Auth: сессия кабинета (cookie) / TMA bearer / API-ключ или OAuth access token. Scope: course: (для ключей).
Path (обязателен каждый параметр):
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
id | string | да | длина ≤ 32; pattern см. полную схему |
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, Transcript.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"lessonId": "1.1",
"segments": [
{
"t": 0,
"text": "Привет! Это тестовый урок. Настоящие уроки появятся здесь перед стартом."
},
{
"t": 130,
"text": "Слева – уроки по неделям, эфиры открыты всегда, уроки открываются после анкеты."
},
{
"t": 310,
"text": "Тьютор отвечает по материалам курса и ставит ссылку на минуту урока."
},
{
"t": 480,
"text": "Во вкладке «Подключить агента» – адрес MCP и личный ключ."
}
]
}Ошибки: 401 , 403 , 503 , 429 , 404 , 403 , 403 , 403 ; общие ошибки.
Лимиты: Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key для этого тяжёлого метода.
curl -sS -i https://aos.edgelab.space/api/v1/lessons/1.1/transcript \
-H 'Authorization: Bearer aos_live_...'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | Transcript | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, NOT_FOUND, ONBOARDING_REQUIRED |
Машиночитаемый контракт: openapi.json, операция lessonTranscript.