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

REST API

GET/api/v1/next

Рекомендация следующего урока и причина.

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

Описание#

Рекомендация следующего урока и причина: продолжить начатый, следующий, нужна анкета или курс завершён.

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

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

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

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

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

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

Краткая форма: { lesson: LessonCard | null, reason: "continue" | "next" | "onboarding" | "done" }.

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

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 UNAUTHENTICATED, 403 NO_ENTITLEMENT, 503 ENTITLEMENT_UNAVAILABLE, 429 RATE_LIMITED, 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/next \
  -H 'Authorization: Bearer aos_live_...'

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

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

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