手机网页端对接企业微信:1获取企业微信的所有用户

1.获取token

 https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRE

corpid :为企业id

corpsecret:应用的凭证密钥

返回值:

{
   "errcode": 0,
   "errmsg": "ok",
   "access_token": "accesstoken000001",
   "expires_in": 7200
}

官方文档:

获取access_token - 企业微信API

2.获取企业微信下的所有部门:

https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=上面获取到的token

返回值:

{
   "errcode": 0,
   "errmsg": "ok",
   "department": [
       {
           "id": 2,
           "name": "广州研发中心",
           "name_en": "RDGZ",
           "department_leader":["zhangsan","lisi"],
           "parentid": 1,
           "order": 10
       },
       {
           "id": 3,
           "name": "邮箱产品部",
           "name_en": "mail",
           "department_leader":["lisi","wangwu"],
           "parentid": 2,
           "order": 40
       }
   ]
}

官方文档:获取部门列表 - 企业微信API

3.获取部门下的成员

调试工具

请求方式:GET(HTTPS
请求地址:https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID&fetch_child=FETCH_CHILD

参数说明:

参数 必须 说明
access_token 调用接口凭证
department_id 获取的部门id
fetch_child 是否递归获取子部门下面的成员:1-递归获取,0-只获取本部门

权限说明:

应用须拥有指定部门的查看权限。

返回结果:

 
 
{
"errcode": 0,
"errmsg": "ok",
"userlist": [
{
"userid": "zhangsan",
"name": "张三",
"department": [1, 2],
"open_userid": "xxxxxx"
}
]
}

参数说明:

参数 说明
errcode 返回码
errmsg 对返回码的文本描述内容
userlist 成员列表
userid 成员UserID。对应管理端的帐号
name 成员名称,代开发自建应用需要管理员授权才返回;此字段从2019年12月30日起,对新创建第三方应用不再返回真实name,使用userid代替name,2020年6月30日起,对所有历史第三方应用不再返回真实name,使用userid代替name,后续第三方仅通讯录应用可获取,未返回名称的情况需要通过通讯录展示组件来展示名字
department 成员所属部门列表。列表项为部门ID,32位整型
open_userid 全局唯一。对于同一个服务商,不同应用获取到企业内同一个成员的open_userid是相同的,最多64个字节。仅第三方应用可获取

官方文档:获取部门成员 - 企业微信API

猜你喜欢

转载自blog.csdn.net/zhaofuqiangmycomm/article/details/121523011