REST API
GET/ api/ v1/ search
Полнотекстовый поиск по транскриптам и таймкодам уроков/эфиров с применением gating.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | course: |
| operationId | search |
Описание#
Полнотекстовый поиск по транскриптам и таймкодам уроков/эфиров с применением gating. q 2–200 символов после trim, limit 1–20 (default 10); результаты содержат источники/таймкоды. Конспекты уроков в поиск не входят.
Auth: сессия кабинета (cookie) / TMA bearer / API-ключ или OAuth access token. Scope: course: (для ключей).
Path: параметров нет.
Query:
| Поле | Тип | Обязательно | Ограничения |
|---|---|---|---|
q | string | да | длина ≥ 2; длина ≤ 200 |
limit | integer | нет | ≥ 1; ≤ 20 |
Body: не требуется.
Ответ · статус и структура
Ответ: 200 application/, SearchResults.
Краткая форма: {.
Пример JSON; значения демонстрационные.
{
"query": "тьютор",
"results": [
{
"label": "Урок 1.1 · 05:10",
"lesson": "1.1",
"seconds": 310,
"title": "Тестовый урок: как устроен кабинет и тьютор",
"snippet": "Тьютор отвечает по материалам курса и ставит ссылку на минуту урока."
}
]
}Ошибки: 401 , 403 , 503 , 429 , 422 , 403 , 403 ; общие ошибки.
Лимиты: Agent-key/OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student; дополнительно 20/min/key для этого тяжёлого метода.
curl -sS -i 'https://aos.edgelab.space/api/v1/search?q=MCP&limit=5' \
-H 'Authorization: Bearer aos_live_...'Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | SearchResults | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, VALIDATION_FAILED |
Машиночитаемый контракт: openapi.json, операция search.