标签:
微信企业号出来之后,本人也抱着前面开发订阅号和服务号的经验来探究了一番,这里整理了下再开发企业号时候碰到的一些接口參数。企业号开发文档详见http://qydev.weixin.qq.com/wiki/index.php?title=首页
1、创建自己定义菜单參数解释:
菜单管理的创建操作。官方定义例如以下所看到的。
Https请求方式: POST
https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token=ACCESS_TOKEN&agentid=1
请求包例如以下:
{ "button":[ { "type":"click", "name":"今日歌曲", "key":"V1001_TODAY_MUSIC" }, { "name":"菜单", "sub_button":[ { "type":"view", "name":"搜索", "url":"http://www.soso.com/" }, { "type":"click", "name":"赞一下我们", "key":"V1001_GOOD" } ] } ] }
參数 | 必须 | 说明 |
---|---|---|
access_token | 是 | 调用接口凭证 |
agentid | 是 | 企业应用的id。整型。可在应用的设置页面查看 |
button | 是 | 一级菜单数组。个数应为1~3个 |
sub_button | 否 | 二级菜单数组,个数应为1~5个 |
type | 是 | 菜单的响应动作类型,眼下有click、view两种类型 |
name | 是 | 菜单标题,不超过16个字节。子菜单不超过40个字节 |
key | click类型必须 | 菜单KEY值。用于消息接口推送,不超过128字节 |
url | view类型必须 | 网页链接,员工点击菜单可打开链接。不超过256字节 |
管理员须拥有应用的管理权限。而且应用必须设置在回调模式。
返回结果
{ "errcode":0, "errmsg":"ok" }
2、加解密库下载
注意事项:
1.Cryptography.cs文件封装了AES加解密过程。用户无须关心详细实现。WXBizMsgCrypt.cs文件提供了用户接入企业微信的三个接口。Sample.cs文件提供了怎样使用这三个接口的演示样例。
2.WXBizMsgCrypt.cs封装了VerifyURL, DecryptMsg, EncryptMsg三个接口,分别用于开发人员验证回调url、接收消息的解密以及开发人员回复消息的加密过程。用法能够參考Sample.cs文件。
3、获取AccessToken
AccessToken是企业号的全局唯一票据。调用接口时需携带AccessToken。
AccessToken须要用CorpID和Secret来换取。不同的Secret会返回不同的AccessToken。正常情况下AccessToken有效期为7200秒,有效期内反复获取返回同样结果。并自己主动续期。
因为获取access_token的api调用次数很有限,建议企业全局存储与更新access_token,频繁刷新access_token会导致api调用受限,影响自身业务。
Https请求方式: GET
https://qyapi.weixin.qq.com/cgi-bin/gettoken?corpid=id&corpsecret=secrect
參数 | 必须 | 说明 |
---|---|---|
corpid | 是 | 企业Id |
corpsecret | 是 | 管理组的凭证密钥 |
每一个secret代表了对应用、通讯录、接口的不同权限;不同的管理组拥有不同的secret。
a)正确的Json返回结果:
{ "access_token": "accesstoken000001", }
參数 | 说明 |
---|---|
access_token | 获取到的凭证 |
b)错误的Json返回演示样例:
{ "errcode": 43003, "errmsg": "require https" }
假设你须要使用接口开发,你还须要创建一个管理组,获取对应的开发凭据。
出于对企业信息保护的考虑。企业号不提供具备“超级权限”的开发凭据。因此。你须要创建一个管理组。设定所须要的操作权限,才干获得对应的获取訪问凭据的參数:CorpID和Secret 。
企业号最新出来须要注意事项
请注意:需更新微信至5.4以上版本号。
1.需更新微信至5.4以上版本号。
2.眼下仅支持 iOS。Android 两个平台的微信版本号。
标签:
原文地址:http://www.cnblogs.com/yxwkf/p/5122010.html