當前位置:首頁 > IT技術 > 微信平臺 > 正文

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能
2021-07-25 20:29:46

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能

搖一搖周邊紅包接口是為線下商戶提供的發(fā)紅包功能。用戶可以在商家門店等線下場所通過搖一搖周邊領取商家發(fā)放的紅包。我曾經在《C#開發(fā)微信門戶及應用(28)--微信“搖一搖·周邊”功能的使用和接口的實現》介紹過微信搖一搖的相關管理,包括頁面、設備之間的關系,以及使用等方面內容。本篇繼續(xù)介紹搖一搖設備的另外一項功能,搖一搖紅包功能,介紹如何利用微信搖搖周邊的后臺配置好頁面及地址,然后通過微信JSSDK的方式,搖一搖獲取紅包的整個流程功能。

搖一搖周邊紅包接口是為線下商戶提供的發(fā)紅包功能。用戶可以在商家門店等線下場所通過搖一搖周邊領取商家發(fā)放的紅包。我曾經在《C#開發(fā)微信門戶及應用(28)--微信“搖一搖·周邊”功能的使用和接口的實現》介紹過微信搖一搖的相關管理,包括頁面、設備之間的關系,以及使用等方面內容。本篇繼續(xù)介紹搖一搖設備的另外一項功能,搖一搖紅包功能,介紹如何利用微信搖搖周邊的后臺配置好頁面及地址,然后通過微信JSSDK的方式,搖一搖獲取紅包的整個流程功能。

1、微信搖一搖紅包功能介紹

功能說明

搖一搖周邊紅包接口是為線下商戶提供的發(fā)紅包功能。用戶可以在商家門店等線下場所通過搖一搖周邊領取商家發(fā)放的紅包,在線上轉發(fā)分享無效。

開發(fā)者可通過接口開發(fā)搖一搖紅包功能,特點包括:

  1. 可選擇使用模板加載頁或自定義Html5頁面調起微信原生紅包頁面(詳見創(chuàng)建紅包活動中use_template字段,1為使用模板,2為使用自定義Html5頁面)
  2. 原生紅包頁面拆紅包,無需通過公眾號消息下發(fā)
  3. 提供關注公眾號能力,用戶可自行選擇是否關注(裂變紅包分享時無效)
  4. 完成頁面可配置跳轉鏈接,可跳轉商戶的其他自定義Html5頁面
  5. 同一個用戶在單個紅包活動中只能領取1次紅包

用戶側交互流程

常規(guī)的搖一搖紅包的流程如下所示,這里沒有使用用戶自定義的模板,也就是使用系統內置的(努力加載中。。。)的頁面,紅包需要自己拆開。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用

紅包組件接口調用流程

  1. 申請紅包接口權限:登錄搖一搖周邊商戶后臺https://zb.weixin.qq.com?,進入開發(fā)者支持,申請開通搖一搖紅包組件接口;
  2. 紅包預下單:調用微信支付的api進行紅包預下單,告知需要發(fā)放的紅包金額,人數,生成紅包ticket;
  3. 創(chuàng)建活動并錄入紅包信息:調用搖周邊平臺的api錄入創(chuàng)建紅包活動并錄入信息,傳入預下單時生成的紅包ticket;
  4. 調用jsapi抽紅包:在搖出的頁面中通過調用jsapi抽紅包,抽中紅包的用戶可以拆紅包;
  5. 調用以上接口時,紅包提供商戶和紅包發(fā)放商戶公眾號要求一致。

搖一搖紅包的處理過程可以先的流程說明,申請權限后,需要在搖一搖后臺配置相關的紅包處理頁面,然后通過紅包接口處理提交紅包數據,最后通過搖一搖的設備搖出界面,使用JSAPI實現抽取紅包的操作,具體過程如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_02

其中紅包接口處理,是調用一系列的紅包接口實現的,包括紅包預下單、創(chuàng)建紅包活動、錄入紅包信息等操作,如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_03?

搖一搖紅包功能開通在后臺獲取接口即可,如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_04

