快捷導(dǎo)航

c#使用微信接口開(kāi)發(fā)微信門(mén)戶應(yīng)用

更新時(shí)間：2014年03月21日 11:46:07 作者：

本系列文章希望從一個(gè)循序漸進(jìn)的角度上，全面介紹微信的相關(guān)開(kāi)發(fā)過(guò)程和相關(guān)經(jīng)驗(yàn)總結(jié)，希望給大家了解一下相關(guān)的開(kāi)發(fā)歷程。

微信應(yīng)用如火如荼，很多公司都希望搭上信息快車(chē)，這個(gè)是一個(gè)商機(jī)，也是一個(gè)技術(shù)的方向，因此，有空研究下、學(xué)習(xí)下微信的相關(guān)開(kāi)發(fā)，也就成為日常計(jì)劃的重要事情之一了。本系列文章希望從一個(gè)循序漸進(jìn)的角度上，全面介紹微信的相關(guān)開(kāi)發(fā)過(guò)程和相關(guān)經(jīng)驗(yàn)總結(jié)，希望給大家了解一下相關(guān)的開(kāi)發(fā)歷程。本隨筆主要針對(duì)微信開(kāi)發(fā)過(guò)程的前期準(zhǔn)備和一些初始的工作的介紹。

在寫(xiě)下本文的之前一周時(shí)間里，我主要就是參考一些介紹文章以及微信公眾平臺(tái)的相關(guān)接口說(shuō)明，并結(jié)合C#的代碼開(kāi)發(fā)，整理了自己公司的門(mén)戶界面，實(shí)現(xiàn)了微信工作號(hào)的初步用戶交互和信息展示工作，隨著工作的進(jìn)一步開(kāi)展，越來(lái)越多的功能可能加入，并希望從應(yīng)用角度上擴(kuò)展微信的接口，從而實(shí)現(xiàn)我對(duì)微信接口的技術(shù)探秘和了解過(guò)程。

1、微信賬號(hào)

要開(kāi)發(fā)使用微信的平臺(tái)API，就需要到微信的公眾平臺(tái)（https://mp.weixin.qq.com/）去注冊(cè)，擁有一個(gè)服務(wù)號(hào)或者訂閱號(hào)，服務(wù)號(hào)主要面對(duì)企業(yè)和組織，訂閱號(hào)主要面向組織和個(gè)人，他們之間有一定的差異，根據(jù)不同的需要自己申請(qǐng)對(duì)應(yīng)的賬號(hào)即可。

為了使用一些高級(jí)的接口，你可能需要擁有服務(wù)號(hào)和高級(jí)的認(rèn)證。賬號(hào)注冊(cè)過(guò)程，需要下載一個(gè)申請(qǐng)表格，打印并蓋公章，另外還需要申請(qǐng)人拿著身份證拍照（有點(diǎn)怪異，呵呵），然后上傳到服務(wù)器進(jìn)行審核，一般很快就能獲取批復(fù)。

我以公司名義申請(qǐng)了服務(wù)號(hào)，賬號(hào)注冊(cè)后，會(huì)在主界面上顯示你的相關(guān)信息，另外給你申請(qǐng)一個(gè)二維碼的東西，掃描二維碼即可進(jìn)入公司的微信關(guān)注確認(rèn)對(duì)話框，非常方便。如下就是我申請(qǐng)后的公司賬號(hào)二維碼，可以直接使用掃描。

2、微信菜單定義

微信有兩種方式的菜單定義，一種是編輯模式，一種是開(kāi)發(fā)模式，兩者互斥，也就是說(shuō)，一旦我們采用了開(kāi)發(fā)模式，就不能使用編輯模式了，反過(guò)來(lái)也一樣。編輯下的菜單，其實(shí)也是可以管理的，但是微信不支持，覺(jué)得很不爽。

