查父节点
请求方法
POST
请求地址
/users/parentTreeNodes
请求参数
请求参数 |
参数类型 |
数据类型 |
是否必需 |
描述 |
dataIds |
Body |
String[] |
是 |
数据ID列表 ,数组长度最大为500 |
needNamePinYinForSearch |
Body |
Boolean |
否 |
是否需要拼音搜索字段返回,默认为false |
HTTP状态码
返回值 |
描述 |
200 |
操作成功 |
400 |
客户端传参异常 |
401 |
鉴权失败 |
500 |
服务端异常 |
响应参数
参数 |
参数类型 |
描述 |
nodes |
Nodes[] |
父节点列表 |
Nodes对象定义
参数 |
数据类型 |
描述 |
dataId |
String |
节点数据id |
parentDataId |
String |
父节点数据id |
parentName |
String |
父节点名称 |
parentNamePinyinForSearch |
String |
父节点名称全拼,简拼,供搜索 |
请求消息示例
POST /open/api/v2/users/parentTreeNodes HTTP/1.1
Host: api.yealink.com
Content-Type: application/json
{
"dataIds": [
"2049545fc73b4c4899bb4dead34ce2cc"
],
"needNamePinYinForSearch": true
}
响应消息示例
HTTP/1.1 200
Content-Type: application/json;charset=UTF-8
{
"nodes": [
{
"dataId": "1332fede469d46b09026a4baa96ef52a", //节点数据ID
"parentDataId": "0405a48eb8354592a1287dccca48d4e7",//父节点数据id
"parentName": "fwq1",//父节点名称
"parentNamePinyinForSearch": "f,fwq1,fwq1"//父节点拼音,供搜索
}
]
}
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
'{"dataIds":["1332fede469d46b09026a4baa96ef52a"],"needNamePinYinForSearch": true}' 'https://api.yealink.com/open/api/v2/users/parentTreeNodes'