跳转至

会议室查询

说明
  1. 此接口由众趣带看服务实现，客户业务系统调用。
  2. 客户业务系统持 takelook_token，经开放平台访问（路径前缀 {HostName}/api/v2/op/openapi/takelook/tencent/...）。转发时平台会在 JSON body 中注入 c_id、o_id、app_id（调用方可不传）。
  3. 用于按会议室 ID 拉取当前会议室元数据、会议列表及参与者。

方式一：QueryRoom POST（推荐）

请求
  • 方法 / 路径：POST {HostName}/api/v2/op/openapi/takelook/tencent/rooms/query/
  • Header：Authorization: <takelook_token>（获取方式见 获取带看 token）
  • Content-Type：application/json
入参示例：
{
    "roomId": 10000123
}
入参参数说明：
参数名 数据类型 是否必传 参数说明
roomId int/string 是* 会议室 ID，整数或可解析为整数的值（推荐使用此字段）
room_id int/string 是* 与 roomId 等价；若同时传入，以 roomId 为准

* roomId 与 room_id 至少传一个。

成功响应示例：
{
    "code": 1,
    "msg": "success",
    "data": {
        "roomId": 10000123,
        "createTime": "2026-05-12T12:30:00+08:00",
        "active": true,
        "roomType": 1,
        "meetings": [
            {
                "meetingId": 20000456,
                "startTime": "2026-05-12T12:35:10+08:00",
                "endTime": null,
                "status": 1,
                "participants": [
                    {
                        "userId": "1448291745301000000",
                        "joinTime": "2026-05-12T12:35:10+08:00",
                        "exitTime": null,
                        "isFirst": true
                    },
                    {
                        "userId": "1448176777690000000",
                        "joinTime": "2026-05-12T12:36:02+08:00",
                        "exitTime": null,
                        "isFirst": false
                    }
                ]
            }
        ]
    }
}
返回参数说明：

data 字段：

字段名 数据类型 参数说明
roomId int 会议室 ID
createTime string 会议室创建时间，ISO8601 格式
active bool 会议室是否进行中
roomType int 会议室类型
meetings array 会议列表，元素见下表

meetings 数组元素：

字段名 数据类型 参数说明
meetingId int 会议 ID
startTime string 会议开始时间，ISO8601 格式
endTime string 会议结束时间，未结束时为 null
status int 会议状态
participants array 参与者列表，元素见下表

participants 数组元素：

字段名 数据类型 参数说明
userId string 用户 ID
joinTime string 加入时间，ISO8601 格式
exitTime string 离开时间，未离场时为 null
isFirst bool 是否为该场会议的首位加入者
常见错误码：
错误码 说明
33001 缺少 roomId / room_id
10002 会议室不存在

方式二：等价 GET（路径参数）

请求
  • 方法 / 路径：GET {HostName}/api/v2/op/openapi/takelook/tencent/rooms/{room_id}/
  • Header：Authorization: <takelook_token>

其中 {room_id} 为会议室 ID。返回 JSON 结构与 POST rooms/query/ 的 data 完全一致。

相关文档