微信企业号开发相关细节

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 。