根据用户账号查询用户
更新时间:2025-01-23 17:18:37

根据用户账号查询用户

请求方法

GET

请求地址

/accounts/users

请求参数

参数 参数类型 数据类型 是否必需 描述
account Query String 账号
accountType Query Integer 账号类型,非必填, 默认为企业成员信息的 number 类型。可填:0 邮箱账号,1 手机号,13 第三方账号类型

HTTP状态码

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

响应参数

参数 数据类型 描述
id String 主键id
groupId String 分组id
name String 名称
number String 号码
extension String 分机号
encryptedPassword String MD5 算法加密后的密文密码,若系统强制使用国密,则为 SM3 算法加密
title String 职位
gender Integer 性别,0 保密,1 男,2 女
mobile String 手机号
email String 邮箱
namePinyin String 名称全拼
signature String 签名

请求消息示例

GET /open/api/v2/accounts/users?account=7777771111 HTTP/1.1
Host: api.yealink.com
Content-Type: application/json

响应消息示例

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

{
    "id": "70af3721acb34aef8ffc7bf9fa26d5d8",
    "groupId": "358fb5cfcf9b4939ad0df6baefa1f5a3",
    "number": "7777771111",
    "extension": "1111",
    "name": "test",
    "encryptedPassword": "cbeaf062187c272dc7992e5c6bb437f2",
    "title": null,
    "gender": 0,
    "mobile": "13500000000",
    "email": "test@yealink.com",
    "namePinyin": "9999",
    "signature": "test"
}

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/open/api/v2/accounts/users?account=7777771111'
本页目录