支出微信门户及选取

By admin in 亚洲必赢app在哪下载 on 2019年1月12日

眼前几篇陆续介绍了重重微信企业号的相干操作,集团号和日产号同样都可以自定义菜单,由此他们也得以因此API举办菜单的创始、获取列表、删除的操作,因而本篇继续深究那多少个重点,介绍集团号的菜系管理操作。

食谱在无数情状下,可以给我们提供一个快速入口,也可以用来得到用户消息的首要进口,通过OAuth2验证接口,以及自定义的重定向菜单,我们就足以获取相应的用户ID,然后一发获取到用户的连锁数据,可以来得给客户。

1、菜单的完全介绍

菜单的事件处理如下所示,包括了单击和跳转三个操作,以后集团号可能会大增一些和民众号相同的扫码操作,拍照操作等功效的,近年来只有七个。

亚洲必赢app在哪下载 1

合法的食谱定义接口包含了下边二种操作,菜单创设、列表获取和菜单删除,这一点和民众号操作几乎一模一样了。

亚洲必赢app在哪下载 2

 

2、菜单的实体类定义和接口定义处理

咱俩定义菜单,包括定义它的部分性质,包含有name, type,
key,url,以及一个对准自身引用的子菜单引用,由此菜单就可以循环构造两个层次,尽管严峻意义上来讲,集团号的菜系和群众号菜单一样,一流六个,二级最多两个,而且尚未三级菜单了。

实体类的UML图示如下所示。

亚洲必赢app在哪下载 3

菜单管理的创制操作,官方概念如下所示。

  • 伸手表明

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"
}

 

按照上边官方的定义语义,我们菜单管理的C#管理接口定义如下所示。

    /// <summary>
    /// 企业号菜单管理接口定义
    /// </summary>
    public interface ICorpMenuApi
    {
        /// <summary>
        /// 获取菜单数据
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <returns></returns>
        MenuListJson GetMenu(string accessToken, string agentid);

        /// <summary>
        /// 创建菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="menuJson">菜单对象</param>
        /// <returns></returns>
        CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid);

        /// <summary>
        /// 删除菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <returns></returns>
        CommonResult DeleteMenu(string accessToken, string agentid);
    }

咱俩以创办菜单的实现为例来介绍微信集团号菜单的操作,其他的操作看似处理,都是回去一个集体的音讯类,方便处理和读取,代码如下所示。

        /// <summary>
        /// 创建菜单
        /// </summary>
        /// <param name="accessToken">调用接口凭证</param>
        /// <param name="menuJson">菜单对象</param>
        /// <returns></returns>
        public CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid)
        {
            var url = string.Format("https://qyapi.weixin.qq.com/cgi-bin/menu/create?access_token={0}&agentid={1}", accessToken, agentid);
            string postData = menuJson.ToJson();

            return Helper.GetCorpExecuteResult(url, postData);
        }

 

3、集团号菜单管理接口的调用和拍卖效果

调用的代码和功力图如下所示。

        private void btnMenuCreate_Click(object sender, EventArgs e)
        {
            MenuJson productInfo = new MenuJson("产品介绍", new MenuJson[] { 
                new MenuJson("软件产品介绍", ButtonType.click, "event-software")
                , new MenuJson("框架源码产品", ButtonType.click, "event-source")
                , new MenuJson("软件定制开发", ButtonType.click, "event-develop")
            });

            MenuJson frameworkInfo = new MenuJson("框架产品", new MenuJson[] { 
                new MenuJson("Win开发框架", ButtonType.click, "win"),
                new MenuJson("WCF开发框架", ButtonType.click, "wcf"),
                new MenuJson("混合式框架", ButtonType.click, "mix"), 
                new MenuJson("Web开发框架", ButtonType.click, "web")
                ,new MenuJson("代码生成工具", ButtonType.click, "database2sharp")
            });

            MenuJson relatedInfo = new MenuJson("相关链接", new MenuJson[] { 
                new MenuJson("公司介绍", ButtonType.click, "event_company"),
                new MenuJson("官方网站", ButtonType.view, "http://www.iqidi.com"),
                new MenuJson("联系我们", ButtonType.click, "event_contact"),
                new MenuJson("应答系统", ButtonType.click, "set-1"),    
                new MenuJson("发邮件", ButtonType.view, "http://mail.qq.com/cgi-bin/qm_share?t=qm_mailme&email=S31yfX15fn8LOjplKCQm")
            });

            MenuListJson menuJson = new MenuListJson();
            menuJson.button.AddRange(new MenuJson[] { productInfo, frameworkInfo, relatedInfo });

            //Console.WriteLine(menuJson.ToJson());

            if (MessageUtil.ShowYesNoAndWarning("您确认要创建菜单吗") == System.Windows.Forms.DialogResult.Yes)
            {
                ICorpMenuApi bll = new CorpMenuApi(); 
                CommonResult result = bll.CreateMenu(token, menuJson, agentid);
                Console.WriteLine("创建菜单:" + (result.Success ? "成功" : "失败:" + result.ErrorMessage));
            }
        }

        private void btnMenuGet_Click(object sender, EventArgs e)
        {
            ICorpMenuApi bll = new CorpMenuApi();
            MenuListJson menu = bll.GetMenu(token, agentid);
            if (menu != null)
            {
                Console.WriteLine(menu.ToJson());
            }
        }

调用代码的测试输出如下所示。

亚洲必赢app在哪下载 4

 

要是对那些《C#开发微信门户及运用》体系感兴趣,能够关心我的别样作品,体系小说如下所示:

C#开发微信门户及运用(25)-微信集团号的客户端管住效果

C#付出微信门户及使用(24)-微信小店货架新闻保管

C#支出微信门户及运用(23)-微信小店商品管理接口的包裹和测试

C#支付微信门户及应用(22)-微信小店的付出和应用

C#付出微信门户及运用(21)-微信公司号的信息和事件的收纳处理及解密 

C#支出微信门户及利用(20)-微信集团号的菜单管理

亚洲必赢app在哪下载,C#支付微信门户及使用(19)-微信公司号的音讯发送(文本、图片、文件、语音、视频、图文音信等)

C#支付微信门户及接纳(18)-微信公司号的通讯录管理支出之成员管理

C#开发微信门户及利用(17)-微信公司号的通讯录管理支付之部门管理

C#付出微信门户及使用(16)-微信集团号的配置和采取

C#支出微信门户及利用(15)-微信菜单扩大扫一扫、发图片、发地理地方功效

 C#支付微信门户及应用(14)-在微信菜单中应用重定向获取用户数量

C#开发微信门户及拔取(13)-使用地理地点扩充相关应用

C#付出微信门户及应用(12)-使用语音处理

C#支出微信门户及拔取(11)–微信菜单的有余显示方法介绍

C#支付微信门户及利用(10)–在管理类别中一起微信用户分组音信

C#开发微信门户及使用(9)-微信门户菜单管理及提交到微信服务器

C#付出微信门户及运用(8)-微信门户应用管理连串机能介绍

C#支付微信门户及应用(7)-微信多客服效率及支出集成

C#开发微信门户及运用(6)–微信门户菜单的管制操作

C#支出微信门户及应用(5)–用户分组音信保管

C#支付微信门户及运用(4)–关注用户列表及详细信息管理

C#付出微信门户及使用(3)–文本消息和图文信息的回复

C#支出微信门户及运用(2)–微信音信的拍卖和回应

C#开发微信门户及使用(1)–起始利用微信接口

 

发表评论

电子邮件地址不会被公开。 必填项已用*标注

网站地图xml地图
Copyright @ 2010-2019 亚洲必赢app官方下载 版权所有