获取员工列表
最后更新: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 | 职务 |
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 | 员工二维码 |