微信公众号开发系列-微信企业号开发相关参数
微信企业号出来之后，本人也抱着前面开发订阅号和服务号的经验来探究了一番，这里整理了下再开发企业号时候碰到的一些接口参数。企业号开发文档详见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://weibo.com/i/1741159542