查询硬件终端详情

请求方法

GET

请求地址

/devices/{deviceId}

请求参数

参数	参数类型	数据类型	是否必需	描述
deviceId	Path	String	是	设备主键id，长度32

HTTP状态码

返回值	描述
200	操作成功，详见响应参数
400	客户端传参异常
401	鉴权失败
500	服务端异常

响应参数

参数	数据类型	描述
id	String	主键id
partyId	String	所属企业id
groupId	String	分组id
name	String	名称
email	String	邮箱
number	String	号码
extension	String	分机号
password	String	密码
status	String	设备状态，"offline"：离线；"online"：在线
enableMeetNow	Boolean	是否启用即时会议功能
~~visiblePermission~~	VisiblePermission	可见权限，字段废弃

VisiblePermission

参数	数据类型	是否必须	描述
code	String	是	可见权限类型，详见可见权限类型
nodes	VisiblePermissionNode[]	否	节点数据，code为E时必填

VisiblePermissionNode

参数	数据类型	是否必须	描述
dataId	String	是	节点数据id，E权限时有效，其值为节点数据类型对应的实体id
dataType	Integer	否	节点数据类型，E权限时有效，详见节点数据类型

可见权限类型

可见权限类型	值
可见企业内全部联系人	A
可见所在部门及同级部门的所有联系人	B
仅可见所在部门的所有联系人	C
仅可见自己	D
自定义	E

节点数据类型

节点数据类型	值
用户分组	1
用户	2
设备分组	3
设备	4
VMR分组	5
VMR	6
外部联系人分组	9
外部联系人	10

请求消息示例

GET /v2/devices/04604de5880d41dc8cb93d07fc7723e8 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

响应消息示例

HTTP/1.1 200
Content-Type: application/json;charset=UTF-8

{
    "id":"a852349150554609bb5e706f21e8a79a",
    "partyId": "d5b53af1aafb4e9cb57faf080c4963ed",
    "groupId":"b7b8c729d60b4854a448a2db48182c7c",
    "name":"终端1",
    "email":"",
    "number":"82209640001",
    "extension":null,
    "password":"536fmt9a",
    "enableMeetNow": true,
    "status": "online"
}

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/v2/devices/04604de5880d41dc8cb93d07fc7723e8'