C#開發微信門戶及應用(一)之微信介面的如何使用

這篇文章主要為大家詳細介紹了C#開發門戶及應用第一篇，介面的使用方法，具有一定的參考價值，感興趣的小夥伴們可以參考一下

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

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

1、帳號

要開發使用的平台API，就需要到的公眾平台去註冊，擁有一個服務號或者訂閱號，服務號主要面對企業和組織，訂閱號主要面向組織和個人，他們之間有一定的差異，根據不同的需要自己申請對應的帳號即可。

為了使用一些進階的介面，你可能需要擁有服務號和進階的認證。帳號註冊過程，需要下載一個申請表格，列印並蓋公章，另外還需要申請人拿著身份證拍照（有點怪異，呵呵），然後上傳到伺服器進行審核，一般很快就能擷取批覆。

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

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 = "****";//你申請的時候填寫的Tokenstring 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值（即網頁連結），達到開啟網頁的目的，建議與網頁授權擷取使用者基本資料介面結合，獲得使用者的登入個人資訊。

5、我建立的菜單案例

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

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