C#開發(fā)微信門戶及應(yīng)用(1)--開始使用微信接口

微信應(yīng)用如火如荼,很多公司都希望搭上信息快車,這個(gè)是一個(gè)商機(jī),也是一個(gè)技術(shù)的方向,因此,有空研究下、學(xué)習(xí)下微信的相關(guān)開發(fā),也就成為日常計(jì)劃的重要事情之一了。本系列文章希望從一個(gè)循序漸進(jìn)的角度上,全面介紹微信的相關(guān)開發(fā)過程和相關(guān)經(jīng)驗(yàn)總結(jié),希望給大家了解一下相關(guān)的開發(fā)歷程。本隨筆主要針對(duì)微信開發(fā)過程的前期準(zhǔn)備和一些初始的工作的介紹。
在寫下本文的之前一周時(shí)間里,我主要就是參考一些介紹文章以及微信公眾平臺(tái)的相關(guān)接口說明,并結(jié)合C#的代碼開發(fā),整理了自己公司的門戶界面,實(shí)現(xiàn)了微信工作號(hào)的初步用戶交互和信息展示工作,隨著工作的進(jìn)一步開展,越來越多的功能可能加入,并希望從應(yīng)用角度上擴(kuò)展微信的接口,從而實(shí)現(xiàn)我對(duì)微信接口的技術(shù)探秘和了解過程。

1、微信賬號(hào)

要開發(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è)過程,需要下載一個(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、微信菜單定義

微信有兩種方式的菜單定義,一種是編輯模式,一種是開發(fā)模式,兩者互斥,也就是說,一旦我們采用了開發(fā)模式,就不能使用編輯模式了,反過來也一樣。編輯下的菜單,其實(shí)也是可以管理的,但是微信不支持,覺得很不爽。
一般情況下,如果我們剛剛申請(qǐng)了微信號(hào)碼,可以使用編輯菜單測(cè)試一下,根據(jù)說明編輯一些菜單試試。雖然微信說24小時(shí)內(nèi)更新,不過一般很快,最快可能一兩分鐘就更新了,感覺還是不錯(cuò)的。
使用開發(fā)者模式,你需要根據(jù)微信的要求,在服務(wù)器上放置一個(gè)頁(yè)面鏈接,使用C#開發(fā)的,可以采用***.ashx的命名方式,使用Asp.NET的一般處理程序即可,不需要使用普通的頁(yè)面。
使用開發(fā)模式的菜單,也就是可以調(diào)用微信API進(jìn)行菜單創(chuàng)建的工作,對(duì)于調(diào)用微信的API(微信有很多API可以調(diào)用),我們需要知道,有幾個(gè)參數(shù)的重要性,所以在開發(fā)模式打開的時(shí)候,會(huì)給你列出這些參數(shù),如下所示。


3、接入微信的鏈接處理

上面說了,你申請(qǐng)開發(fā)模式對(duì)菜單或者對(duì)其他API的調(diào)用,你需要順利通過接入微信的測(cè)試,也就是確認(rèn)你填寫的鏈接存在并能順利經(jīng)過微信的回調(diào)測(cè)試。微信提供了一個(gè)PHP的頁(yè)面處理例子,如果我們是C#開發(fā)的呢,可以搜一下就會(huì)得到答案,我的處理方式如下所示。
創(chuàng)建一個(gè)一般處理程序,然后在其處理頁(yè)面里面增加一個(gè)處理邏輯,如果是非POST方式的內(nèi)容,就是表示微信進(jìn)行的Get測(cè)試,你需要增加一些處理邏輯,把它給你的內(nèi)容傳回去即可,如果是POST方式的,就是微信服務(wù)器對(duì)接口消息的請(qǐng)求操作了,后面介紹。

/// <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è)試
        }
    }

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

string token = "****";//你申請(qǐng)的時(shí)候填寫的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è)新的類里面,方便業(yè)務(wù)邏輯的管理。

/// <summary>
/// 成為開發(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)沒有配置!"));
    }

    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,代碼如下所示。

/// <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、使用開發(fā)方式創(chuàng)建菜單

一旦你順利通過微信的認(rèn)證,那么它就讓你以開發(fā)方式調(diào)用它的API,并且可以隨意創(chuàng)建你的菜單了。
創(chuàng)建菜單的方式,你可以通過下面的位置進(jìn)入到他的API處理界面里面。


進(jìn)入后,你會(huì)發(fā)現(xiàn)微信把很多消息的處理,分門別類放到不同的分類里面了。

其實(shí)我們現(xiàn)在初步要做的就是如何看看,使用代碼方式調(diào)用創(chuàng)建菜單,進(jìn)入菜單的API調(diào)試界面里面。

你會(huì)發(fā)現(xiàn)里面還需要輸入一個(gè)Access_Token的東西,這個(gè)是一個(gè)會(huì)話身份認(rèn)證,因此你還需要到接口里面去找這個(gè)如何創(chuàng)建的。下面圖中的兩個(gè)紅色部分,就是我們開始的時(shí)候,微信提示我們“開發(fā)者憑據(jù)”的兩個(gè)關(guān)鍵參數(shù)。

弄完這些,你就可以根據(jù)獲得的Access_Token進(jìn)行菜單的創(chuàng)建工作了,根據(jù)菜單的定義,它分為幾類,可以分為URL方式(View),事件方式(Click)。
click:用戶點(diǎn)擊click類型按鈕后,微信服務(wù)器會(huì)通過消息接口推送消息類型為event 的結(jié)構(gòu)給開發(fā)者(參考消息接口指南),并且?guī)习粹o中開發(fā)者填寫的key值,開發(fā)者可以通過自定義的key值與用戶進(jìn)行交互;view:用戶點(diǎn)擊view類型按鈕后,微信客戶端將會(huì)打開開發(fā)者在按鈕中填寫的url值 (即網(wǎng)頁(yè)鏈接),達(dá)到打開網(wǎng)頁(yè)的目的,建議與網(wǎng)頁(yè)授權(quán)獲取用戶基本信息接口結(jié)合,獲得用戶的登入個(gè)人信息。

5、我創(chuàng)建的菜單案例

在隨筆的開始,我公布了一個(gè)二維碼,一旦使用微信掃一掃,進(jìn)行關(guān)注服務(wù)號(hào)后,那么就可以看到我自己創(chuàng)建的菜單了。主菜單一般最多三列,每個(gè)主菜單還可以有子菜單,他們的文字都有所限制的。
我們來看看我公司的微信門戶菜單,看起來是不是很酷呢。


最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,885評(píng)論 6 541
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場(chǎng)離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,312評(píng)論 3 429
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 177,993評(píng)論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長(zhǎng)。 經(jīng)常有香客問我,道長(zhǎng),這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,667評(píng)論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,410評(píng)論 6 411
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,778評(píng)論 1 328
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,775評(píng)論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長(zhǎng)吁一口氣:“原來是場(chǎng)噩夢(mèng)啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,955評(píng)論 0 289
  • 序言:老撾萬榮一對(duì)情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,521評(píng)論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長(zhǎng)有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,266評(píng)論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,468評(píng)論 1 374
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 38,998評(píng)論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級(jí)特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,696評(píng)論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,095評(píng)論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽(yáng)。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,385評(píng)論 1 294
  • 我被黑心中介騙來泰國(guó)打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 52,193評(píng)論 3 398
  • 正文 我出身青樓,卻偏偏與公主長(zhǎng)得像,于是被迫代替她去往敵國(guó)和親。 傳聞我的和親對(duì)象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,431評(píng)論 2 378

推薦閱讀更多精彩內(nèi)容