REST API
GET/ api/ v1/ mentoring/ sessions
Встречи с ментором.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | mentoring: |
| operationId | mentoringSessions |
Описание#
Встречи с ментором. Параметры limit?, cursor?. Детали элемента: startsAt, kind (call или consultation), durationSeconds (или null), status, summary, transcriptStatus и nullable trackVersionId. Если есть, приходят также title (название встречи, 1–120 символов), brief (короткое описание, 1–400 символов), hostName (имя ведущего, 1–64 символа) и recordingUrl (ссылка на запись, HTTPS, только kinescope.); если их нет, поля отсутствуют.
Лимиты: API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
curl -sS "https://aos.edgelab.space/api/v1/mentoring/sessions?limit=20" \
-H "Authorization: Bearer $AOS_API_KEY"Параметры#
| Имя | Где | Обязательно | Тип и ограничения |
|---|---|---|---|
cursor | query | нет | string, длина ≤ 2048 |
limit | query | нет | integer, 1–100 |
Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | MentoringSessions | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED, INSUFFICIENT_SCOPE, MENTORING_NOT_AVAILABLE, NOT_FOUND, VALIDATION_FAILED |
Машиночитаемый контракт: openapi.json, операция mentoringSessions.