關於.NET HttpClient方式獲取微信小程序碼（二維碼）
- 2019 年 10 月 3 日
- 筆記
隨着微信小程序的火熱應用，市面上有關小程序開發的需求也多了起來。近來分析了一項生成有關生成微信小程序碼的需求——要求掃碼跳轉到小程序指定頁面（帶參數）；看了下小程序官方文檔，以及網上的例子，未看到多少有價值的採用C#調用小程序接口生成小程序碼的例子，於是拾起多年前的代碼，略作分析嘗試，在此分享出來，以此拋磚引玉。
此文以HttpClient方式示例，當然採用老舊的HttpWebRequest也可以，在此不作分析。
生成微信小程序碼（二維碼）的接口主要有三個：
- https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/qr-code/wxacode.createQRCode.html
- https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/qr-code/wxacode.get.html
- https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/qr-code/wxacode.getUnlimited.html
在此僅針對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 { 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; 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個參數：
- requestUri請求的接口URL；
- filePath小程序碼（二維碼）存儲的絕對路徑；
- jsonString提交的json數據對象；
- 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");
path和width為可選參數，path根據自身項目需求傳入即可，如Server.MapPath(savePath);width即生成的二維碼寬度（默認430），具體參見接口文檔；AccessToken為接口調用憑證；
註：由於騰訊限制，如果接口調用成功，會直接返回圖片二進制內容，如果請求失敗，會返回 JSON 格式的數據；方法里僅對返回二進制流作處理，其他可根據需求自行完善。
