微信公众号开发系列-微信企业号开发相关參数

微信企业号出来之后，本人也抱着前面开发订阅号和服务号的经验来探究了一番，这里整理了下再开发企业号时候碰到的一些接口參数。企业号开发文档详见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、加解密库下载

c#库(9月22日更新,点击下载)注意事项：

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