假設已經有相關的搖一搖設備(如果沒有或者需要加入新的搖一搖設備,請參考上篇隨筆《C#開發(fā)微信門戶及應用(28)--微信“搖一搖·周邊”功能的使用和接口的實現》的相關介紹,有了設備后在頁面管理中添加一個頁面,用來處理搖一搖的信息的。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_05

頁面的信息,就是添加自定義鏈接界面,如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_06

然后配置好URL地址接口,URL地址還需要考慮如何獲取用戶的openid,因為搖一搖紅包接口必須要獲得當前用戶的openid信息,我們可以通過重定向的方式,使用code獲取對應的openid信息,具體后面詳細介紹。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_07

?

2、紅包接口處理

前面介紹了,紅包接口處理,是調用一系列的紅包接口實現的,包括紅包預下單、創(chuàng)建紅包活動、錄入紅包信息等操作,如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_03?

那么我們就需要分別對這些操作進行封裝,并提交相關的數據了。

根據前面隨筆《C#開發(fā)微信門戶及應用(33)--微信現金紅包的封裝及使用》里面的規(guī)則,我們把搖一搖的相關接口也放在這個ILotteryApi接口和LotteryApi實現類里面,如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_09

下面的搖一搖紅包接口全部是基于上面的接口和實現類進行完善處理的。

?

1)紅包預下單

接口說明

設置單個紅包的金額,類型等,生成紅包信息。預下單完成后,需要在72小時內調用jsapi完成抽紅包的操作。(紅包過期失效后,資金會退回到商戶財付通帳號。)

接口調用說明

服務器端調用
http請求方式: POST
https://api.mch.weixin.qq.com/mmpaymkttransfers/hbpreorder
POST數據格式:XML
需要商戶證書

請求示例

<xml>     
<sign><![CDATA[E1EE61A91C8E90F299DE6AE075D60A2D]]></sign>     
<mch_billno><![CDATA[0010010404201411170000046545]]></mch_billno>     
<mch_id><![CDATA[10000097]]></mch_id>     
<wxappid><![CDATA[wxcbda96de0b165486]]></wxappid>     
<send_name><![CDATA[send_name]]></send_name>     
<hb_type><![CDATA[NORMAL]]></hb_type>     
<auth_mchid><![CDATA[10000098]]></auth_mchid>     
<auth_appid><![CDATA[wx7777777]]></auth_appid>     
<total_amount><![CDATA[200]]></total_amount>     
<amt_type><![CDATA[ALL_RAND]]></amt_type>     
<total_num><![CDATA[3]]></total_num>     
<wishing><![CDATA[恭喜發(fā)財 ]]></wishing>     
<act_name><![CDATA[ 新年紅包 ]]></act_name>     
<remark><![CDATA[新年紅包 ]]></remark>     
<risk_cntl><![CDATA[NORMAL]]></risk_cntl>     
<nonce_str><![CDATA[50780e0cca98c8c8e814883e5caa672e]]></nonce_str>
</xml>

返回數據說明

返回格式為xml

成功示例

<xml>     
<return_code><![CDATA[SUCCESS]]></return_code>     
<return_msg><![CDATA[發(fā)放成功.]]></return_msg> 
<result_code><![CDATA[SUCCESS]]></result_code> 
<err_code><![CDATA[0]]></err_code>     
<err_code_des><![CDATA[發(fā)放成功.]]></err_code_des>     
<mch_billno><![CDATA[0010010404201411170000046545]]></mch_billno> 
<mch_id>10010404</mch_id>     
<wxappid><![CDATA[wx6fa7e3bab7e15415]]></wxappid>     
<sp_ticket><![CDATA[0cca98c8c8e814883]]></sp_ticket> 
<total_amount>3</total_amount>     
<detail_id><![CDATA[001001040420141117000004888]]></detail_id> 
<send_time><![CDATA[20150101080000]]></send_time> 
</xml>  

失敗示例

