根据第三方账号查询用户列表

请求方法

POST

请求地址

/users/byExtAccounts

请求参数

参数	参数类型	数据类型	是否必需	描述
accounts	Body	String[]	是	查询的第三方账号列表，目前支持AD账号，一次最多查200个

HTTP状态码

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

响应参数

参数	参数类型	描述
users	User[]	用户列表

User对象定义

参数	数据类型	描述
id	String	主键id，用户id
partyId	String	所属企业id
name	String	名称
alias	String	用户别名
email	String	邮箱
title	String	职位
gender	Integer	性别，0：保密；1：男；2：女
extAccount	String	第三方账号，如AD账号 th489211

请求消息示例

GET /open/api/v2/users/byExtAccounts HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

响应消息示例

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

{
    “users”:[
      {
		"id": "8d07a56207074d26b61026099625b9e2",
		"partyId": "c22c0ab68bc74219aa894261b2d131dc",
		"name": "zd2",
		"alias": "zz",
		"email": null,
	    "extAccount": "th489211", // 第三方账号：AD账号
		"title": null,
		"gender": null
      }
    ]
}

CURL命令示例

curl -XPOST -H 'Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJwc3QiOjAsImFyZWEiOiJDTi1GSiIsImNvdW50cnkiOiJDTiIsImN0IjoxLCJzIjo1NCwiZXgiOjE1ODMxMTc3MzMxNzMsInQiOiJvIiwiY2kiOiIxZGU3MzA4YzZlYzM0YmZlODY5OWY0ZmQ0ZjZlMWE4MyIsInBpZCI6IjE5MmI4NmM4MzNhMDQ5OGFiNWU5NTgwMGE0YWMxOWU4IiwianRpIjoiMTkwYzljMDgxMzA2NDQ3M2IxZTI0MDY4YzE1OWFmOWEifQ.UPbzEA5i4To9SAWXor-KU835cBaRp3Ws_aZI6MHIrcqy8l2BSXz_XdgiGU5D3Cv0QwF7Bt9oWScNOspk4AbWVRTtYMhQfsVuemwBHD7BVth3UiBJDyScl-kcoQ_2vajUlv-pglcCQtNLfPyzH6Dk1gKzcrMSmYRKtIjqNyuFOmg' -H 'timestamp: 1583742732181' -H 'nonce: 53f0765fadb54fb6b002f3baac2d5ec8' -H "Content-type: application/json" -d '{"accounts":["th489211","hy1234"]}' 'https://api.yealink.com/open/api/v2/users/byExtAccounts'