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

REST API

GET/api/v1/efirs

Эфиры, расписание и записи.

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

Описание#

Эфиры, расписание и записи; правила доступа применяются сервером.

Расписание задаётся в контенте (content/agentos3/efirs/*.yaml, поле efir.starts_at, UTC; эфиры идут в 19:00 МСК) и приходит сюда после sync-content. Тот же список отдаёт MCP-инструмент aos_list_efirs. Для календаря есть статические файлы без авторизации, собранные из того же контента: /calendar/agentos3-efirs.ics (всё расписание, можно подписаться) и /calendar/agentos3-<код>.ics (один эфир, например agentos3-stream.2.ics).

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

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

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

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

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

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

Краткая форма: { efirs: (Efir)[] }.

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

json
{
  "efirs": [
    {
      "id": "stream.1",
      "title": "Приветственный эфир",
      "day": 1,
      "minutes": 90,
      "upcoming": true,
      "startsAt": "2026-11-02T13:00:00Z",
      "lessonId": null
    }
  ]
}

Ошибки: 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/efirs \
  -H 'Authorization: Bearer aos_live_...'

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

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

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