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

時間 2020-05-19

標籤 c# 開發微信門戶應用開始使用接口欄目 C# 简体版

原文原文鏈接

微信應用如火如荼，不少公司都但願搭上信息快車，這個是一個商機，也是一個技術的方向，所以，有空研究下、學習下微信的相關開發，也就成爲平常計劃的重要事情之一了。本系列文章但願從一個按部就班的角度上，全面介紹微信的相關開發過程和相關經驗總結，但願給你們瞭解一下相關的開發歷程。本隨筆主要針對微信開發過程的前期準備和一些初始的工做的介紹。html

在寫下本文的以前一週時間裏，我主要就是參考一些介紹文章以及微信公衆平臺的相關接口說明，並結合C#的代碼開發，整理了本身公司的門戶界面，實現了微信工做號的初步用戶交互和信息展現工做，隨着工做的進一步開展，愈來愈多的功能可能加入，並但願從應用角度上擴展微信的接口，從而實現我對微信接口的技術探祕和了解過程。api

一、微信帳號

要開發使用微信的平臺API，就須要到微信的公衆平臺（https://mp.weixin.qq.com/）去註冊，擁有一個服務號或者訂閱號，服務號主要面對企業和組織，訂閱號主要面向組織和我的，他們之間有必定的差別，根據不一樣的須要本身申請對應的帳號便可。服務器

爲了使用一些高級的接口，你可能須要擁有服務號和高級的認證。帳號註冊過程，須要下載一個申請表格，打印並蓋公章，另外還須要申請人拿着身份證拍照（有點怪異，呵呵），而後上傳到服務器進行審覈，通常很快就能獲取批覆。微信

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

二、微信菜單定義

微信有兩種方式的菜單定義，一種是編輯模式，一種是開發模式，二者互斥，也就是說，一旦咱們採用了開發模式，就不能使用編輯模式了，反過來也同樣。編輯下的菜單，其實也是能夠管理的，可是微信不支持，以爲很不爽。微信公衆平臺

通常狀況下，若是咱們剛剛申請了微信號碼，可使用編輯菜單測試一下，根聽說明編輯一些菜單試試。雖然微信說24小時內更新，不過通常很快，最快可能一兩分鐘就更新了，感受仍是不錯的。函數

使用開發者模式，你須要根據微信的要求，在服務器上放置一個頁面連接，使用C#開發的，能夠採用***.ashx的命名方式，使用Asp.NET的通常處理程序便可，不須要使用普通的頁面。post

使用開發模式的菜單，也就是能夠調用微信API進行菜單建立的工做，對於調用微信的API（微信有不少API能夠調用），咱們須要知道，有幾個參數的重要性，因此在開發模式打開的時候，會給你列出這些參數，以下所示。學習

三、接入微信的連接處理

上面說了，你申請開發模式對菜單或者對其餘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;
            }
        }

四、使用開發方式建立菜單

一旦你順利經過微信的認證，那麼它就讓你以開發方式調用它的API，而且能夠隨意建立你的菜單了。

建立菜單的方式，你能夠經過下面的位置進入到他的API處理界面裏面。

進入後，你會發現微信把不少消息的處理，分門別類放到不一樣的分類裏面了。

其實咱們如今初步要作的就是如何看看，使用代碼方式調用建立菜單，進入菜單的API調試界面裏面。

你會發現裏面還須要輸入一個Access_Token的東西，這個是一個會話身份認證，所以你還須要到接口裏面去找這個如何建立的。下面圖中的兩個紅色部分，就是咱們開始的時候，微信提示咱們「開發者憑據」的兩個關鍵參數。

弄完這些，你就能夠根據得到的Access_Token進行菜單的建立工做了，根據菜單的定義，它分爲幾類，能夠分爲URL方式（View），事件方式（Click）。

click：用戶點擊click類型按鈕後，微信服務器會經過消息接口推送消息類型爲event 的結構給開發者（參考消息接口指南），而且帶上按鈕中開發者填寫的key值，開發者能夠經過自定義的key值與用戶進行交互；
view：用戶點擊view類型按鈕後，微信客戶端將會打開開發者在按鈕中填寫的url值（即網頁連接），達到打開網頁的目的，建議與網頁受權獲取用戶基本信息接口結合，得到用戶的登入我的信息。