<xml>     
<return_code><![CDATA[FAIL]]></return_code>     
<return_msg><![CDATA[系統繁忙,請稍后再試.]]></return_msg>     
<result_code><![CDATA[FAIL]]></result_code>     
<err_code><![CDATA[268458547]]></err_code>     
<err_code_des><![CDATA[系統繁忙,請稍后再試.]]></err_code_des>     
<mch_billno><![CDATA[0010010404201411170000046542]]></mch_billno>             
<mch_id>10010404</mch_id>     
<wxappid><![CDATA[wx6fa7e3bab7e15415]]></wxappid>      
<total_amount>3</total_amount> 
</xml>

根據請求參數的說明,以及返回的結果,我們可以分別定義它們的傳入參數和傳出參數,具體的紅包預下單的接口定義如下

        /// <summary>
        /// 紅包預下單接口。需要商戶證書
        /// 設置單個紅包的金額,類型等,生成紅包信息。預下單完成后,需要在72小時內調用jsapi完成抽紅包的操作。(紅包過期失效后,資金會退回到商戶財付通帳號。)
        /// </summary>
        /// <param name="data">傳入參數數據</param>
        /// <returns></returns>
        LotteryPreOrderResult LotteryPreOrder(LotteryPreOrderData info);

其中LotteryPreOrderResult返回的對象結果如下所示,主要的信息是要記錄sp_ticket,目前沒有通過API接口獲取已經預下單紅包的sp_ticket信息,所以一定要先記錄好,后面在錄入紅包的時候,需要使用到這個票據。

    public class LotteryPreOrderResult : PayResult
    {
        /// <summary>
        /// 商戶訂單號
        /// </summary>
        public string mch_billno { get; set; }
        /// <summary>
        /// 公眾賬號appid
        /// </summary>
        public string wxappid { get; set; }
        /// <summary>
        /// 總付款金額,單位分
        /// </summary>
        public int total_amount { get; set; }
        /// <summary>
        /// 一個普通紅包對應一個ticket
        /// </summary>
        public string sp_ticket { get; set; }
        /// <summary>
        /// 紅包內部訂單號
        /// </summary>
        public string detail_id { get; set; }
        /// <summary>
        /// 紅包發(fā)放時間 
        /// </summary>
        public string send_time { get; set; }
    }

?

2)創(chuàng)建紅包活動

接口說明

創(chuàng)建紅包活動,設置紅包活動有效期,紅包活動開關等基本信息,返回活動id

接口調用說明

服務器端調用
http請求方式: POST
URL: https://api.weixin.qq.com/shakearound/lottery/addlotteryinfo?access_token=ACCESSTOKEN&use_template=1&logo_url=”LOGO_URL”

請求參數說明

參數 類型 說明
access_token string accesstoken,以參數的形式拼裝在url后
use_template int 是否使用模板,1:使用,2:不使用,以參數的形式拼裝在url后。(模版即交互流程圖中的紅包加載頁,使用模板用戶不需要點擊可自動打開紅包;不使用模版需自行開發(fā)HTML5頁面,并在頁面調用紅包jsapi)
logo_url string 使用模板頁面的logo_url,不使用模板時可不加。展示在搖一搖界面的消息圖標。圖片尺寸為120x120。

POST BODY:JSON格式的結構體,具體信息不在贅述,不過值得說明的是其中的Key是需要注意的,這個值一定需要使用一個確定的值,因為需要和后面的抽取紅包的簽名處理一致,否則會出錯無法抽取紅包。

參數 類型 說明
title string 抽獎活動名稱(選擇使用模板時,也作為搖一搖消息主標題),最長6個漢字,12個英文字母。
desc string 抽獎活動描述(選擇使用模板時,也作為搖一搖消息副標題),最長7個漢字,14個英文字母。
onoff int 抽獎開關。0關閉,1開啟,默認為1
begin_time long 抽獎活動開始時間,unix時間戳,單位秒
expire_time long 抽獎活動結束時間,unix時間戳,單位秒,紅包活動有效期最長為91天
sponsor_appid string 紅包提供商戶公眾號的appid,需與預下單中的公眾賬號appid(wxappid)一致
total long 紅包總數,紅包總數是錄入紅包ticket總數的上限,因此紅包總數應該大于等于預下單時紅包ticket總數。
jump_url string 紅包關注界面后可以跳轉到第三方自定義的頁面
key string 開發(fā)者自定義的key,用來生成活動抽獎接口的簽名參數,長度32位。使用方式見sign生成規(guī)則

