01: 企业微信API开发前准备
目录:企业微信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、第二步:开启接收消息模式
开启接收消息模式并不是必须步骤,但是如果在你的企业应用中需要用到如下功能时需提前开启接收消息模式
- 获取企业成员的地理位置信息
- 动态调整企业应用的信息
- 获取企业成员点击事件类型的应用菜单行为
- 获取企业成员通过应用给企业后台发送的消息
3、第三步:获取access_token
请求方式:GET(HTTPS)
请求URL:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=ID&corpsecret=SECRECT
注:此处标注大写的单词ID和SECRET,为需要替换的变量,根据实际获取值更新。
参数说明:
参数 |
必须 |
说明 |
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、第五步:开发应用逻辑
到这里,准备工作已经就绪,你可以继续阅读下面的接口文档了解更多关于企业微信提供的开放能力,并将这些能力与你的应用进行结合。
01: 企业微信API开发前准备的更多相关文章
- 面向对象的全套“企业微信”api接口的代码实现,网上太多“面向过程”微信api接口的代码,这个开源给需要的人用
有段时间没有写文章了. 一直以来,微信的热门是看得到的,很多人都需要与微信的api对接. 今天我这里就分享全套的企业微信api接口的代码. 关于微信api,网上已经有很多实现的了. 但是我今天之所以还 ...
- 通过企业微信API接口发送消息
最近给公司测试组内部开发一个记账小工具,当账目出现问题的时候需要发送消息通知大家,前期主要采用的QQ发送通知消息,但是有一天突然无法连接到QQ服务器,运维的同学建议采用微信的方式对接然后进行告警,所以 ...
- myEclipse+Spring boot+Hbuilder+jwt Token+mongoDB+企业微信H5开发
企业微信应用的H5开发 1.参考文档:weUI:http://jqweui.com/ 2.企业微信接口文档:https://work.weixin.qq.com/api/doc#10029 3.百度地 ...
- java 微信api开发
最近使用了一个很好的微信api框架,比较好使. 源码地址:https://github.com/chanjarster/weixin-java-tools/wiki 微信公众平台:微信公众平台开发文档 ...
- 调用企业微信API拨打紧急通知电话
# 前提条件:企业信息:行业类型必须属于"医疗"大类,客服反馈说目前不支持其他行业# 准备工作:https://work.weixin.qq.com/api/doc/90000/9 ...
- Python3 使用企业微信 API 发送消息
#coding=utf- import requests import json Secret = "TUbfeW8nFQakwOS4czm13SCnxSUPOqY2K0XHtM8XLT34 ...
- Java企业微信开发_03_通讯录同步
一.本节要点 1.获取通讯录密钥 获取方式: 登录企业微信—>管理工具—>通讯录同步助手—>开启“API接口同步” ; 开启后,即可看到通讯录密钥,也可设置通讯录API的权限:读取 ...
- Java企业微信开发_02_通讯录同步
一.本节要点 1.获取通讯录密钥 获取方式: 登录企业微信—>管理工具—>通讯录同步助手—>开启“API接口同步” ; 开启后,即可看到通讯录密钥,也可设置通讯录API的权限:读取 ...
- 这个API Hub厉害了,收录了钉钉企业微信等开放Api,还能直接调试
01 此前时不时会有一些研发小伙伴和我诉苦,说很多企业由于人力财力限制或者需求不强,会直接购买使用第三方的开放API,这样一来, 一则由于开放项目不是量身定制的,寻找自己合适的接口也要搜索调研蛮多时间 ...
随机推荐
- ArcGIS Server 内存占用相关
发布服务个数是否有上限? 不仅是服务个数,每个服务的实例数设置非常影响机器内存与CPU的占用. 发布服务时,如果服务不经常被访问,可以将最低实例数设置为0,避免后台长期占用内存. Server需要的机 ...
- Django - 缓存应用
Django缓存应用: https://www.cnblogs.com/zuoshoushizi/p/7850281.html https://www.cnblogs.com/alice-bj/p/9 ...
- 【PyQt5-Qt Designer】QComboBox(下拉列表框) 使用模板
import sys from PyQt5.QtWidgets import * from PyQt5.QtGui import * from PyQt5.QtCore import * ###### ...
- oracle(五)tkprof 使用 transient kernal profile 侧面 轮廓
1.show parameter sql_trace value是false表示系统当前不会产生trace文件 2.使产生trace文件 alter session set sql_trace = t ...
- MySQL check table/optimize table/analyze table/REPAIR TABLE
MySQL check table/optimize table/analyze table/REPAIR TABLE 转自:https://www.cnblogs.com/datastack/p/3 ...
- 关于微信小程序,你想知道的他们都问了
微信公开课深圳站小程序专场刚刚结束,大家通过"微信公开课+"互动小程序提出了许多问题.我们筛选了后台问得最多的九个问题进行解答,快来看看这里有没有你想要的答案吧! @谢杨:小程序是 ...
- Unity无法创建新工程
1.解决方法 重新登录一遍账号
- zkSNARK 零知识验证
参考文献 ZCash7篇,有社区翻译版,但还是推荐看原汁原味的 https://z.cash/blog/snark-explain.html Vitalik3篇,小天才作者我就不介绍了,这三篇 ...
- python中安装requests后又提示错误
刚刚我们是安装成功了的,新建一个项目又提示红色的波浪线了,,郁闷了 解决方法:点击pycharm菜单:File-Settings,键入Project Interpreter,我电脑python安装路径 ...
- 常用软件安装及VS插件工具
常用开发工具安装 开发环境 Visual Studio 2013 Microsoft SQL Server 2008 源代码管理 Git TortoiseGit GitScc Provider Cru ...