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

2019-11-17 03:16:41

字體：大中小

來源：轉載

供稿：網友

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

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

在寫下本文的之前一周時間里，我主要就是參考一些介紹文章以及微信公眾平臺的相關接口說明，并結合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值（即網頁鏈接），達到打開網頁的目的，建議與網頁授權獲取用戶基本信息接口結合，獲得用戶的登入個人信息。