請求示例

Content-Type: application/json Post Body:
{                                                            
 "title": "title",                           
 "desc": "desc",                             
 "onoff": 1,                                 
 "begin_time": 1428854400,                            
 "expire_time": 1428940800,                           
 "sponsor_appid": "wxxxxxxxxxxxxxx",
 "total": 10,
 "jump_url": JUMP_URL,     
 "key": "keyyyyyyyyyyyyyyyyyyyyyyyyyyyyyy"                            
}

返回數據說明

示例

{     
 "errcode":0,     
 "errmsg":"",     
 "lottery_id":"xxxxxxllllll", 
 "page_id":1, 
}

根據上面的接口定義和接口參數說明,我們可以定義創(chuàng)建紅包活動的接口定義,如下所示

        /// <summary>
        /// 創(chuàng)建紅包活動,設置紅包活動有效期,紅包活動開關等基本信息,返回活動id
        /// </summary>
        /// <param name="accessToken">調用接口憑證</param>
        /// <param name="useTempate">是否使用模板</param>
        /// <param name="login_url">使用模板頁面的logo_url,不使用模板時可不加。展示在搖一搖界面的消息圖標。圖片尺寸為120x120。</param>
        /// <returns></returns>
        AddLotterResult AddLotteryInfo(string accessToken, bool useTempate, string login_url, AddLotteryJson json);

其中AddLotteryResult為我們定義的接口處理結果,主要需要記錄其中的LotteryID,這個值需要在后面的錄入紅包接口使用到。

    /// <summary>
    /// 添加紅包活動的結果
    /// </summary>
    public class AddLotterResult : ErrorJsonResult
    {
        /// <summary>
        /// 生成的紅包活動id
        /// </summary>
        public string lottery_id { get; set; }
        /// <summary>
        /// 生成的模板頁面ID  
        /// </summary>
        public int page_id { get; set; }
    }

?

3)錄入紅包信息

在紅包預下單,以及創(chuàng)建紅包活動后,就需要把前面兩者的信息關聯起來,這個操作就是錄入紅包信息,錄入紅包信息包括提交紅包活動的ID,以及紅包預下單的sp_ticket的票據信息,這樣就可以讓用戶抽取具體的紅包信息了。

接口說明

在調用"創(chuàng)建紅包活動"接口之后,調用此接口錄入紅包信息。注意,此接口每次調用,都會向某個活動新增一批紅包信息,如果紅包數少于100個,請通過一次調用添加所有紅包信息。如果紅包數大于100,可以多次調用接口添加。請注意確保多次錄入的紅包ticket總的數目不大于創(chuàng)建該紅包活動時設置的total值。

接口調用說明

服務器端調用
http請求方式: POST
URL:https://api.weixin.qq.com/shakearound/lottery/setprizebucket?access_token=ACCESSTOKEN

POST BODY:JSON格式的結構體

參數 類型 說明
lottery_id string 紅包抽獎id,來自addlotteryinfo返回的lottery_id
mchid string 紅包提供者的商戶號,,需與預下單中的商戶號mch_id一致
sponsor_appid string 紅包提供商戶公眾號的appid,需與預下單中的公眾賬號appid(wxappid)一致
prize_info_list json數組 紅包ticket列表,如果紅包數較多,可以一次傳入多個紅包,批量調用該接口設置紅包信息。每次請求傳入的紅包個數上限為100
ticket string 預下單時返回的紅包ticket,單個活動紅包ticket數量上限為100000個,可添加多次。

請求示例

