查询用户详情

请求方法

GET

请求地址

/open/api/v1/users/{userId}

请求参数

参数	参数类型	数据类型	是否必需	描述
userId	Path	String	是	用户主键id，长度32

HTTP状态码

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

响应参数

参数	数据类型	描述
id	String	主键id
partyId	String	所属企业id
groupId	String	分组id
name	String	名称
namePinyinForSearch	String	名称全拼，简拼用于搜索
email	String	邮箱
number	String	号码
mobile	String	手机号
mobileCode	String	手机区号
title	String	职位
gender	Integer	性别，0：保密；1：男；2：女
emailBound	Boolean	是否绑定邮箱
mobileBound	Boolean	是否绑定手机号码
isManager	Boolean	是否为管理员

请求消息示例

GET /open/api/v1/users/9ecc83e4c7d44728bbb1e2ec226dffe7 HTTP/1.1
Host: smart.yealink.com
Content-Type: application/json

响应消息示例

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

{
	"id": "12f6c26902424f0683c36474e44e3ea5",
	"partyId": "3e595d1fef004f1295c40692d862e8da",
	"groupId": "e69e2b513c114294aaf027ecc5fd892a",
	"name": "zd444",
	"namePinyinForSearch": "z,zd444,zd444",
	"email": "1828@yealink.com",
	"number": "81234561951",
	"mobile": "19911181828",
	"mobileCode": "86",
	"title": "经理1",
	"gender": 1,
	"emailBound": true,
	"mobileBound": true,
	"isManager": false
}

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://smart.yealink.com/open/api/v1/users/7e7e10443f92422ea0d70fa6398a8dd3'