企业微信API开发前准备

1.1 术语介绍

　　参考文档：http://work.weixin.qq.com/api/doc#10013

　　企业微信管理后台： https://work.weixin.qq.com/wework_admin/frame

　　1、corpid：ww2f9a1a85f1806981

　　　　　　每个企业都拥有唯一的corpid，获取此信息可在管理后台“我的企业”－“企业信息”下查看

　　2、userid：XiaoNaiQiang

　　　　　　每个成员都有唯一的userid，即所谓“帐号”。在管理后台->“通讯录”->点进某个成员的详情页

　　3、部门id：1

　　　　 　　每个部门都有唯一的id，在管理后台->“通讯录”->“组织架构”->点击某个部门右边的小圆点可看到

　　4、tagid：

　　　　　　每个标签都有唯一的标签id，在管理后台->“通讯录”->“标签”，选中某个标签，在右上角会有“标签详情”按钮，点击即可看到

　　5、agentid:

　　　　　　每个应用都有唯一的agentid。在管理后台->“企业应用”->点进应用，即可看到agentid。

       6、secret： corpsecret

　　　　　　1. secret是企业应用里面用于保障数据安全的“钥匙”，每一个应用都有一个独立的访问密钥，为了保证数据的安全，secret务必不能泄漏。

　　　　　　2. 目前secret有两种：1. 通讯录管理secret； 2. 应用secret。

　　　　　　　　1）通讯录管理secret：在“管理工具”-“通讯录同步”里面查看（需开启“API接口同步”）；

                            　　 bvAUJ2OYnjB4eAlCpSdH20AxrjSP6jX60PSGnO6VWuQ

　　　　　　　　2）应用secret：在管理后台->“企业应用”->点进应用，即可看到。

　　7、access_token：

　　　　　　access_token是企业后台去企业微信的后台获取信息时的重要票据，由corpid和secret产生。

　　　　　　所有接口在通信时都需要携带此信息用于验证接口的访问权限

1.2 开发步骤

　　参考文档：http://work.weixin.qq.com/api/doc#10013

　　说明：

　　　　你可以通过以下步骤，使用access_token来访问企业微信的接口。需要注意的是，所有的接口需使用Https协议、Json数据格式、UTF8编码。

　　　　注：查看接口说明中，参数中标注大写的单词，表示为需要替换的变量

　　1、第一步：创建企业应用并获取secret

                  1. 通讯录管理是企业微信默认集成的应用，可以直接开启。

                  2. 登录企业管理后台->“管理工具”->“通讯录同步”->“开启API接口同步”，即可得到通讯录接口密钥。

　　2、第二步：开启接收消息模式

                  开启接收消息模式并不是必须步骤，但是如果在你的企业应用中需要用到如下功能时需提前开启接收消息模式

1. 1. 获取企业成员的地理位置信息
   2. 动态调整企业应用的信息
   3. 获取企业成员点击事件类型的应用菜单行为
   4. 获取企业成员通过应用给企业后台发送的消息

　　3、第三步：获取access_token

　　　　　　请求方式：GET（HTTPS）

　　　　　　请求URL：https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRECT

　　　　　　注：此处标注大写的单词ID和SECRET，为需要替换的变量，根据实际获取值更新。

　　　　　　查看通讯录url：https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ww2f9a1a85f1806981&corpsecret=bvAUJ2OYnjB4eAlCpSdH20AxrjSP6jX60PSGnO6VWuQ

　　　　　　参数说明：

参数	必须	说明
corpid	是	企业ID
corpsecret	是	应用的凭证密钥

 

 

 

 

　　　　　　权限说明：

　　　　　　　　每个应用有独立的secret，所以每个应用的access_token应该分开来获取

　　　　　　返回结果：

{
   "errcode":0，
   "errmsg":""，
   "access_token": "accesstoken000001",        # 获取到的凭证,最长为512字节
   "expires_in": 7200                         # 凭证的有效时间（秒）
}

　　　　　　特别说明：

　　　　　　　　企业微信所有接口，返回包里都有errcode、errmsg。开发者需根据errcode是否为0判断是否调用成功

　　4、第四步：缓存和刷新access_token

　　　　　　1. 开发者需要缓存access_token，用于后续接口的调用
　　　　　　2. 不能频繁调用gettoken接口，否则会受到频率拦截。当access_token失效或过期时，需要重新获取
　　　　　　3. access_token的有效期通过返回的expires_in来传达，正常情况下为7200秒（2小时）
　　　　　　4. 有效期内重复获取返回相同结果，过期后获取会返回新的access_token。
　　　　　　5. 由于企业微信每个应用的access_token是彼此独立的，所以进行缓存时需要区分应用来进行存储。
　　　　　　6. access_token至少保留512字节的存储空间
　　　　　　7.企业微信可能会出于运营需要，提前使access_token失效，开发者应实现access_token失效时重新获取的逻辑。

　　5、第五步：开发应用逻辑

　　　　　　到这里，准备工作已经就绪，你可以继续阅读下面的接口文档了解更多关于企业微信提供的开放能力，并将这些能力与你的应用进行结合。