通讯录用户管理查询部门的人员信息列表(详细信息)

举报
云会议运营喵大人 发表于 2020/02/11 12:30:07 2020/02/11
【摘要】 查询部门的人员信息列表(详细信息)根据部门ID获取部门内所有用户的详细信息列表,支持分页查询。请求格式说明请求方式: GET (HTTPS)请求地址: https://open.welink.huaweicloud.com/api/contact/v1/user/users认证方式: access_token,请参考获取access_token请求头部:Accept-Charset:UTF-...

查询部门的人员信息列表(详细信息)


根据部门ID获取部门内所有用户的详细信息列表,支持分页查询。

请求格式说明

请求方式: GET (HTTPS)

请求地址: https://open.welink.huaweicloud.com/api/contact/v1/user/users

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

请求头部:

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

请求参数说明:  

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

请求示例:

curl -X GET "https://open.welink.huaweicloud.com/api/contact/v1/user/users?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": [{          "userStatus": "1",                     //状态, 1:未开户,2:开户中,3:已开户,4:已销户
          "userId": "zhangsan1@welink",       //用户帐号, Key值
          "deptCode": "10001",                   //部门Id, Key值, 必填
          "deptNameCn": "72270测试部门",          "deptNameEn": "72270Test Dept",          "mobileNumber": "+86-15811847236",     //绑定手机号码, 必填
          "phoneNumber": "+86-15811847236",      //手机号码
          "landlineNumber": "0755-88888888",     //电话号码(座机)
          "userNameCn": "张三",                  //用户中文名称, 必填
          "userNameEn": "zhangshan",            //用户英文名称, 必填
          "sex": "M",                           //性别, 仅:M/F, M: 男, F: 女, 必填
          "corpUserId": "36188",                //用户工号(集成用的字段,如果在开户时没有维护则为空)
          "userEmail": "zhangshan4@126.com",    //用户邮箱, 必填
          "secretary": "zhangshan@welink",   //秘书(用户帐号)
          "address": "广东省深圳",               //地址
          "remark": "欢迎加入WeLink",        //备注
          "creationTime": "2018-05-03 13:58:02",  //创建时间
          "lastUpdatedTime": "2018-05-03 13:58:02"  //最后更新时间
        },
        {          "userStatus": "1",                   //状态, 1:未开户2:开户中3:已开户4已销户
          "userId": "zhangsan1@welink",     //用户帐号, Key值
          "deptCode": "10001",                //部门Id, Key值, 必填
          "deptNameCn": "72270测试部门",          "deptNameEn": "72270Test Dept",          "mobileNumber": "+86-15811847236",  //绑定手机号码, 必填
          "phoneNumber": "+86-15811847236",   //手机号码
          "landlineNumber": "0755-88888888",  //电话号码(座机)
          "userNameCn": "张三",              //用户中文名称, 必填
          "userNameEn": "zhangshan",        //用户英文名称, 必填
          "sex": "M",                       //性别, 仅:M/F, M: 男, F: 女, 必填
          "corpUserId": "36188",            //用户工号(集成用的字段,如果在开户时没有维护则为空)
          "userEmail": "zhangshan4@126.com",  //用户邮箱, 必填
          "secretary": "zhangshan@welink", //秘书(用户帐号)
          "address": "广东省深圳",             //地址
          "remark": "欢迎加入WeLink",       //备注
          "creationTime": "2018-05-03 13:58:02",  //创建时间
          "lastUpdatedTime": "2018-05-03 13:58:02"  //最后更新时间
        }
    ]
}

异常返回结果

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

返回参数说明:

参数名必选类型参数说明
codestring数据正常返回“0”,如果发生错误,会返回对应的错误码
messagestring返回信息,包括接口请求发生错误时的详细信息
pageNoint当前页数
pagesint总共页数
pageSizestring每页显示数量
totalint总数量
dataarray用户信息:
>> userStatus: 状态
>> userId: 用户账号
>> deptCode : 部门编码
>> deptNameCn : 部门中文名称
>> deptNameEn : 部门英文名称
>> mobileNumber : 绑定手机号码
>> phoneNumber: 手机号码
>> landlineNumber: 电话号码(座机)
>> userNameCn: 用户中文名称
>> userNameEn: 用户英文名称
>> sex : 性别
>> corpUserId: 员工工号(企业内唯一标识)
>> userEmail: 邮箱
>> secretary: 秘书(用户帐号)
>> address: 地址
>> remark: 备注
>> creationTime: 创建时间
>> lastUpdatedTime: 最后更新时间

错误码说明:

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


【版权声明】本文为华为云社区用户原创内容,未经允许不得转载,如需转载请自行联系原作者进行授权。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。