获取部门用户简单信息列表


根据部门id获取部门内所有用户简单信息(如用户id,用户中文名称,用户英文名称)列表,支持分页查询。

请求格式说明

请求方式: GET (HTTPS)

请求地址: https://open.welink.huaweicloud.com/api/contact/v2/user/userid

认证方式: access_token,请参考获取access_token

请求头部:

Accept-Charset:UTF-8
Content-Type:application/json
x-wlk-Authorization:access_token

请求参数说明:

参数名 参数说明 类型 必选
deptCode 部门编码。从用户详细信息中获取部门编码 string
pageNo 当前页数。默认为1 string
pageSize 每页显示数量。默认为10(不能大于50) string

请求示例:


curl -X GET "https://open.welink.huaweicloud.com/api/contact/v2/user/userid?deptCode=3003" -H "Accept-Charset: utf-8" -H "x-wlk-Authorization: access_token"

响应格式说明

正常返回结果

  {
    "code": 0,
    "message": "OK",
    "pageNo": 1,
    "pages": 1,
    "pageSize": "10",
    "total": 2,
    "data": [{
            "userId": "test5365",
            "corpUserId": "test5365@huawei.com",
            "userNameCn": "测试5365",
            "userNameEn": "test5365"
        },
        {
            "userId": "test5363",
            "corpUserId": "test5363@huawei.com",
            "userNameCn": "测试5363",
            "userNameEn": "test5363"
        }
    ]
}

异常返回结果

  {
    "code": 47101,
    "message": "Token格式错误",
    "data": []
  }

返回参数说明:

参数名 必选 类型 参数说明
code int 数据正常返回“0”,如果发生错误,会返回对应的错误码
message string 返回信息,包括接口请求发生错误时的详细信息
pageNo int 当前页数
pages int 总共页数
pageSize string 每页显示用户信息数量
total int 总数量
data array 用户简单信息:
>> userId: 用户账号
>> corpUserId: 员工工号(企业内唯一标识)
>> userNameCn: 用户中文名称
>> userNameEn: 用户英文名称

错误码说明:

错误码 说明
47000 无权限
47001 当前登录用户信息获取失败
47002 部门编码为空
47003 参数为空
47004 参数不对
47007 当前登录者是非法用户或个人详情已失效
47008 参数校验不通过
47009 提交失败
47012 无数据
47013 查询数量限制
47100 待处理
47101 Token格式错误
47102 无权限
47103 Token过期
47104 处理中
47105 秘书账号未创建
47106 上级部门未创建
500 系统错误

result. ""

    Not Found. ""