企微获取成员userID

简介: 企微获取成员userID

一、简介

同步数据到企微:

企业如果需要从自有的系统同步通讯录到企业微信,需要使用 通讯录同步secret

如果企业委托授权第三方服务商将通讯录从其他系统同步到企业微信,则需要企业授权“通讯录编辑授权”给服务商。

从企微获取数据:

自建应用、代开发应用、第三方应用在提供功能时,往往需要获取通讯录,开发者可查阅成员、部门、标签相关的接口说明。

注意,自建应用、代开发应用、第三方应用仅能读取通讯录,不能编辑,且仅能读取可见范围内的通讯录。

企微开发文档

https://developer.work.weixin.qq.com/document/path/90193

二、获取token

1、获取秘钥

获取corpid(企业ID)

获取corpsecret(应用的凭证密钥)

2、获取Token

请求方式: GET(HTTPS

请求地址: https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRET

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

参数说明:

参数 必须 说明
corpid 企业ID,获取方式参考:术语说明-corpid
corpsecret 应用的凭证密钥,注意应用需要是启用状态,获取方式参考:术语说明-secret

返回结果:

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

参数说明:

参数 说明
errcode 出错返回码,为0表示成功,非0表示调用失败
errmsg 返回码提示语
access_token 获取到的凭证,最长为512字节
expires_in 凭证的有效时间(秒)

注意事项:

开发者需要缓存access_token,用于后续接口的调用(注意:不能频繁调用gettoken接口,否则会受到频率拦截)。当access_token失效或过期时,需要重新获取。

access_token的有效期通过返回的expires_in来传达,正常情况下为7200秒(2小时),有效期内重复获取返回相同结果,过期后获取会返回新的access_token。

由于企业微信每个应用的access_token是彼此独立的,所以进行缓存时需要区分应用来进行存储。

access_token至少保留512字节的存储空间。

企业微信可能会出于运营需要,提前使access_token失效,开发者应实现access_token失效时重新获取的逻辑。

权限说明:

每个应用有独立的secret,获取到的access_token只能本应用使用,所以每个应用的access_token应该分开来获取

三、获取部门数据

官方页面

1、获取部门列表

**请求方式:**GET(HTTPS

**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token=ACCESS_TOKEN&id=ID

https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token={{access_token}}&id=1980054547

参数说明 :

参数 必须 说明
access_token 调用接口凭证
id 部门id。获取指定部门及其下的子部门(以及子部门的子部门等等,递归)。 如果不填,默认获取全量组织架构

2、获取子部门ID列表

**请求方式:**GET(HTTPS

**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access_token=ACCESS_TOKEN&id=ID

参数说明 :

参数 必须 说明
access_token 调用接口凭证
id 部门id。获取指定部门及其下的子部门(以及子部门的子部门等等,递归)。 如果不填,默认获取全量组织架构

3、获取单个部门详情

**请求方式:**GET(HTTPS

**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/department/get?access_token=ACCESS_TOKEN&id=ID

参数说明 :

参数 必须 说明
access_token 调用接口凭证
id 部门id。
https://qyapi.weixin.qq.com/cgi-bin/department/get?access_token={{access_token}}&id=4

四、获取成员信息

官方页面

1、读取成员

**请求方式:**GET(HTTPS

**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&userid=USERID

https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token={{ACCESS_TOKEN}}&userid={{USERID}}
参数 必须 说明
access_token 调用接口凭证
userid 成员UserID。对应管理端的帐号,企业内必须唯一。不区分大小写,长度为1~64个字节

2、获取部门成员

**请求方式:**GET(HTTPS

**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID

参数说明:

参数 必须 说明
access_token 调用接口凭证
department_id 获取的部门id

如需获取该部门及其子部门的所有成员,需先获取该部门下的子部门,然后再获取子部门下的部门成员,逐层递归获取。

3、获取部门成员详情

**请求方式:**GET(HTTPS

**请求地址:**https://qyapi.weixin.qq.com/cgi-bin/user/list?access_token=ACCESS_TOKEN&department_id=DEPARTMENT_ID

参数说明:

参数 必须 说明
access_token 调用接口凭证
department_id 获取的部门id

如需获取该部门及其子部门的所有成员,需先获取该部门下的子部门,然后再获取子部门下的部门成员,逐层递归获取。、

目录
相关文章
|
SQL 关系型数据库 数据库
学习分布式事务Seata看这一篇就够了,建议收藏
学习分布式事务Seata看这一篇就够了,建议收藏
17312 2
|
SQL Oracle 关系型数据库
避坑,Oracle中left join 与 (+) 的区别
避坑,Oracle中left join 与 (+) 的区别
|
移动开发 小程序
微信小程序web-view嵌入uni-app H5页面,通过H5页面跳转企业微信客户聊天窗口如何操作?
微信小程序web-view嵌入uni-app H5页面,通过H5页面跳转企业微信客户聊天窗口如何操作?
|
12月前
|
easyexcel Java UED
SpringBoot中大量数据导出方案:使用EasyExcel并行导出多个excel文件并压缩zip后下载
在SpringBoot环境中,为了优化大量数据的Excel导出体验,可采用异步方式处理。具体做法是将数据拆分后利用`CompletableFuture`与`ThreadPoolTaskExecutor`并行导出,并使用EasyExcel生成多个Excel文件,最终将其压缩成ZIP文件供下载。此方案提升了导出效率,改善了用户体验。代码示例展示了如何实现这一过程,包括多线程处理、模板导出及资源清理等关键步骤。
|
2月前
|
存储 人工智能 安全
医学影像PACS系统的设计与实现,PACS源码
医学影像PACS系统是数字化医院的核心,实现影像的采集、存储、传输与辅助诊断。系统基于DICOM、HL7等标准,采用分布式架构与模块化设计,支持影像分层存储、高效调阅、AI集成及多系统联动,提升诊疗效率与数据管理能力。
297 0
|
12月前
|
存储 安全 5G
|
算法 Java 编译器
java.lang.StackOverflowError解决方案
java.lang.StackOverflowError解决方案
465 3
|
9月前
|
JSON API 数据格式
京东商品SKU价格接口(Jd.item_get)丨京东API接口指南
京东商品SKU价格接口(Jd.item_get)是京东开放平台提供的API,用于获取商品详细信息及价格。开发者需先注册账号、申请权限并获取密钥,随后通过HTTP请求调用API,传入商品ID等参数,返回JSON格式的商品信息,包括价格、原价等。接口支持GET/POST方式,适用于Python等语言的开发环境。
1140 11
|
消息中间件 JSON Java
Spring Boot、Spring Cloud与Spring Cloud Alibaba版本对应关系
Spring Boot、Spring Cloud与Spring Cloud Alibaba版本对应关系
24127 0
|
12月前
|
监控 关系型数据库 MySQL
MySQL 查看数据库实例
MySQL 查看数据库实例
269 6