前面幾篇陸續(xù)介紹了很多微信企業(yè)號的相關(guān)操作，企業(yè)號和公眾號一樣都可以自定義菜單，因此他們也可以通過API進行菜單的創(chuàng)建、獲取列表、刪除的操作，因此本篇繼續(xù)探討這個主體，介紹企業(yè)號的菜單管理操作。

菜單在很多情況下，能夠給我們提供一個快速入口，也可以用來獲取用戶信息的主要入口，通過OAuth2驗證接口，以及自定義的重定向菜單，我們就可以獲取對應(yīng)的用戶ID，然后進一步獲取到用戶的相關(guān)數(shù)據(jù)，可以顯示給客戶。

1、菜單的總體介紹

菜單的事件處理如下所示，包括了單擊和跳轉(zhuǎn)兩個操作，未來企業(yè)號可能會增加一些和公眾號一樣的掃碼操作，拍照操作等功能的，目前只有兩個。

官方的菜單定義接口包含了下面三種操作，菜單創(chuàng)建、列表獲取和菜單刪除，這點和公眾號操作幾乎一樣了。

2、菜單的實體類定義和接口定義處理

我們定義菜單，包括定義它的一些屬性，包含有name, type, key,url,以及一個指向自身引用的子菜單引用，因此菜單就可以循環(huán)構(gòu)造多個層次，雖然嚴(yán)格意義上來講，企業(yè)號的菜單和公眾號菜單一樣，一級三個，二級最多五個，而且沒有三級菜單了。

實體類的UML圖示如下所示。

菜單管理的創(chuàng)建操作，官方定義如下所示。

• 請求說明

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

• 參數(shù)說明

• 權(quán)限說明

管理員須擁有應(yīng)用的管理權(quán)限，并且應(yīng)用必須設(shè)置在回調(diào)模式。

返回結(jié)果

{
   "errcode":0,
   "errmsg":"ok"
}

根據(jù)上面官方的定義語義，我們菜單管理的C#管理接口定義如下所示。

/// <summary>  
    /// 企業(yè)號菜單管理接口定義  
    /// </summary>  
    public interface ICorpMenuApi  
    {  
        /// <summary>  
        /// 獲取菜單數(shù)據(jù)  
        /// </summary>  
        /// <param name="accessToken">調(diào)用接口憑證</param>  
        /// <returns></returns>  
        MenuListJson GetMenu(string accessToken, string agentid);  
 
        /// <summary>  
        /// 創(chuàng)建菜單  
        /// </summary>  
        /// <param name="accessToken">調(diào)用接口憑證</param>  
        /// <param name="menuJson">菜單對象</param>  
        /// <returns></returns>  
        CommonResult CreateMenu(string accessToken, MenuListJson menuJson, string agentid);  
 
        /// <summary>  
        /// 刪除菜單  
        /// </summary>  
        /// <param name="accessToken">調(diào)用接口憑證</param>  
        /// <returns></returns>  
        CommonResult DeleteMenu(string accessToken, string agentid);  
    } 

我們以創(chuàng)建菜單的實現(xiàn)為例來介紹微信企業(yè)號菜單的操作，其他的操作類似處理，都是返回一個公共的消息類，方便處理和讀取，代碼如下所示。

/// <summary>  
        /// 創(chuàng)建菜單  
        /// </summary>  
        /// <param name="accessToken">調(diào)用接口憑證</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、企業(yè)號菜單管理接口的調(diào)用和處理效果

調(diào)用的代碼和效果圖如下所示。

private void btnMenuCreate_Click(object sender, EventArgs e)  
        {  
            MenuJson productInfo = new MenuJson("產(chǎn)品介紹", new MenuJson[] {   
                new MenuJson("軟件產(chǎn)品介紹", ButtonType.click, "event-software")  
                , new MenuJson("框架源碼產(chǎn)品", ButtonType.click, "event-source")  
                , new MenuJson("軟件定制開發(fā)", ButtonType.click, "event-develop")  
            });  
 
            MenuJson frameworkInfo = new MenuJson("框架產(chǎn)品", new MenuJson[] {   
                new MenuJson("Win開發(fā)框架", ButtonType.click, "win"),  
                new MenuJson("WCF開發(fā)框架", ButtonType.click, "wcf"),  
                new MenuJson("混合式框架", ButtonType.click, "mix"),   
                new MenuJson("Web開發(fā)框架", ButtonType.click, "web")  
                ,new MenuJson("代碼生成工具", ButtonType.click, "database2sharp")  
            });  
 
            MenuJson relatedInfo = new MenuJson("相關(guān)鏈接", new MenuJson[] {   
                new MenuJson("公司介紹", ButtonType.click, "event_company"),  
                new MenuJson("官方網(wǎng)站", ButtonType.view, "http://www.iqidi.com"),  
                new MenuJson("聯(lián)系我們", ButtonType.click, "event_contact"),  
                new MenuJson("應(yīng)答系統(tǒng)", ButtonType.click, "set-1"),      
                new MenuJson("發(fā)郵件", 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("您確認(rèn)要創(chuàng)建菜單嗎") == System.Windows.Forms.DialogResult.Yes)  
            {  
                ICorpMenuApi bll = new CorpMenuApi();   
                CommonResult result = bll.CreateMenu(token, menuJson, agentid);  
                Console.WriteLine("創(chuàng)建菜單：" + (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());  
            }  
        } 

調(diào)用代碼的測試輸出如下所示。

原文出自：http://www.cnblogs.com/wuhuacong/p/3995678.html