会议录制

列出会议录制

GET /api/v1/recordings

返回经过身份验证的用户可访问的会议录制分页列表。

查询参数

参数	类型	默认值	描述
`limit`	number	`20`	结果数量 (1–100)
`offset`	number	`0`	分页偏移量
`search`	string	-	按标题筛选 (部分匹配)
`status`	string	-	按状态筛选 (参见会议录制状态)
`date_from`	string	-	ISO 8601 日期 - 仅返回在此日期或之后创建的会议录制
`date_to`	string	-	ISO 8601 日期 - 仅返回在此日期或之前创建的会议录制
`organization_id`	string	-	范围限定到组织
`folder_id`	string	-	范围限定到文件夹 (需要 `organization_id`)

响应

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "每周同步",
      "createdAt": "2025-09-19T15:00:00.000Z",
      "thumbnailUrl": "https://...",
      "progress": 1.0,
      "capabilities": {
        "canDownload": true,
        "canShare": true,
        "canViewTranscription": true,
        "canGenerateSummary": true,
        "canAskQuestions": true
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

获取会议录制

GET /api/v1/recordings/:id

返回单个会议录制的完整详情。

响应

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "每周同步",
    "createdAt": "2025-09-19T15:00:00.000Z",
    "updatedAt": "2025-09-19T15:30:00.000Z",
    "startedAt": "2025-09-19T15:01:00.000Z",
    "endedAt": "2025-09-19T15:30:00.000Z",
    "videoUrl": "https://...",
    "hlsUrl": "https://...",
    "downloadUrl": "https://...",
    "downloadUrlExpiresAt": "2025-09-19T21:00:00.000Z",
    "thumbnailUrl": "https://...",
    "organizationId": "org_uuid or null",
    "transcription": {
      "status": "completed",
      "language": "en",
      "speakers": ["发言人 1", "发言人 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## 主要话题\n...",
      "topics": [
        {
          "title": "项目时间表",
          "keyPoints": [
            { "point": "发布日期已确认", "details": ["定于第一季度"] }
          ]
        }
      ]
    },
    "isLocked": false,
    "capabilities": {
      "canDownload": true,
      "canShare": true,
      "canViewTranscription": true,
      "canStartTranscription": true,
      "canRegenerateTranscription": false,
      "canRenameSpeaker": true,
      "canViewSummary": true,
      "canGenerateSummary": true,
      "canAskQuestions": true
    }
  }
}

获取转录片段

GET /api/v1/recordings/:id/transcript

返回会议录制的分页转录片段。

查询参数

参数	类型	默认值	描述
`start_chunk`	number	`0`	从此块索引开始
`limit`	number	`50`	块的数量 (1–100)

响应

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["发言人 1", "爱丽丝"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "大家早上好。",
        "speaker": "爱丽丝",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

更新会议录制

PATCH /api/v1/recordings/:id

更新会议录制的标题或备注。至少需要一个字段。

请求正文

{
  "title": "新标题 (1–500 个字符)",
  "notes": "可选备注 (最多 100,000 个字符)"
}

响应

{
  "data": { "success": true }
}

删除会议录制

DELETE /api/v1/recordings/:id

永久删除会议录制及其所有相关数据（转录、摘要、共享）。

响应

{
  "data": { "success": true }
}

创建共享链接

POST /api/v1/recordings/:id/share-link

为会议录制生成公共共享链接。

请求正文

{
  "permission": "view"
}

值	描述
`view`	收件人可以观看视频并访问转录/摘要
`download`	收件人还可以下载视频文件

响应

{
  "data": {
    "share_url": "https://recordmeeting.com/app/shared/abc123",
    "share_token": "abc123",
    "permission": "view"
  }
}

会议录制状态

状态	描述
`STARTING`	收到录制请求，正在设置
`CONNECTING`	正在连接 Google Meet 会话
`WAIT_APPROVAL`	等待通话中批准录制
`RECORDING`	正在录制
`UPLOADING`	客户端上传中 (数据块正在传输到存储)
`PROCESSING`	Cloudflare Stream 正在打包 HLS/DASH - 尚无法播放
`MIGRATING`	视频完全可播放；HLS 正在迁移到长期存储
`COMPLETED`	会议录制已完全处理和存储
`ERROR`	会议录制失败

API 使用者应将 MIGRATING 和 COMPLETED 视为相同，用于播放、下载和共享操作 - 区别在于内部。