对比树版本号
请求方法
POST
请求地址
/users/{userId}/tree/compareTreeVersion
请求参数
| 请求参数 |
参数类型 |
数据类型 |
是否必需 |
描述 |
| version |
Body |
Long |
否 |
要被比较的版本号,第一次传0，后续用响应中的version作为参数，不传默认为0 |
| types |
Body |
Integer[] |
是 |
要获取的树类型，如用户树、设备树，详见树类型对象定义 |
| onlyGroup |
Body |
Boolean |
否 |
是否只获取分组，不包含叶子节点数据，true：只查分组，false：分组和叶子都查。默认为false |
| permissionVersion |
Body |
Long |
否 |
可见权限版本，默认为0 |
HTTP状态码
| 返回值 |
描述 |
| 200 |
操作成功 |
| 400 |
客户端传参异常 |
| 401 |
鉴权失败 |
| 500 |
服务端异常 |
树类型对象定义
| 类型 |
值 |
| 用户树 |
1 |
| 设备树 |
3 |
| VMR树 |
5 |
| 会议室树 |
7 |
| 第三方设备树 |
9 |
| 企业树 |
16 |
响应参数
| 参数 |
数据类型 |
描述 |
| version |
Long |
当前树版本 |
| permissionVersion |
Long |
当前可见权限版本 |
| changed |
Boolean |
是否变更 |
请求消息示例
GET /open/api/v2/users/{userId}/tree/compareTreeVersion HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"version": 1675664958908,//当前树版本
"permissionVersion": 1675413305599,// 当前可见权限版本
"changed": true
}
CURL命令示例
curl -XPOST -H 'Authorization: Bearer
eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM
0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXorKU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp:
1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d
'{"version":1658971768982,"types":[1]}' 'https://api.yealink.com/open/api/v2/users/1146fcc46865439391c8632db3e86315/tree/compareTreeVersion'