浏览 平台 API
服务端 API商业版

拉取会议聊天消息

复制

按创建时间和 Seq 增量拉取会议聊天消息。 此接口仅在 OpenIM 商业版中提供。请先在接入准备中配置 API 地址和有效 Token。

HTTP 请求

POST {API_ADDRESS}/rtc-meeting/pull_meeting_chat

请求示例

curl --request POST "${API_ADDRESS}/rtc-meeting/pull_meeting_chat" \
  --header "Content-Type: application/json; charset=utf-8" \
  --header "operationID: ${OPERATION_ID}" \
  --header "token: ${TOKEN}" \
  --data-raw '{
  "meetingID": "meeting_001",
  "createTime": 1719800000000,
  "currentSeq": 1,
  "srcUserID": "user_001"
}'
商业版:此接口需要部署对应的商业版服务。接口是否可用以及具体权限以客户交付版本为准。

请求体

{
  "meetingID": "meeting_001",
  "createTime": 1719800000000,
  "currentSeq": 1,
  "srcUserID": "user_001"
}
参数名是否必填类型说明
meetingIDstring会议 ID。
createTimeint创建时间,Unix 毫秒时间戳。
currentSeqint客户端最后接收的消息 Seq。
srcUserIDstring操作或消息发送者用户 ID。

响应

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

{
  "errCode": 0,
  "errMsg": "",
  "errDlt": "",
  "data": {
    "createTime": 1719800000000,
    "messages": [
      {
        "seq": 1,
        "sendID": "user_001",
        "contentType": 1,
        "content": "示例内容",
        "createTimeMs": 1719800000000,
        "dstUserIDs": ["user_001"],
        "nickname": "示例名称",
        "faceURL": "https://example.com/resource"
      }
    ]
  }
}

响应参数

参数名类型说明
errCodeint业务错误码,0 表示成功。
errMsgstring错误简要信息,成功时通常为空。
errDltstring错误详细信息,成功时通常为空。
data.createTimeint创建时间,Unix 毫秒时间戳。
data.messagesMeetingChatMessage[]结构为会议模块的 MeetingChatMessage

错误

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

权限和限制

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

相关页面