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是获取的部门idfetch_child否是否递归获取子部门下面的成员:1-递归获取,0-只获取本部门权限说明:
应用须拥有指定部门的查看权限。
返回结果:
{"errcode": 0,"errmsg": "ok","userlist": [{"userid": "zhangsan","name": "张三","department": [1, 2],"open_userid": "xxxxxx"}]}参数说明:
参数说明errcode返回码errmsg对返回码的文本描述内容userlist成员列表userid成员UserID。对应管理端的帐号name成员名称,代开发自建应用需要管理员授权才返回;此字段从2023年12月30日起,对新创建第三方应用不再返回真实name,使用userid代替name,2023年6月30日起,对所有历史第三方应用不再返回真实name,使用userid代替name,后续第三方仅通讯录应用可获取,未返回名称的情况需要通过通讯录展示组件来展示名字department成员所属部门列表。列表项为部门ID,32位整型open_userid全局唯一。对于同一个服务商,不同应用获取到企业内同一个成员的open_userid是相同的,最多64个字节。仅第三方应用可获取官方文档:获取部门成员 - 企业微信API