Content-Type: application/json Post Body:
{     
"lottery_id": "xxxxxxllllll",     
"mchid": "10000098",     
"sponsor_appid": "wx8888888888888888"     
"prize_info_list": [         
     {            
   "ticket": "v1|ZiPs2l0hpMBp3uwGI1rwp45vOdz/V/zQ/00jP9MeWT+e47/q1FJjwCIP34frSjzOxAEzJ7k2CtAg1pmcShvkChBWqbThxPm6MBuzceoHtj79iHuHaEn0WAO+j4sXnXnbGswFOlDYWg1ngvrRYnCY3g==",                                   
     }
   ]
}

返回數據說明

示例

{         
"errcode":0,     
"errmsg":"",     
"repeat_ticket_list":[         
     {            
"ticket": "v1|ZiPs2l0hpMBp3uwGI1rwp45vOdz/V/zQ/00jP9MeWT+e47/q1FJjwCIP34frSjzOxAEzJ7k2CtAg1pmcShvkChBWqbThxPm6MBuzceoHtj79iHuHaEn0WAO+j4sXnXnbGswFOlDYWg1ngvrRYnCY3g==",                       
     }            
  ]     
"success_num":100 
}

根據這些接口定義和傳遞參數信息,我們可以定義錄入紅包的接口。

        /// <summary>
        /// 錄入紅包信息
        /// 在調用"創(chuàng)建紅包活動"接口之后,調用此接口錄入紅包信息。
        /// 注意,此接口每次調用,都會向某個活動新增一批紅包信息,如果紅包數少于100個,請通過一次調用添加所有紅包信息。
        /// 如果紅包數大于100,可以多次調用接口添加。請注意確保多次錄入的紅包ticket總的數目不大于創(chuàng)建該紅包活動時設置的total值。
        /// </summary>
        /// <param name="accessToken">調用接口憑證</param>
        /// <param name="json">錄入紅包信息</param>
        /// <returns></returns>
        SetPrizeBucketResult SetPrizeBucket(string accessToken, SetPrizeBucketJson json);

其中錄入紅包返回的結果類SetPrizeBucketResult 定義如下所示。

    /// <summary>
    /// 錄入紅包返回的結果
    /// </summary>
    public class SetPrizeBucketResult : ErrorJsonResult
    {
        /// <summary>
        /// 重復使用的ticket列表,如為空,將不返回
        /// </summary>
        public List<PrizeTicket> repeat_ticket_list { get; set; }
        /// <summary>
        /// 過期的ticket列表,如為空,將不返回
        /// </summary>
        public List<PrizeTicket> expire_ticket_list { get; set; }
        /// <summary>
        /// 金額不在大于1元,小于1000元的ticket列表,如為空,將不返回
        /// </summary>
        public List<PrizeTicket> invalid_amount_ticket_list { get; set; }
        /// <summary>
        /// 原因:生成紅包的時候,授權商戶號auth_mchid和auth_appid沒有寫搖周邊的商戶號
        /// </summary>
        public List<PrizeTicket> wrong_authmchid_ticket_list { get; set; }
        /// <summary>
        /// ticket解析失敗,可能有錯別字符或不完整    
        /// </summary>
        public List<PrizeTicket> invalid_ticket_list { get; set; }

        /// <summary>
        /// 成功錄入的紅包數量
        /// </summary>
        public int success_num { get; set; }
    }

?

3、紅包接口的使用及JSAPI的搖一搖頁面處理

前面說明了相關的接口信息和對應的結果類的定義,我們具體在根據相關的說明,實現接口的處理就可以了,這個小節(jié)介紹如何使用這些接口,實現我們對搖一搖紅包的整個流程的處理。

如第一步,調用紅包預下單處理。

        string sp_ticket = "";
        /// <summary>
        /// 紅包預下單,并記錄紅包的ticket信息
        /// </summary>
        private void btnHbPreOrder_Click(object sender, EventArgs e)
        {
            LotteryPreOrderData info = new LotteryPreOrderData()
            {
                total_amount = 100,
                total_num = 1,
                act_name = "恭喜發(fā)財",
                remark = "恭喜發(fā)財",
                wishing = "恭喜發(fā)財",
            };
            var result = hbApi.LotteryPreOrder(info);
            sp_ticket = result.sp_ticket;//賦值,方便下面的錄入紅包操作
            Console.WriteLine(XmlConvertor.FormatXml(result.ToXml()));
        }

