录制内容
用于录制、转写内容和分享链接的端点。所有路径都位于 https://api.recordmeeting.com,并且需要 API 密钥。请参阅身份验证。
GET /v1/recordings返回你有权访问的录制的分页列表。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
limit | integer | 20 | 结果数量(1 到 100) |
offset | integer | 0 | 分页偏移量 |
search | string | 无 | 按标题中的文本筛选 |
status | string | 无 | 按状态筛选(见录制状态) |
date_from | string | 无 | ISO 8601 日期时间。仅返回在该时间当天或之后创建的录制 |
date_to | string | 无 | ISO 8601 日期时间。仅返回在该时间当天或之前创建的录制 |
organization_id | string | 无 | 列出某个组织的录制 |
folder_id | string | 无 | 列出某个文件夹中的录制 |
user_id | string | 无 | 按用户筛选。适用于想查看某个成员录制的组织管理员 |
{ "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。
获取单个录制
Section titled “获取单个录制”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 } }}需要了解的字段
Section titled “需要了解的字段”| 字段 | 说明 |
|---|---|
notes | Markdown 格式的会议纪要。没有纪要或录制已锁定时为 null |
download_url | 临时下载链接。除非 capabilities.canDownload 为 true,否则为 null。它在 download_url_expires_at 时到期 |
media | 临时播放链接。expires_at 过后请重新请求该录制 |
media_type | video 或 audio |
is_locked | 录制被锁定时为 true。此时 transcription 和 notes 为 null |
open_url | 该录制在 Web 应用中的页面 |
sharing.share_url | 该录制的分享链接,没有分享链接时为 null |
错误:404 RECORDING_NOT_FOUND;当组织的企业版订阅不再有效时返回 402 ORGANIZATION_SUBSCRIPTION_EXPIRED。
获取转写内容
Section titled “获取转写内容”GET /v1/recordings/:id/transcript以片段形式返回录制的转写内容,并按块(chunk)分页。
组织录制遵循与获取单个录制相同的访问规则。尚无转写内容的录制仍会返回 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。
创建分享链接
Section titled “创建分享链接”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 | 录制失败 |