一般情況下，如果我們剛剛申請(qǐng)了微信號(hào)碼，可以使用編輯菜單測(cè)試一下，根據(jù)說(shuō)明編輯一些菜單試試。雖然微信說(shuō)24小時(shí)內(nèi)更新，不過(guò)一般很快，最快可能一兩分鐘就更新了，感覺(jué)還是不錯(cuò)的。

使用開(kāi)發(fā)者模式，你需要根據(jù)微信的要求，在服務(wù)器上放置一個(gè)頁(yè)面鏈接，使用C#開(kāi)發(fā)的，可以采用***.ashx的命名方式，使用Asp.NET的一般處理程序即可，不需要使用普通的頁(yè)面。

使用開(kāi)發(fā)模式的菜單，也就是可以調(diào)用微信API進(jìn)行菜單創(chuàng)建的工作，對(duì)于調(diào)用微信的API（微信有很多API可以調(diào)用），我們需要知道，有幾個(gè)參數(shù)的重要性，所以在開(kāi)發(fā)模式打開(kāi)的時(shí)候，會(huì)給你列出這些參數(shù)，如下所示。

3、接入微信的鏈接處理

上面說(shuō)了，你申請(qǐng)開(kāi)發(fā)模式對(duì)菜單或者對(duì)其他API的調(diào)用，你需要順利通過(guò)接入微信的測(cè)試，也就是確認(rèn)你填寫(xiě)的鏈接存在并能順利經(jīng)過(guò)微信的回調(diào)測(cè)試。微信提供了一個(gè)PHP的頁(yè)面處理例子，如果我們是C#開(kāi)發(fā)的呢，可以搜一下就會(huì)得到答案，我的處理方式如下所示。

創(chuàng)建一個(gè)一般處理程序，然后在其處理頁(yè)面里面增加一個(gè)處理邏輯，如果是非POST方式的內(nèi)容，就是表示微信進(jìn)行的Get測(cè)試，你需要增加一些處理邏輯，把它給你的內(nèi)容傳回去即可，如果是POST方式的，就是微信服務(wù)器對(duì)接口消息的請(qǐng)求操作了，后面介紹。

復(fù)制代碼代碼如下:

/// <summary>
    /// 微信接口。統(tǒng)一接收并處理信息的入口。
    /// </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(); //微信接入的測(cè)試
            }
        }

一般來(lái)說(shuō)，Auth函數(shù)里面，就是要對(duì)相關(guān)的參數(shù)進(jìn)行獲取，然后進(jìn)行處理返回給微信服務(wù)器。

復(fù)制代碼代碼如下:

string token = "****";//你申請(qǐng)的時(shí)候填寫(xiě)的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函數(shù)代碼如下所示，其中我把業(yè)務(wù)邏輯進(jìn)行進(jìn)一步抽取到了一個(gè)新的類(lèi)里面，方便業(yè)務(wù)邏輯的管理。

復(fù)制代碼代碼如下:

/// <summary>
        /// 成為開(kāi)發(fā)者的第一步，驗(yàn)證并相應(yīng)服務(wù)器的數(shù)據(jù)
        /// </summary>
        private void Auth()
        {
            string token = ConfigurationManager.AppSettings["WeixinToken"];//從配置文件獲取Token
            if (string.IsNullOrEmpty(token))
            {
                LogTextHelper.Error(string.Format("WeixinToken 配置項(xiàng)沒(méi)有配置！"));
            }

            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();
                }
            }
        }

而對(duì)微信參數(shù)的簽名并返回的操作CheckSignature，代碼如下所示。

復(fù)制代碼代碼如下:

/// <summary>
        /// 驗(yàn)證微信簽名
        /// </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、使用開(kāi)發(fā)方式創(chuàng)建菜單

一旦你順利通過(guò)微信的認(rèn)證，那么它就讓你以開(kāi)發(fā)方式調(diào)用它的API，并且可以隨意創(chuàng)建你的菜單了。

創(chuàng)建菜單的方式，你可以通過(guò)下面的位置進(jìn)入到他的API處理界面里面。