第二部創(chuàng)建紅包活動,如下所示。

        string lotteryId = "";
        /// <summary>
        /// 創(chuàng)建紅包活動,并記錄活動的ID
        /// </summary>
        private void btnCreateLottery_Click(object sender, EventArgs e)
        {
            AddLotteryJson json = new AddLotteryJson()
            {
                begin_time = DateTime.Now.DateTimeToInt(),
                expire_time = DateTime.Now.AddDays(90).DateTimeToInt(),
                title = "測試紅包",
                desc = "測試紅包",
                sponsor_appid = this.AppId,
                onoff = 1,
                total = 1, 
                jump_url = "http://www.iqidi.com",
                key = accountInfo.PayAPIKey
            };

            var result = hbApi.AddLotteryInfo(token, false, null, json);
            lotteryId = result.lottery_id;//賦值方便查詢紅包

            Console.WriteLine(result.ToJson());
        }

第三步,根據紅包預下單結果和紅包活動創(chuàng)建結果,錄入紅包信息

        /// <summary>
        /// 錄入紅包信息,供使用搖一搖頁面處理
        /// </summary>
        private void btnSetHB_Click(object sender, EventArgs e)
        {
            if (string.IsNullOrEmpty(sp_ticket))
            {
                MessageUtil.ShowError("紅包票據ticket為空");
                return;
            }

            SetPrizeBucketJson json = new SetPrizeBucketJson()
            {
                lottery_id = lotteryId, //使用前面的紅包活動
                mchid = accountInfo.MchID,
                sponsor_appid = accountInfo.AppID,
                prize_info_list = new List<PrizeTicket>()
                {
                    new PrizeTicket() { ticket = sp_ticket},//使用前面的紅包預下單ticket
                }
            };
            var result = hbApi.SetPrizeBucket(this.token, json);
            Console.WriteLine("錄入紅包的結果:");
            Console.WriteLine(result.ToJson());
        }

第四步,配置好重定向的頁面,方便獲取用戶的openid

1)用戶同意授權,獲取code

這個步驟,我們利用的是“網頁授權獲取用戶基本信息”操作,其中相關的信息說明如下所示。

在確保微信公眾賬號擁有授權作用域(scope參數)的權限的前提下(服務號獲得高級接口后,默認擁有scope參數中的snsapi_base和snsapi_userinfo),引導關注者打開如下頁面:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect
若提示“該鏈接無法訪問”,請檢查參數是否填寫錯誤,是否擁有scope參數對應的授權作用域權限。

尤其注意:由于授權操作安全等級較高,所以在發(fā)起授權請求時,微信會對授權鏈接做正則強匹配校驗,如果鏈接的參數順序不對,授權頁面將無法正常訪問

參考鏈接(請在微信客戶端中打開此鏈接體驗)
Scope為snsapi_base
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx520c15f417810387&redirect_uri=https%3A%2F%2Fchong.qq.com%2Fphp%2Findex.php%3Fd%3D%26c%3DwxAdapter%26m%3DmobileDeal%26showwxpaytitle%3D1%26vb2ctag%3D4_2030_5_1194_60&response_type=code&scope=snsapi_base&state=123#wechat_redirect
Scope為snsapi_userinfo
https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxf0e81c3bee622d60&redirect_uri=http%3A%2F%2Fnba.bluewebgame.com%2Foauth_response.php&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

尤其注意:跳轉回調redirect_uri,應當使用https鏈接來確保授權code的安全性。

這樣,如果我們配置的連接為http://www.iqidi.com/JSSDKTest/RedPack?uid=iqidiSoftware ,其中uid為我們對應的賬號名稱。

那么我們根據上面規(guī)則,得到重定向的連接地址就是如下所示。

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx3d81fc2886d86526&redirect_uri=http%3a%2f%2fwww.iqidi.com%2fJSSDKTest%2fRedPack%3fuid%3diqidiSoftware&response_type=code&scope=snsapi_base&state=state#wechat_redirect

