获取企业下的可用设备列表。
请求方式: POST(HTTPS)
请求地址: https://qyapi.weixin.qq.com/cgi-bin/meeting/rooms/list_devices?access_token=ACCESS_TOKEN
请求包体:
{
"meeting_room_name": "ROOMNAME",
"cursor": "CURSOR",
"limit": 50
}
参数说明:
参数 | 必须 | 类型 | 说明 |
---|---|---|---|
access_token | 是 | string | 调用接口凭证。获取方法查看“获取access_token” |
meeting_room_name | 否 | string | Rooms会议室名称(支持模糊匹配查找) |
cursor | 否 | string | 分页查询用,将上一个请求返回的next_cursor字段传入。第一次查询时可不传值 |
limit | 否 | uint32 | 分页大小,从1开始,最大50,默认20 |
注意:
limit参数必须与首次调用获得cursor时传入的limit一致。
权限说明
返回结果:
{
"errcode": 0,
"errmsg": "ok",
"has_more": true,
"next_cursor": "CURSOR",
"device_info_list":[
{
"meeting_room_id":"100001",
"rooms_id": "45613",
"meeting_room_name":"会议室测试1",
"meeting_room_location":"广州-大厦-10",
"device_model": "TT-IP65T",
"app_version":"4.1.6.0",
"meeting_room_status":1,
"device_monitor_info": {
"camera_status": true,
"microphone_status": true,
"speaker_status": true
}
}
]
}
参数说明:
参数 | 类型 | 说明 |
---|---|---|
errcode | int32 | 返回码 |
errmsg | string | 对返回码的文本描述内容 |
has_more | bool | 是否还有更多Rooms会议室列表 |
next_cursor | string | 分页用,has_more为true时,下一次拉取列表将该字段填入cursor字段 |
device_info_list | object[] | 设备信息对象列表,详见DeviceInfo |
DeviceInfo说明
参数 | 类型 | 说明 |
---|---|---|
meeting_room_id | string | Rooms会议室 ID |
rooms_id | string | Rooms ID |
meeting_room_name | string | Rooms会议室名称 |
meeting_room_location | string | Rooms会议室地址 |
device_model | string | 设备型号 |
app_version | string | 激活码 |
meeting_room_status | uint32 | Rooms会议室状态: 0:未激活 1:未绑定 2:空闲 3:使用中 4:离线 |
device_monitor_info | object | 设备健康信息,详见DeviceMonitorInfo |
DeviceMonitorInfo说明
参数 | 类型 | 说明 |
---|---|---|
camera_status | bool | 摄像头健康状态 |
microphone_status | bool | 麦克风健康状态 |
speaker_status | bool | 扬声器健康状态 |