开始开发
第一步:创建企业应用
第二步:开启接收消息模式
第三步:获取access_token
第四步:对access_token进行缓存处理
第五步:开发应用逻辑
术语介绍
corpid:每个企业都拥有唯一的corpid,获取此信息可在管理后台“我的企业”-“企业信息”下查看(需要有管理员权限)
secret:secret是企业应用里面用于保障数据安全的“钥匙”,每一个应用都有一个独立的访问密钥,为了保证数据的安全,secret务必不能泄漏。通讯录接口的密钥在“管理工具”-“通讯录同步”里面查看,企业自定义的应用的密钥可以在企业应用的详情里面手动生成
access_token:access_token是企业后台去企业微信的后台获取信息时的重要票据,所有接口在通信时都需要携带此信息用于验证接口的访问权限
开始
第一步:创建企业应用
登录企业管理后台进入“企业应用”页面,通讯录管理是企业微信默认集成的应用,可以直接开启,如果企业需要开发自定义的应用,可点击“添加应用”完成应用的添加和配置,详细步骤请参见应用概述。
第二步:开启接收消息模式
开启接收消息模式并不是必须步骤,但是如果在你的企业应用中需要用到如下功能时需提前开启接收消息模式
获取企业成员的地理位置信息
动态调整企业应用的信息
获取企业成员点击事件类型的应用菜单行为
获取企业成员通过应用给企业后台发送的消息
关于如何开启接收消息模式,请阅读接收消息模式设置章节。
第三步:获取access_token
请求方式:GET(HTTPS)
请求URL:https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect
参数说明:
参数必须说明corpid是企业IDcorpsecret是应用的凭证密钥
权限说明:
每个应用有独立的secret,所以每个应用的access_token应该分开来获取
返回结果:
{
"errcode":0,
"errmsg":"",
"access_token": "accesstoken000001",
"expires_in": 7200
}
参数说明access_token获取到的凭证,最长为512字节expires_in凭证的有效时间(秒)
出错返回示例:
{
"errcode":40091,
"errmsg":"provider_secret is invalid"
}
第四步:对access_token进行缓存处理
为了保障服务器的稳定性,企业微信对access_token每天的调用有频次限制,目前为2000次/天/应用,每个access_token的有效期为7200秒(2小时),所以为了防止因为频率调用次数超出限制而影响功能正常使用的问题,建议开发者将中间生成的access_token 进行缓存,过期以后再重新获取。同时由于企业微信每个应用的access_token是彼此独立的,所以进行缓存时需要区分应用来进行存储。
第五步:开发应用逻辑
到这里,准备工作已经就绪,你可以继续阅读下面的接口文档了解更多关于企业微信提供的开放能力,并将这些能力与你的应用进行结合,开始吧!