码迷,mamicode.com
首页 > 微信 > 详细

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

时间:2014-11-05 21:37:51      阅读:459      评论:0      收藏:0      [点我收藏+]

标签:corpid和secret   企业号开发   微信公众平台企业号   agentid企业应用id   

微信企业号出来之后,本人也抱着前面开发订阅号和服务号的经验来探究了一番,这里整理了下再开发企业号时候碰到的一些接口参数。企业号开发文档详见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需要用CorpIDSecret来换取,不同的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

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

    标签:corpid和secret   企业号开发   微信公众平台企业号   agentid企业应用id   

    原文地址:http://blog.csdn.net/fuyifang/article/details/40828999

    (0)
    (0)
       
    举报
    评论 一句话评论(0
    登录后才能评论!
    © 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
    迷上了代码!