查父节点
更新时间:2025-04-08 02:51:37

查父节点

请求方法

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'
本页目录