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

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

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

## Описание

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

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

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

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

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

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

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

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

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

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

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

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