服务端 API商业版

按会议 ID 查询录制记录

批量查询指定会议的录制记录。此接口仅在 OpenIM 商业版中提供。请先在接入准备中配置 API 地址和有效 Token。

HTTP 请求

POST {API_ADDRESS}/rtc-meeting/get_meeting_records_by_meeting_ids

请求示例

curl --request POST "${API_ADDRESS}/rtc-meeting/get_meeting_records_by_meeting_ids" \
  --header "Content-Type: application/json; charset=utf-8" \
  --header "operationID: ${OPERATION_ID}" \
  --header "token: ${TOKEN}" \
  --data-raw '{
  "userID": "user_001",
  "meetingIDs": [
    "meeting_001"
  ]
}'

商业版：此接口需要部署对应的商业版服务。接口是否可用以及具体权限以客户交付版本为准。

请求体

{
  "userID": "user_001",
  "meetingIDs": ["meeting_001"]
}

参数名	是否必填	类型	说明
userID	是	string	OpenIM 用户 ID。
meetingIDs	是	string[]	会议 ID 列表。

响应

请求被 OpenIM 正常处理时通常返回 200 OK。业务是否成功以响应体中的 errCode 为准。

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "meetingRecords": [
      {
        "roomID": "room_001",
        "meetingName": "示例名称",
        "ex": "{}",
        "hostUserID": "user_001",
        "hostUserNickname": "user_001",
        "createTime": 1719800000000,
        "startTime": 1719800000000,
        "endTime": 1719800000000,
        "joinedUsers": [
          {
            "userID": "user_001",
            "nickname": "示例名称"
          }
        ],
        "status": 1,
        "fileRecords": [
          {
            "size": "example",
            "fileURL": "https://example.com/resource"
          }
        ],
        "egressID": "example",
        "downloadUrl": "https://example.com/resource",
        "egressUploading": false,
        "recordStatus": 1,
        "videoFileSize": 1,
        "videoCoverUrl": "https://example.com/resource",
        "videoName": "示例名称"
      }
    ]
  }
}

响应参数

参数名	类型	说明
errCode	int	业务错误码，`0` 表示成功。
errMsg	string	错误简要信息，成功时通常为空。
errDlt	string	错误详细信息，成功时通常为空。
data.meetingRecords	MeetingRecord[]	结构为会议模块的 `MeetingRecord`。

错误

错误响应使用 Platform API 通用结构，处理方式见错误码。

权限和限制

仅在 OpenIM 商业版中提供。
调用方必须校验操作用户和目标资源的业务权限。
请求数组和分页大小应遵循客户交付版本的服务端限制。

HTTP 请求

请求示例

请求体

响应

响应参数

错误

权限和限制

相关页面