查询会议室树
请求方法
GET
请求地址
/rooms/tree
请求参数
无
HTTP状态码
返回值 | 描述 |
---|---|
200 | 操作成功,详见Node[] |
400 | 客户端传参异常 |
401 | 鉴权失败 |
500 | 服务端异常 |
Node对象定义
参数 | 数据类型 | 描述 |
---|---|---|
id | String | 节点id |
parentId | String | 父节点Id |
index | Long | 分组下序号 |
dataType | Integer | 节点数据类型,7:会议室分组,8:会议室 |
dataId | String | 对应数据类型的主键id |
type | Integer | 节点类型,0:非叶子节点,也就是会议室分组,1:叶子节点,也就是会议室 |
name | String | 节点名称 |
number | String | 会议室账号 |
locationType | Integer | 位置类型,会议室分组的该值才有效,0:虚拟节点 ,2:建筑,3:楼层 |
roomType | Integer | 会议室类型,0:普通会议室,1:视频会议室 |
enableScheduled | Boolean | 是否启用会议室 true为启用,false 为未启用 |
scheduledMode | Integer | 预约模式 0(自由预约,默认)/1(仅临时占用)/-1(默认值) |
physicalLocation | String | 物理地点。该字段目前仅应用在梯控模块物理楼层使用。 |
请求消息示例
GET /open/api/v2/rooms/tree HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
[
{
"id": "e67c034de28c48e2b3dd22c1773b7f4d",
"partyId": "383c6d858c7946d0ab1c3048d7cc65e5",
"parentId": null,
"index": 2,
"type": 0,
"dataId": "9723400db3e24c319372eefb59b6a411",
"dataType": 7,
"name": "TEST",
"number": null,
"locationType": 0,
"enableScheduled": true,
"scheduledMode": -1,
"roomType": -1,
"physicalLocation": "13B" // 物理地点
},
{
"id": "4f3bebc3c91544dcaace477c07817263",
"partyId": "383c6d858c7946d0ab1c3048d7cc65e5",
"parentId": "e67c034de28c48e2b3dd22c1773b7f4d",
"index": 10000,
"type": 0,
"dataId": "c29d36b1069b416fbb32b19cb9eab898",
"dataType": 7,
"name": "办公楼",
"number": null,
"locationType": 2,
"enableScheduled": true,
"scheduledMode": -1,
"roomType": -1,
"physicalLocation": "13A" // 物理地点
},
{
"id": "a36d77283745403082ae29cccc1cebe4",
"partyId": "383c6d858c7946d0ab1c3048d7cc65e5",
"parentId": "4f3bebc3c91544dcaace477c07817263",
"index": 10000,
"type": 0,
"dataId": "b78249ec324a401eb47d06965015cf99",
"dataType": 7,
"name": "1楼",
"number": null,
"locationType": 3,
"enableScheduled": true,
"scheduledMode": -1,
"roomType": -1,
"physicalLocation": "12A" // 物理地点
},
{
"id": "c3e0a145fa9f4076b3df45c41794e6f1",
"partyId": "383c6d858c7946d0ab1c3048d7cc65e5",
"parentId": "a36d77283745403082ae29cccc1cebe4",
"index": 10000,
"type": 1,
"dataId": "c6811494b73d498391a94308466fce5c",
"dataType": 8,
"name": "QAQ",
"number": "3263064543",
"locationType": 0,
"enableScheduled": true,
"scheduledMode": 0,
"roomType": 1,
"physicalLocation": "13A" // 物理地点
}
]
CURL命令示例
curl -XGET -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" 'https://api.yealink.com/open/api/v2/rooms/64bb26c0065b4a54b0dd659e365e93b9/tree'