1. 程式人生 > >(轉)C#開發微信門戶及應用(1)--開始使用微信接口

(轉)C#開發微信門戶及應用(1)--開始使用微信接口

主界面 回調 商機 存在 配置 manager 功能 之前 隨筆

http://www.cnblogs.com/wuhuacong/p/3613826.html

微信應用如火如荼,很多公司都希望搭上信息快車,這個是一個商機,也是一個技術的方向,因此,有空研究下、學習下微信的相關開發,也就成為日常計劃的重要事情之一了。本系列文章希望從一個循序漸進的角度上,全面介紹微信的相關開發過程和相關經驗總結,希望給大家了解一下相關的開發歷程。本隨筆主要針對微信開發過程的前期準備和一些初始的工作的介紹。

在寫下本文的之前一周時間裏,我主要就是參考一些介紹文章以及微信公眾平臺的相關接口說明,並結合C#的代碼開發,整理了自己公司的門戶界面,實現了微信工作號的初步用戶交互和信息展示工作,隨著工作的進一步開展,越來越多的功能可能加入,並希望從應用角度上擴展微信的接口,從而實現我對微信接口的技術探秘和了解過程。

1、微信賬號

要開發使用微信的平臺API,就需要到微信的公眾平臺(https://mp.weixin.qq.com/)去註冊,擁有一個服務號或者訂閱號,服務號主要面對企業和組織,訂閱號主要面向組織和個人,他們之間有一定的差異,根據不同的需要自己申請對應的賬號即可。

為了使用一些高級的接口,你可能需要擁有服務號和高級的認證。賬號註冊過程,需要下載一個申請表格,打印並蓋公章,另外還需要申請人拿著身份證拍照(有點怪異,呵呵),然後上傳到服務器進行審核,一般很快就能獲取批復。

我以公司名義申請了服務號,賬號註冊後,會在主界面上顯示你的相關信息,另外給你申請一個二維碼的東西,掃描二維碼即可進入公司的微信關註確認對話框,非常方便。如下就是我申請後的公司賬號二維碼,可以直接使用掃描。

技術分享

2、微信菜單定義

微信有兩種方式的菜單定義,一種是編輯模式,一種是開發模式,兩者互斥,也就是說,一旦我們采用了開發模式,就不能使用編輯模式了,反過來也一樣。編輯下的菜單,其實也是可以管理的,但是微信不支持,覺得很不爽。

一般情況下,如果我們剛剛申請了微信號碼,可以使用編輯菜單測試一下,根據說明編輯一些菜單試試。雖然微信說24小時內更新,不過一般很快,最快可能一兩分鐘就更新了,感覺還是不錯的。

使用開發者模式,你需要根據微信的要求,在服務器上放置一個頁面鏈接,使用C#開發的,可以采用***.ashx的命名方式,使用Asp.NET的一般處理程序即可,不需要使用普通的頁面。

使用開發模式的菜單,也就是可以調用微信API進行菜單創建的工作,對於調用微信的API(微信有很多API可以調用),我們需要知道,有幾個參數的重要性,所以在開發模式打開的時候,會給你列出這些參數,如下所示。

技術分享

3、接入微信的鏈接處理

上面說了,你申請開發模式對菜單或者對其他API的調用,你需要順利通過接入微信的測試,也就是確認你填寫的鏈接存在並能順利經過微信的回調測試。微信提供了一個PHP的頁面處理例子,如果我們是C#開發的呢,可以搜一下就會得到答案,我的處理方式如下所示。

創建一個一般處理程序,然後在其處理頁面裏面增加一個處理邏輯,如果是非POST方式的內容,就是表示微信進行的Get測試,你需要增加一些處理邏輯,把它給你的內容傳回去即可,如果是POST方式的,就是微信服務器對接口消息的請求操作了,後面介紹。

技術分享
    /// <summary>
    /// 微信接口。統一接收並處理信息的入口。
    /// </summary>
    public class wxapi : IHttpHandler
    {
        public void ProcessRequest(HttpContext context)
        {
            string postString = string.Empty;
            if (HttpContext.Current.Request.HttpMethod.ToUpper() == "POST")
            {
                using (Stream stream = HttpContext.Current.Request.InputStream)
                {
                    Byte[] postBytes = new Byte[stream.Length];
                    stream.Read(postBytes, 0, (Int32)stream.Length);
                    postString = Encoding.UTF8.GetString(postBytes);
                }

                if (!string.IsNullOrEmpty(postString))
                {
                    Execute(postString);
                }
            }
            else
            {
                Auth(); //微信接入的測試
            }
        }
技術分享

一般來說,Auth函數裏面,就是要對相關的參數進行獲取,然後進行處理返回給微信服務器。

技術分享
            string token = "****";//你申請的時候填寫的Token

            string echoString = HttpContext.Current.Request.QueryString["echoStr"];
            string signature = HttpContext.Current.Request.QueryString["signature"];
            string timestamp = HttpContext.Current.Request.QueryString["timestamp"];
            string nonce = HttpContext.Current.Request.QueryString["nonce"];
技術分享

完整的Author函數代碼如下所示,其中我把業務邏輯進行進一步抽取到了一個新的類裏面,方便業務邏輯的管理。

技術分享
        /// <summary>
        /// 成為開發者的第一步,驗證並相應服務器的數據
        /// </summary>
        private void Auth()
        {
            string token = ConfigurationManager.AppSettings["WeixinToken"];//從配置文件獲取Token
            if (string.IsNullOrEmpty(token))
            {
                LogTextHelper.Error(string.Format("WeixinToken 配置項沒有配置!"));
            }

            string echoString = HttpContext.Current.Request.QueryString["echoStr"];
            string signature = HttpContext.Current.Request.QueryString["signature"];
            string timestamp = HttpContext.Current.Request.QueryString["timestamp"];
            string nonce = HttpContext.Current.Request.QueryString["nonce"];

            if (new BasicApi().CheckSignature(token, signature, timestamp, nonce))
            {
                if (!string.IsNullOrEmpty(echoString))
                {
                    HttpContext.Current.Response.Write(echoString);
                    HttpContext.Current.Response.End();
                }
            }
        }
技術分享

而對微信參數的簽名並返回的操作CheckSignature,代碼如下所示。

技術分享
        /// <summary>
        /// 驗證微信簽名
        /// </summary>
        public bool CheckSignature(string token, string signature, string timestamp, string nonce)
        {
            string[] ArrTmp = { token, timestamp, nonce };

            Array.Sort(ArrTmp);
            string tmpStr = string.Join("", ArrTmp);

            tmpStr = FormsAuthentication.HashPasswordForStoringInConfigFile(tmpStr, "SHA1");
            tmpStr = tmpStr.ToLower();

            if (tmpStr == signature)
            {
                return true;
            }
            else
            {
                return false;
            }
        }
技術分享

4、使用開發方式創建菜單

一旦你順利通過微信的認證,那麽它就讓你以開發方式調用它的API,並且可以隨意創建你的菜單了。

創建菜單的方式,你可以通過下面的位置進入到他的API處理界面裏面。

技術分享

進入後,你會發現微信把很多消息的處理,分門別類放到不同的分類裏面了。

技術分享

其實我們現在初步要做的就是如何看看,使用代碼方式調用創建菜單,進入菜單的API調試界面裏面。

技術分享

你會發現裏面還需要輸入一個Access_Token的東西,這個是一個會話身份認證,因此你還需要到接口裏面去找這個如何創建的。下面圖中的兩個紅色部分,就是我們開始的時候,微信提示我們“開發者憑據”的兩個關鍵參數。

技術分享

弄完這些,你就可以根據獲得的Access_Token進行菜單的創建工作了,根據菜單的定義,它分為幾類,可以分為URL方式(View),事件方式(Click)。

click:用戶點擊click類型按鈕後,微信服務器會通過消息接口推送消息類型為event 的結構給開發者(參考消息接口指南),並且帶上按鈕中開發者填寫的key值,開發者可以通過自定義的key值與用戶進行交互;
view:用戶點擊view類型按鈕後,微信客戶端將會打開開發者在按鈕中填寫的url值 (即網頁鏈接),達到打開網頁的目的,建議與網頁授權獲取用戶基本信息接口結合,獲得用戶的登入個人信息。

4、我創建的菜單案例

在隨筆的開始,我公布了一個二維碼,一旦使用微信掃一掃,進行關註服務號後,那麽就可以看到我自己創建的菜單了。主菜單一般最多三列,每個主菜單還可以有子菜單,他們的文字都有所限制的。

我們來看看我公司的微信門戶菜單,看起來是不是很酷呢。

技術分享

(轉)C#開發微信門戶及應用(1)--開始使用微信接口