REST API
Личный менторинг
Персональный трек, встречи, решения, задания и чат с ментором. Тарифы «С куратором / Лично с Даши».
| Метод | Путь | Доступ | Scope | Назначение |
|---|---|---|---|---|
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Текущая опубликованная версия личного трека. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | История опубликованных версий личного трека, включая прошлые публикации; черновики скрыты. id элемента – это versionId для чтения версии. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Встречи с ментором. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Одна встреча: краткое содержание или очищенный транскрипт. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Решения со встреч. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Ежедневные сводки чата с ментором. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Очищенные разрешённые сообщения чата. |
| GET | / | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth | mentoring: | Задания от ментора. |
Чтение опубликованного личного трека, встреч, решений, заданий и разрешённой очищенной истории чата с ментором. REST и MCP вызывают один и тот же сервис. Идентификатор студента не передаётся: студента определяет авторизованный аккаунт.
Кто может читать. Сессия кабинета и Mini App читают собственный менторинг. API-ключу и OAuth-доступу нужен явно выданный mentoring:: другие scopes его не подразумевают, старые ключи и подключения новых прав не получают. Тариф «Лично» должен быть подтверждён не более 15 минут назад. Тариф «Группа» и подарок группового доступа без явного личного доступа получают 403 MENTORING_ без каких-либо метаданных менторинга. Если проверка доступа временно недоступна, после истечения последней проверки чтение закрывается.
Что видно. Только опубликованные и не удалённые материалы с действующим источником и действующими согласиями. Отзыв согласия скрывает данные со следующего запроса. Черновик никогда не скрывает опубликованную версию; если последняя публикация скрыта, отозвана или удалена, объект исчезает целиком, а более старая публикация не возвращается. Неизвестные, чужие, неопубликованные и отозванные идентификаторы встреч и версий дают одинаковый 404 NOT_. Пустой список – items:, nextCursor:, updatedAt:.
Все ответы – Cache-. Пути источников, служебные метаданные, доказательства согласий, сырые данные и внутренние заметки не возвращаются. Поиск по курсу и тьютор работают отдельно: mentoring: не даёт тьютору доступ к менторингу.
Страницы и формат.
- Списки возвращают
{;items, nextCursor, updatedAt } limitпо умолчанию 20, максимум 100.updatedAt– время последнего обновления видимого элемента в выборке или null. nextCursorпередавайте без изменений какcursorс теми же фильтрами иlimit. Курсор зашифрован и привязан к аккаунту, фильтрам и снимку данных: подмена, чужой аккаунт, другие фильтры или изменившиеся данные дают 422VALIDATION_– начните с первой страницы. Курсоры REST и MCP взаимозаменяемы.FAILED - Встречи сортируются по времени встречи по убыванию, сообщения – по времени, сводки – по дате, остальные списки – по времени обновления; при равенстве – по UUID.
from/toчата – датыYYYY-по Москве включительно, передаются вместе, интервал не больше 31 дня. По умолчанию – сегодня и 30 предыдущих дней.MM- DD - Даты – ISO-8601, неизвестные – null. Длительности и позиции транскрипта – в секундах.
- Элемент содержит
id,updatedAt,refsи типизированныеdetails.refsраскрывают только вид ссылки (document,message,segment,recording) и необязательную позицию (startSeconds,endSeconds,ordinal,revision). - Страница транскрипта – по умолчанию 20, максимум 200 сегментов и обычно 32 KiB на весь JSON-ответ. Один слишком длинный сегмент возвращается отдельно с
oversizedSegment:.true
Общие ошибки: 401 UNAUTHENTICATED; 403 CREDENTIAL_, INSUFFICIENT_, MENTORING_; 404 NOT_; 422 VALIDATION_; 429 RATE_. Формат – общий {; инструменты MCP возвращают тот же код в тексте с isError:.