2)通過code換取網頁授權access_token

首先請注意,這里通過code換取的是一個特殊的網頁授權access_token,與基礎支持中的access_token(該access_token用于調用其他接口)不同。公眾號可通過下述接口來獲取網頁授權access_token。如果網頁授權的作用域為snsapi_base,則本步驟中獲取到網頁授權access_token的同時,也獲取到了openid,snsapi_base式的網頁授權流程即到此為止。

尤其注意:由于公眾號的secret和獲取到的access_token安全級別都非常高,必須只保存在服務器,不允許傳給客戶端。后續(xù)刷新access_token、通過access_token獲取用戶信息等步驟,也必須從服務器發(fā)起。

請求方法

獲取code后,請求以下鏈接獲取access_token: 
https://api.weixin.qq.com/sns/oauth2/access_token?appid=APPID&secret=SECRET&code=CODE&grant_type=authorization_code

參數說明

?

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_10

在具體的頁面里面,我們可以獲得相關的參數,如uid我們可以把它轉換為我們對應的賬號信息,如下所示。

        /// <summary>
        /// 根據賬號名獲取對應的對象
        /// </summary>
        /// <returns></returns>
        private AccountInfo GetAccount()
        {
            AccountInfo accountInfo = null;
            string accountNo = Request.QueryString["uid"];
            if (!string.IsNullOrEmpty(accountNo))
            {
                accountInfo = BLLFactory<Account>.Instance.FindByAccountNo(accountNo);
            }
            return accountInfo;
        }

