企业微信API开发前准备

  参考文档:

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

  1corpidww2f9a1a85f1806981

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

  2useridXiaoNaiQiang

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

  3、部门id1

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

  4tagid

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

  5agentid:

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

       6secret: corpsecret

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

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

        1)通讯录管理secret:在“管理工具”-“通讯录同步”里面查看(需开启“API接口同步”);

   bvAUJ2OYnjB4eAlCpSdH20AxrjSP6jX60PSGnO6VWuQ

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

  7access_token

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

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

1.2 开发步骤

  参考文档:#10013

  说明:

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

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

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

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

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

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

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

获取企业成员的地理位置信息

动态调整企业应用的信息

获取企业成员点击事件类型的应用菜单行为

获取企业成员通过应用给企业后台发送的消息

  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应该分开来获取

      返回结果:

内容版权声明:除非注明,否则皆为本站原创文章。

转载注明出处:https://www.heiqu.com/zzfzpd.html