REST API
GET/ api/ v1/ mentoring/ sessions/ { sessionId}
Одна встреча: краткое содержание или очищенный транскрипт.
| Поле | Значение |
|---|---|
| URL | GET |
| Доступ | Cookie кабинета · Mini App (TMA) · API-ключ / OAuth |
| Scope для ключей | mentoring: |
| operationId | mentoringSession |
Описание#
Одна встреча: краткое содержание или очищенный транскрипт. Параметры view? (summary по умолчанию или transcript), limit?, cursor? (только для транскрипта).
{ "view": "summary", "session": { "id": "…", "updatedAt": "…", "refs": [], "details": { "startsAt": "…", "kind": "call", "durationSeconds": null, "status": "completed", "summary": "…", "transcriptStatus": "ready" }, "trackVersionId": null } }С view= ответ содержит метаданные встречи без summary, transcriptStatus, items, nextCursor, updatedAt. Сегмент: ordinal, startSeconds, endSeconds, speakerRole, text, status, необязательный quality (verified, uncertain, redacted); порядок – по ordinal. Отдаются только готовые сегменты. Состояния транскрипта: not_, consent_, processing, ready, failed, redacted; при недоступном – пустая страница и явное состояние.
Лимиты: API-ключ / OAuth: 60/min/key, 2000/UTC day/key, 3000/UTC day/student.
Параметры#
| Имя | Где | Обязательно | Тип и ограничения |
|---|---|---|---|
sessionId | path | да | string |
cursor | query | нет | string, длина ≤ 2048 |
limit | query | нет | integer, 1–200 |
view | query | нет | summary | transcript |
Ответы по контракту#
| Статус | Тип | Схема | Описание |
|---|---|---|---|
| 200 | application/json | MentoringSessionRead | Успех |
| ошибка | application/json | ErrorBody | Ошибка; коды: UNAUTHENTICATED, NO_ENTITLEMENT, ENTITLEMENT_UNAVAILABLE, RATE_LIMITED, CREDENTIAL_NOT_ALLOWED, INSUFFICIENT_SCOPE, MENTORING_NOT_AVAILABLE, NOT_FOUND, VALIDATION_FAILED |
Машиночитаемый контракт: openapi.json, операция mentoringSession.