Записи
Эндпоинты для записей, транскриптов и ссылок для общего доступа. Все пути находятся на https://api.recordmeeting.com и требуют API-ключ. См. Аутентификация.
Список записей
Заголовок раздела «Список записей»GET /v1/recordingsВозвращает постраничный список записей, к которым у вас есть доступ.
Параметры запроса
Заголовок раздела «Параметры запроса»| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
limit | integer | 20 | Количество результатов (от 1 до 100) |
offset | integer | 0 | Смещение пагинации |
search | string | none | Фильтр по тексту в заголовке |
status | string | none | Фильтр по статусу (см. Статусы записи) |
date_from | string | none | Дата и время в формате ISO 8601. Только записи, созданные в это время или позже |
date_to | string | none | Дата и время в формате ISO 8601. Только записи, созданные в это время или раньше |
organization_id | string | none | Показать записи организации |
folder_id | string | none | Показать записи папки |
user_id | string | none | Фильтр по пользователю. Для администраторов организации, которым нужны записи одного участника |
{ "data": [ { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "folder_id": null, "organization_id": null, "transcription_status": "completed", "notes_status": "completed", "is_shared": true, "processing_progress": null } ], "pagination": { "total": 42, "limit": 20, "offset": 0, "has_more": true }}title, duration_seconds, thumbnail_url, folder_id, organization_id, transcription_status, notes_status и processing_progress могут быть null. Для заблокированной записи transcription_status и notes_status равны null.
С organization_id редакторы и наблюдатели получают только те записи, которые им разрешено видеть. Тогда total является верхней границей, и на странице может быть меньше элементов, чем limit.
Ошибки: 400 VALIDATION_ERROR, 403 FORBIDDEN, если вам не разрешено просматривать записи этой организации.
Получить запись
Заголовок раздела «Получить запись»GET /v1/recordings/:idВозвращает полные сведения об одной записи.
Запись организации возвращается любому участнику, которому разрешено её просматривать. Владельцы и администраторы могут открывать каждую запись в своей организации. Редакторы и наблюдатели видят то, что разрешают их роль и папки. Для записи организации is_locked, download_url и capabilities зависят от тарифа организации и доступа участника к функциям, а не от вашего личного тарифа.
{ "data": { "id": "uuid", "title": "Weekly sync", "status": "COMPLETED", "created_at": "2026-09-19T15:00:00.000Z", "updated_at": "2026-09-19T15:30:00.000Z", "started_at": "2026-09-19T15:01:00.000Z", "ended_at": "2026-09-19T15:30:00.000Z", "duration_seconds": 1740, "thumbnail_url": "https://...", "download_url": "https://...", "download_url_expires_at": "2026-09-19T21:30:00.000Z", "folder_id": null, "organization_id": null, "processing_progress": null, "transcription": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "segments_count": 184 }, "notes": "## Key topics\n...", "notes_status": "completed", "notes_truncated": false, "sharing": { "is_shared": true, "share_url": "https://recordmeeting.com/app/shared/abc123" }, "participants": [ { "id": "participant_id", "displayName": "Alice", "email": "alice@example.com", "source": "calendar", "isOrganizer": true, "mappedSpeaker": "Alice", "avatarUrl": null } ], "media_type": "video", "is_locked": false, "open_url": "https://recordmeeting.com/app/recording/uuid", "media": { "hls_url": "https://...", "direct_url": "https://...", "expires_at": "2026-09-19T21:30:00.000Z" }, "capabilities": { "canDownload": true, "canShare": true, "canViewTranscription": true, "canStartTranscription": true, "canRegenerateTranscription": false, "canRenameSpeaker": true, "canReplaceText": true, "canViewSummary": true, "canGenerateSummary": true, "canAskQuestions": true, "canGenerateArtifacts": true } }}Поля, которые нужно знать
Заголовок раздела «Поля, которые нужно знать»| Поле | Описание |
|---|---|
notes | Заметки встречи в Markdown. null, если их нет или запись заблокирована |
download_url | Временная ссылка для скачивания. null, если capabilities.canDownload не равен true. Истекает в download_url_expires_at |
media | Временные ссылки для воспроизведения. Запросите запись снова после истечения expires_at |
media_type | video или audio |
is_locked | true, когда запись заблокирована. Тогда transcription и notes равны null |
open_url | Страница записи в веб-приложении |
sharing.share_url | Ссылка записи для общего доступа или null, если её нет |
Ошибки: 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED, если подписка Enterprise организации больше не активна.
Получить транскрипт
Заголовок раздела «Получить транскрипт»GET /v1/recordings/:id/transcriptВозвращает транскрипт записи в виде сегментов, постранично, с разбиением на фрагменты.
Для записей организации действуют те же правила доступа, что и в разделе Получить запись. Запись, у которой ещё нет транскрипта, всё равно возвращает 200 со значением "status": "not_started" и пустым массивом segments.
Параметры запроса
Заголовок раздела «Параметры запроса»| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
start_chunk | integer | 0 | Индекс первого возвращаемого фрагмента |
limit | integer | 50 | Количество фрагментов (от 1 до 100) |
{ "data": { "status": "completed", "language": "en", "speakers": ["Alice", "Bob"], "duration": 1740.5, "segments": [ { "id": 1, "start": 0.5, "end": 3.2, "text": "Good morning everyone.", "speaker": "Alice", "confidence": 0.97 } ], "pagination": { "total_chunks": 4, "has_more": true } }}start и end указаны в секундах. speaker и confidence могут быть null. Пока has_more равен true, запрашивайте следующую страницу с большим значением start_chunk.
Ошибки: 403 RECORDING_LOCKED для заблокированной записи, 403 TRANSCRIPT_NOT_AVAILABLE, если транскрипция отключена для организации или участника, 403 SUBSCRIPTION_REQUIRED, если для полного транскрипта нужен платный тариф, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Обновить запись
Заголовок раздела «Обновить запись»PATCH /v1/recordings/:idПереименовывает запись, заменяет заметки встречи или делает и то и другое. Требуется хотя бы одно поле.
Тело запроса
Заголовок раздела «Тело запроса»{ "title": "New title", "notes": "## Notes\nIn Markdown"}| Поле | Описание |
|---|---|
title | От 1 до 500 символов |
notes | Заметки встречи в Markdown, до 100 000 символов. Заменяют существующие заметки |
204 No Content с пустым телом.
Ошибки: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND.
Удалить запись
Заголовок раздела «Удалить запись»DELETE /v1/recordings/:idБезвозвратно удаляет запись и все её данные: транскрипт, заметки и ссылки для общего доступа.
204 No Content с пустым телом.
Ошибки: 404 RECORDING_NOT_FOUND.
Создать ссылку для общего доступа
Заголовок раздела «Создать ссылку для общего доступа»POST /v1/recordings/:id/share-linkСоздаёт публичную ссылку записи для общего доступа или заменяет существующую. Предыдущая ссылка перестаёт работать.
Для записи организации ссылку может создать любой участник, которому разрешено просматривать запись. Она создаётся от имени владельца записи и использует тариф организации.
Тело запроса
Заголовок раздела «Тело запроса»{ "permission": "view"}| Значение | Описание |
|---|---|
view | Люди со ссылкой могут смотреть запись |
download | Люди со ссылкой также могут скачать её |
{ "data": { "share_url": "https://recordmeeting.com/app/shared/abc123", "share_token": "abc123", "permission": "view" }}Ошибки: 400 VALIDATION_ERROR, 400 RECORDING_NOT_READY, если запись ещё нельзя открыть для общего доступа, 403 RECORDING_LOCKED, 403 SHARING_DISABLED, если общий доступ отключён для организации или участника, 403 SUBSCRIPTION_REQUIRED, если для этого разрешения нужен платный тариф, 404 RECORDING_NOT_FOUND, 402 ORGANIZATION_SUBSCRIPTION_EXPIRED.
Статусы записи
Заголовок раздела «Статусы записи»| Статус | Описание |
|---|---|
STARTING | Запись настраивается |
CONNECTING | Подключение к встрече |
WAIT_APPROVAL | Ожидание разрешения на запись |
RECORDING | Идёт запись |
STALE | Запись перестала отправлять данные до завершения |
UPLOADING | Запись остановлена, но всё ещё загружается |
PROCESSING | Видео обрабатывается и пока не может воспроизводиться |
MIGRATING | Видео можно воспроизводить, пока его перемещают в долгосрочное хранилище |
COMPLETED | Запись полностью обработана |
ERROR | Запись завершилась ошибкой |