班级网站建设,网络装修平台哪家最好,手机制图设计免费软件下载,西安有啥好玩的地方文章目录一、简介二、获取token1、获取秘钥2、获取Token三、获取部门数据1、获取部门列表2、获取子部门ID列表3、获取单个部门详情四、获取成员信息1、读取成员2、获取部门成员3、获取部门成员详情一、简介
同步数据到企微#xff1a;
企业如果需要从自有的系统同步通讯录到…
文章目录一、简介二、获取token1、获取秘钥2、获取Token三、获取部门数据1、获取部门列表2、获取子部门ID列表3、获取单个部门详情四、获取成员信息1、读取成员2、获取部门成员3、获取部门成员详情一、简介
同步数据到企微
企业如果需要从自有的系统同步通讯录到企业微信需要使用 通讯录同步secret。
如果企业委托授权第三方服务商将通讯录从其他系统同步到企业微信则需要企业授权“通讯录编辑授权”给服务商。
从企微获取数据
自建应用、代开发应用、第三方应用在提供功能时往往需要获取通讯录开发者可查阅成员、部门、标签相关的接口说明。
注意自建应用、代开发应用、第三方应用仅能读取通讯录不能编辑且仅能读取可见范围内的通讯录。
企微开发文档
https://developer.work.weixin.qq.com/document/path/90193二、获取token
1、获取秘钥
获取corpid(企业ID) 获取corpsecret(应用的凭证密钥) 2、获取Token
请求方式 GETHTTPS 请求地址 https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpidIDcorpsecretSECRET
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpidwwf219ef106b04c3c4corpsecretTBiRs37_qfwTgGA8HjQMskybQ6njS4IJS5VVhuzgeYU参数说明
参数必须说明corpid是企业ID获取方式参考术语说明-corpidcorpsecret是应用的凭证密钥注意应用需要是启用状态获取方式参考术语说明-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、获取部门列表
**请求方式**GETHTTPS **请求地址**https://qyapi.weixin.qq.com/cgi-bin/department/list?access_tokenACCESS_TOKENidID
https://qyapi.weixin.qq.com/cgi-bin/department/list?access_token{{access_token}}id1980054547参数说明
参数必须说明access_token是调用接口凭证id否部门id。获取指定部门及其下的子部门以及子部门的子部门等等递归。 如果不填默认获取全量组织架构
2、获取子部门ID列表
**请求方式**GETHTTPS **请求地址**https://qyapi.weixin.qq.com/cgi-bin/department/simplelist?access_tokenACCESS_TOKENidID
参数说明
参数必须说明access_token是调用接口凭证id否部门id。获取指定部门及其下的子部门以及子部门的子部门等等递归。 如果不填默认获取全量组织架构
3、获取单个部门详情
**请求方式**GETHTTPS **请求地址**https://qyapi.weixin.qq.com/cgi-bin/department/get?access_tokenACCESS_TOKENidID
参数说明
参数必须说明access_token是调用接口凭证id是部门id。
https://qyapi.weixin.qq.com/cgi-bin/department/get?access_token{{access_token}}id4四、获取成员信息
官方页面
1、读取成员
**请求方式**GETHTTPS **请求地址**https://qyapi.weixin.qq.com/cgi-bin/user/get?access_tokenACCESS_TOKENuseridUSERID
https://qyapi.weixin.qq.com/cgi-bin/user/get?access_token{{ACCESS_TOKEN}}userid{{USERID}}参数必须说明access_token是调用接口凭证userid是成员UserID。对应管理端的帐号企业内必须唯一。不区分大小写长度为1~64个字节
2、获取部门成员
**请求方式**GETHTTPS **请求地址**https://qyapi.weixin.qq.com/cgi-bin/user/simplelist?access_tokenACCESS_TOKENdepartment_idDEPARTMENT_ID
参数说明
参数必须说明access_token是调用接口凭证department_id是获取的部门id如需获取该部门及其子部门的所有成员需先获取该部门下的子部门然后再获取子部门下的部门成员逐层递归获取。 3、获取部门成员详情
**请求方式**GETHTTPS **请求地址**https://qyapi.weixin.qq.com/cgi-bin/user/list?access_tokenACCESS_TOKENdepartment_idDEPARTMENT_ID
参数说明
参数必须说明access_token是调用接口凭证department_id是获取的部门id如需获取该部门及其子部门的所有成员需先获取该部门下的子部门然后再获取子部门下的部门成员逐层递归获取。、
