關于.NET HttpClient方式獲取微信小程序碼(二維碼)

隨著微信小程序的火熱應用,市面上有關小程序開發的需求也多了起來。近來分析了一項生成有關生成微信小程序碼的需求——要求掃碼跳轉到小程序指定頁面(帶參數);看了下小程序官方文檔,以及網上的例子,未看到多少有價值的采用C#調用小程序接口生成小程序碼的例子,于是拾起多年前的代碼,略作分析嘗試,在此分享給有需要的人,并以此拋磚引玉。

此文以HttpClient方式示例,當然采用老舊的HttpWebRequest也可以,在此不作分析。
生成微信小程序碼(二維碼)的接口主要有三個:

在此僅針對createwxaqrcode(二維碼)和get(小程序碼/葵花碼)講解,getUnlimited原理同;

兩者的接口地址分別如下:

https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN

https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN

由于請求小程序接口,其返回的是圖片二進制流,采用HttpClient方式時務必針對二進制數據進行處理;不多說,直接上關鍵代碼,簡要示例如下:

public class HttpClientHelper
    {
    /// <summary>
    /// 保存接口返回二進制流為文件方法
    /// </summary>
    /// <param name="requestUri">接口地址</param>
    /// <param name="filePath">文件存儲路徑</param>
    /// <param name="jsonString">json數據對象</param>
    /// <param name="webapiBaseUrl"></param>
    /// <returns></returns>
    public static bool DownloadBufferImage(string requestUri, /*HttpContent httpContent,*/string filePath, string jsonString, string webapiBaseUrl = "")
        {
            try
            {
                HttpContent httpContent = new StringContent(jsonString);
                httpContent.Headers.ContentType = new MediaTypeHeaderValue("application/json");
               
                using (HttpClient httpClient = new HttpClient())
                {                   
                    if (!string.IsNullOrWhiteSpace(webapiBaseUrl))
                    {
                        httpClient.BaseAddress = new Uri(webapiBaseUrl);
                    }
                    bool result = false;
                    httpClient.PostAsync(requestUri, httpContent).ContinueWith(
                       (requestTask) =>
                       {
                           HttpResponseMessage response = requestTask.Result;

                           response.EnsureSuccessStatusCode();

                           var data = response.Content.ReadAsByteArrayAsync().Result;

                      var folder = Path.GetDirectoryName(filePath);
                      if (!Directory.Exists(folder))
                      {
                         Directory.CreateDirectory(folder);
                      }
                        
                           using (FileStream fs = new FileStream(filePath, FileMode.Create, FileAccess.Write))
                           {
                               fs.Write(data, 0, data.Length);
                               fs.Flush();
                               fs.Close();
                           }

                           result = true;

                       }).Wait(30000);
                 
                    return result;
                }
            }
            catch
            {
                return false;
            }
        }
}

 

一共4個參數:

  1. requestUri請求的接口URL;
  2. filePath小程序碼(二維碼)存儲的絕對路徑;
  3. jsonString提交的json數據對象;
  4. webapiBaseUrl接口根路徑(可忽略)

 

由于騰訊接口要求,提交數據必須json對象,因此httpContent.Headers.ContentType = new MediaTypeHeaderValue("application/json"),此處尤為重要,不能像提交form表單一樣以字典方式提交;其次,處理二進制數據流采用以下形式處理并保存圖片;此處不贅述。

var data = response.Content.ReadAsByteArrayAsync().Result;
                        
using (FileStream fs = new FileStream(filePath, FileMode.Create, FileAccess.Write))
{
    fs.Write(data, 0, data.Length);
    fs.Flush();
    fs.Close();
}

  

簡要封裝及調用示例如下:

public bool GetQrCode(string filePath, string path = "pages/default/default", int width = 430)
         {
             string postUrl = string.Format("https://api.weixin.qq.com/wxa/getwxacode?access_token={0}", AccessToken);         

             var data = new
            {
                path = path,
                width = width
            };
             var result = HttpClientHelper.DownloadBufferImage(postUrl, filePath, Newtonsoft.Json.JsonConvert.SerializeObject(data));

             return result;
         } 

  

new NameSpace.GetQrCode(@"D:\QrCode.jpg", path: "pages/index/index");

 

filePath為保存小程序碼(二維碼)圖片的絕對路徑,如Server.MapPath(savePath);path(小程序頁面地址)和width(二維碼寬度,默認430)均為可選參數,具體參見接口文檔;AccessToken為接口調用憑證;

注:由于騰訊限制,如果接口調用成功,會直接返回圖片二進制內容,如果請求失敗,會返回 JSON 格式的數據;方法里僅對返回二進制流作處理,其他可根據需求自行完善。

 

posted @ 2019-10-03 22:07 白云任去留 閱讀(...) 評論(...) 編輯 收藏
u视娱乐