Перейти к содержимому

Записи

Эндпоинты для записей, транскриптов и ссылок для общего доступа. Все пути находятся на https://api.recordmeeting.com и требуют API-ключ. См. Аутентификация.

GET /v1/recordings

Возвращает постраничный список записей, к которым у вас есть доступ.

ПараметрТипПо умолчаниюОписание
limitinteger20Количество результатов (от 1 до 100)
offsetinteger0Смещение пагинации
searchstringnoneФильтр по тексту в заголовке
statusstringnoneФильтр по статусу (см. Статусы записи)
date_fromstringnoneДата и время в формате ISO 8601. Только записи, созданные в это время или позже
date_tostringnoneДата и время в формате ISO 8601. Только записи, созданные в это время или раньше
organization_idstringnoneПоказать записи организации
folder_idstringnoneПоказать записи папки
user_idstringnoneФильтр по пользователю. Для администраторов организации, которым нужны записи одного участника
{
"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_typevideo или audio
is_lockedtrue, когда запись заблокирована. Тогда 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_chunkinteger0Индекс первого возвращаемого фрагмента
limitinteger50Количество фрагментов (от 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Запись завершилась ошибкой