获取员工列表

最后更新:2025/04/09

通过此接可获取企业在本应用可见范围内所有员工的信息

请求方式: GET(HTTPS)

请求地址: https://open.wshoto.com/openapi/department/user/list

参数说明:

参数 类型 必填 说明
access_token string 调用接口凭证
current_index int 页码。默认值为1
page_size int 列表返回长度。默认值为20,最大值为100

返回值:

{
  "code": 0,
  "msg": "请求成功",
  "data": {
    "total": 13,
    "records": [
      {
        "username": "用户A",
        "userId": "YongHuA",
        "alias": "",
        "mobile": "",
        "position": "",
        "email": "",
        "avatar": "",
        "main_department_id": "",
        "department_id": "[1,2,3]",
        "status": 1,
        "account_status": 1,
        "chat_data_status": 1,
        "qr_code": "qrCode.html"
      },
      {
        "username": "wentao",
        "userId": "wentao",
        "alias": "",
        "mobile": "",
        "position": "",
        "email": "",
        "avatar": "",
        "main_department_id": "",
        "department_id": "[1,2,3]",
        "status": 1,
        "account_status": 1,
        "chat_data_status": 1,
        "qr_code": "qrCode.html"
      }
    ]
  }
}

参数说明:

参数 类型 说明
code int 出错返回码,为0表示成功,非0表示调用失败
msg string 返回码描述
data Page 分页对象
  total int 数据条数
  records User[] 员工信息
    username string 员工名称,仅安装代开发自建应用且授权了员工名称权限后可获取。
    userId string 员工id,员工在本三方应用的密文用户id
    alias string 员工别名,仅安装代开发自建应用且授权了员工名称权限后可获取。
    mobile string 手机号码;从2022年6月20号20点开始,新创建/移入应用可见范围的员工不再返回此信息。
    position string 职务
    email string 联系邮箱;从2022年6月20号20点开始,新创建/移入应用可见范围的员工不再返回此信息。
    avatar string 头像地址
    main_department_id string 主部门id
    department_id string 成员所属部门id列表
    status int 成员激活状态: 1=已激活,2=已禁用,4=未激活,5=退出企业。已激活代表已激活企业微信或已关注微信插件(原企业号)。未激活代表既未激活企业微信又未关注微信插件(原企业号)。
    account_status int 成员开通本应用使用权限状态:1未开通 2绑定并开通 3已过期
    chat_data_status int 成员在企业微信会话存档的帐号开通状态: 0开通 1未开通 2历史开通
    qr_code string 员工二维码

results matching ""

    No results matching ""