而其中的code,我們根據這個信息,也可以獲得用戶的相關信息,我們需要獲得訪問用戶的openid,如下所示。

                string code = Request.QueryString["code"];
                IBasicApi baseApi = new BasicApi();
                var result = baseApi.GetAuthToken(accountInfo.UniteAppId, accountInfo.UniteAppSecret, code);
                if (result != null && !string.IsNullOrEmpty(result.openid))
                {
                    var openid = result.openid;

有了這些信息,我們就可以構建我們的紅包參數,并封裝好簽名了。

                    WxPayData data = new WxPayData();
                    data.SetValue("openid", openid);
                    data.SetValue("lottery_id", lottery_id);
                    data.SetValue("noncestr", data.GenerateNonceStr());
                    data.SetValue("sign", data.MakeSign(accountInfo.PayAPIKey));

然后,我們在后臺,把這些信息賦值給ViewBag,就可以在頁面上順利使用了。

                    var sign = data.GetString("sign");//獲取生成的sign
                    var noncestr = data.GetString("noncestr");//獲取生成的sign

                    ViewBag.sign = sign;
                    ViewBag.lottery_id = lottery_id;
                    ViewBag.openid = openid;
                    ViewBag.noncestr2 = noncestr;

在搖一搖紅包的處理視圖頁面里面,我們先引入對應的js文件,如下所示

    <title>搖一搖紅包頁面</title>
    <link rel="stylesheet" >
    <script type="text/javascript" src="http://res.wx.qq.com/open/js/jweixin-1.1.0.js"></script>
    <script type="text/javascript" src="http://zb.weixin.qq.com/app/shakehb/BeaconShakehbJsBridge.js"></script>

然后在JS里面添加相關的處理函數,并賦值給對應的接口參數。

    <script type="text/javascript">
    BeaconShakehbJsBridge.ready(function () {
        //跳轉到抽紅包頁面
        BeaconShakehbJsBridge.invoke('jumpHongbao', {
            lottery_id: '@ViewBag.lottery_id',
            noncestr: '@ViewBag.noncestr2',
            openid: '@ViewBag.openid',
            sign: '@ViewBag.sign'
        });
    });
    </script>

最后,我們測試相關的結果,使用手機搖一搖獲得紅包的過程界面效果如下所示。

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_11??C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_12

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_13??C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_14

?

如果對這個《C#開發(fā)微信門戶及應用》系列感興趣,可以關注我的其他文章,系列隨筆如下所示:

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能

C#開發(fā)微信門戶及應用(37)--微信公眾號標簽管理功能

C#開發(fā)微信門戶及應用(36)--微信卡劵管理的封裝操作

C#開發(fā)微信門戶及應用(35)--微信支付之企業(yè)付款封裝操作

C#開發(fā)微信門戶及應用(34)--微信裂變紅包

C#開發(fā)微信門戶及應用(33)--微信現金紅包的封裝及使用

C#開發(fā)微信門戶及應用(32)--微信支付接入和API封裝使用

C#開發(fā)微信門戶及應用(31)--微信語義理解接口的實現和處理

C#開發(fā)微信門戶及應用(30)--消息的群發(fā)處理和預覽功能

C#開發(fā)微信門戶及應用(28)--微信“搖一搖·周邊”功能的使用和接口的實現

C#開發(fā)微信門戶及應用(27)-公眾號模板消息管理?

C#開發(fā)微信門戶及應用(26)-公眾號微信素材管理

C#開發(fā)微信門戶及應用(25)-微信企業(yè)號的客戶端管理功能

C#開發(fā)微信門戶及應用(24)-微信小店貨架信息管理

C#開發(fā)微信門戶及應用(23)-微信小店商品管理接口的封裝和測試

C#開發(fā)微信門戶及應用(22)-微信小店的開發(fā)和使用

C#開發(fā)微信門戶及應用(21)-微信企業(yè)號的消息和事件的接收處理及解密?

C#開發(fā)微信門戶及應用(20)-微信企業(yè)號的菜單管理

C#開發(fā)微信門戶及應用(19)-微信企業(yè)號的消息發(fā)送(文本、圖片、文件、語音、視頻、圖文消息等)

C#開發(fā)微信門戶及應用(18)-微信企業(yè)號的通訊錄管理開發(fā)之成員管理

C#開發(fā)微信門戶及應用(17)-微信企業(yè)號的通訊錄管理開發(fā)之部門管理

C#開發(fā)微信門戶及應用(16)-微信企業(yè)號的配置和使用

C#開發(fā)微信門戶及應用(15)-微信菜單增加掃一掃、發(fā)圖片、發(fā)地理位置功能

C#開發(fā)微信門戶及應用(14)-在微信菜單中采用重定向獲取用戶數據

C#開發(fā)微信門戶及應用(13)-使用地理位置擴展相關應用

C#開發(fā)微信門戶及應用(12)-使用語音處理

C#開發(fā)微信門戶及應用(11)--微信菜單的多種表現方式介紹

C#開發(fā)微信門戶及應用(10)--在管理系統中同步微信用戶分組信息

C#開發(fā)微信門戶及應用(9)-微信門戶菜單管理及提交到微信服務器

C#開發(fā)微信門戶及應用(8)-微信門戶應用管理系統功能介紹

C#開發(fā)微信門戶及應用(7)-微信多客服功能及開發(fā)集成

C#開發(fā)微信門戶及應用(6)--微信門戶菜單的管理操作

C#開發(fā)微信門戶及應用(5)--用戶分組信息管理

C#開發(fā)微信門戶及應用(4)--關注用戶列表及詳細信息管理

C#開發(fā)微信門戶及應用(3)--文本消息和圖文消息的應答

C#開發(fā)微信門戶及應用(2)--微信消息的處理和應答

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

?

C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_15主要研究技術:代碼生成工具、會員管理系統、客戶關系管理軟件、病人資料管理軟件、Visio二次開發(fā)、酒店管理系統、倉庫管理系統等共享軟件開發(fā)
專注于Winform開發(fā)框架/混合式開發(fā)框架、Web開發(fā)框架、Bootstrap開發(fā)框架、微信門戶開發(fā)框架的研究及應用。
??轉載請注明出處:
C#開發(fā)微信門戶及應用(38)--微信搖一搖紅包功能_微信公眾平臺及門戶應用_15撰寫人:伍華聰

本文摘自 :https://blog.51cto.com/w

開通會員,享受整站包年服務立即開通 >