REST API
GET/ api/ v1/ next
Рекомендация следующего урока и причина.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | course: |
| operationId | next |
Описание#
Рекомендация следующего урока и причина: продолжить начатый, следующий, нужна анкета или курс завершён.
Auth: сессия кабинета (cookie) / TMA bearer / API-ключ или OAuth access token. Scope: course: (для ключей).
Path: параметров нет.
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, NextLesson.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"lesson": {
"id": "1.1",
"week": 1,
"title": "Тестовый урок: как устроен кабинет и тьютор",
"minutes": 10,
"tools": [
"telegram",
"claude"
],
"summary": "Где лежат уроки, эфиры и «Мой план». Как задавать вопросы тьютору и подключить своего агента.",
"task": "Задайте тьютору вопрос по уроку и проверьте, что ссылка открывает видео на нужной минуте.",
"kind": "lesson",
"sectionId": "agentos3.week.1",
"gated": true,
"locked": false
},
"reason": "next"
}Ошибки: 401 , 403 , 503 , 429 , 403 , 403 ; общие ошибки.
Лимиты: Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
curl -sS -i https://aos.edgelab.space/api/v1/next \
-H 'Authorization: Bearer aos_live_...'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | NextLesson | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED |
Машиночитаемый контракт: openapi.json, операция next.