REST API
GET/ api/ v1/ efirs
Эфиры, расписание и записи.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | course: |
| operationId | efirs |
Описание#
Эфиры, расписание и записи; правила доступа применяются сервером.
Расписание задаётся в контенте (content/, поле efir., UTC; эфиры идут в 19:00 МСК) и приходит сюда после sync-. Тот же список отдаёт MCP-инструмент aos_. Для календаря есть статические файлы без авторизации, собранные из того же контента: / (всё расписание, можно подписаться) и / (один эфир, например agentos3-).
Auth: сессия кабинета (cookie) / TMA bearer / API-ключ или OAuth access token. Scope: course: (для ключей).
Path: параметров нет.
Query: нет объявленных полей.
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, EfirList.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"efirs": [
{
"id": "stream.1",
"title": "Приветственный эфир",
"day": 1,
"minutes": 90,
"upcoming": true,
"startsAt": "2026-11-02T13:00:00Z",
"lessonId": null
}
]
}Ошибки: 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/efirs \
-H 'Authorization: Bearer aos_live_...'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | EfirList | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED |
Машиночитаемый контракт: openapi.json, операция efirs.