全面的.NET微信網頁開發之JS-SDK使用步驟、配置信息和接口請求簽名生成詳解
當前位置：點晴教程→知識管理交流
→『 技術文檔交流 』
思維導航JSSDK使用步驟步驟一:綁定安全域名：先登錄微信公眾平臺進入“公眾號設置”的“功能設置”里填寫“JS接口安全域名”。
步驟二:引入JS文件：
在項目中引入： <script src="http://res2.wx.qq.com/open/js/jweixin-1.6.0.js"></script> 步驟三:通過config接口注入權限驗證配置：
wx.config({ debug: true, // 開啟調試模式,調用的所有api的返回值會在客戶端alert出來，若要查看傳入的參數，可以在pc端打開，參數信息會通過log打出，僅在pc端時才會打印。 appId: '', // 必填，公眾號的唯一標識 timestamp: , // 必填，生成簽名的時間戳 nonceStr: '', // 必填，生成簽名的隨機串 signature: '',// 必填，簽名 jsApiList: [] // 必填，需要使用的JS接口列表 }); 步驟四:通過ready接口處理成功驗證：注意：假如需要在頁面加載時就調用的話，需要把對應的執行函數放到wx.ready(function(){})；方法里面加載執行，之前我調用加載就獲取地理位置的接口就是因為沒有放到這里面所以一直沒有獲取到用戶當前經緯度坐標。 wx.ready(function(){ // config信息驗證后會執行ready方法，所有接口調用都必須在config接口獲得結果之后，config是一個客戶端的異步操作，所以如果需要在頁面加載時就調用相關接口，則須把相關接口放在ready函數中調用來確保正確執行。對于用戶觸發時才調用的接口，則可以直接調用，不需要放在ready函數中。 }); 步驟五:通過error接口處理失敗驗證：wx.error(function(res){ // config信息驗證失敗會執行error函數，如簽名過期導致驗證失敗，具體錯誤信息可以打開config的debug模式查看，也可以在返回的res參數中查看，對于SPA可以在這里更新簽名。 }); 接口調用說明:所有接口通過wx對象(也可使用jWeixin對象)來調用，參數是一個對象，除了每個接口本身需要傳的參數之外，還有以下通用參數：
以上幾個函數都帶有一個參數，類型為對象，其中除了每個接口本身返回的數據之外，還有一個通用屬性errMsg，其值格式如下： 調用成功時："xxx:ok" ，其中xxx為調用的接口名 用戶取消時："xxx:cancel"，其中xxx為調用的接口名 調用失敗時：其值為具體錯誤信息 獲取access_token(公眾號的全局唯一接口調用憑據)
返回參數說明正常情況下（即請求成功時），微信只會返回下述JSON數據包給公眾號： {"access_token":"ACCESS_TOKEN","expires_in":7200} 錯誤時微信會返回錯誤碼等信息，JSON數據包示例如下（該示例為AppID無效錯誤）: {"errcode":40013,"errmsg":"invalid appid"} 通過接口獲取代碼/// <summary> /// 獲取微信公眾號全局唯一接口憑證 /// </summary> /// <returns></returns> public static string RequestAccessToken() { // 設置參數 string appid=WxAppId;//第三方用戶唯一憑證 string appsecret=WxAppSecret;//第三方用戶唯一憑證密鑰，即appsecret
//請求接口獲取 string _url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=" + appid + "&secret=" + appsecret; string method = "GET"; HttpWebRequest request = WebRequest.Create(_url) as HttpWebRequest; CookieContainer cookieContainer = new CookieContainer(); request.CookieContainer = cookieContainer; request.AllowAutoRedirect = true; request.Method = method; request.ContentType = "text/html"; request.Headers.Add("charset", "utf-8"); //發送請求并獲取響應數據 HttpWebResponse response = request.GetResponse() as HttpWebResponse; Stream responseStream = response.GetResponseStream(); StreamReader sr = new StreamReader(responseStream, Encoding.UTF8); //獲取返回過來的結果 string content = sr.ReadToEnd(); dynamic resultContent=JsonConvert.DeserializeObject(content,new { access_token="", expires_in="", errcode="", errmsg="" }.GetType()); if (resultContent!=null&&!string.IsNullOrWhiteSpace(resultContent.access_token)) //注意：請求成功時是不會有errcode=0返回,判斷access_token是否有值即可 { return resultContent.access_token;//返回請求唯一憑證 } else { //請求失敗，返回為空 return ""; } } 獲取jsapi_ticket微信公眾號調用微信JS接口的臨時票據
/// <summary> /// 獲取jsapi_ticket微信公眾號調用微信JS接口的臨時票據 /// </summary> /// <param name="accessToken">微信公眾號的全局唯一接口調用憑證</param> /// <returns></returns> public static string RequestJsapi_ticket(string accessToken) { string content = ""; try { //TODO：注意api_ticket 是用于調用微信卡券JS API的臨時票據，有效期為7200 秒，通過access_token 來獲取。 string url = "https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token=" + accessToken + "&type=jsapi"; string method = "GET"; HttpWebRequest request = WebRequest.Create(url) as HttpWebRequest; CookieContainer cookieContainer = new CookieContainer(); request.CookieContainer = cookieContainer; request.AllowAutoRedirect = true; request.Method = method; request.ContentType = "text/html"; request.Headers.Add("charset", "utf-8"); //發送請求并獲取響應數據 HttpWebResponse response = request.GetResponse() as HttpWebResponse; Stream responseStream = response.GetResponseStream(); StreamReader sr = new StreamReader(responseStream, Encoding.UTF8); //獲取返回過來的結果 content = sr.ReadToEnd(); dynamic resultStr = JsonConvert.DeserializeObject(content,new { errcode="", errmsg="",ticket="", expires_in=""}.GetType()); //請求成功 if (resultStr.errcode=="0"&&resultStr.errmsg=="ok") { content=resultStr.ticket; } else { content = ""; }
return content; } catch (Exception ex) { content = ex.Message; return content; } } 生成簽名的隨機串（nonceStr）方法一:/// <summary> /// 隨機字符串數組集合 /// </summary> private static readonly string[] NonceStrings = new string[] { "a","b","c","d","e","f","g","h","i","j","k","l","m","n","o","p","q","r","s","t","u","v","w","x","y","z", "A","B","C","D","E","F","G","H","I","J","K","L","M","N","O","P","Q","R","S","T","U","V","W","X","Y","Z" }; /// <summary> /// 生成簽名的隨機串 /// </summary> /// <returns></returns> public static string CreateNonceStr() { Random random = new Random(); var sb = new StringBuilder(); var length = NonceStrings.Length; //生成15位數的隨機字符串，當然也可以通過控制對應字符串大小生成，但是至多不超過32位 for (int i = 0; i < 15; i++) { sb.Append(NonceStrings[random.Next(length - 1)]);//通過random獲得的隨機索引到，NonceStrings數組中獲取對應數組值 } return sb.ToString(); } 方法二:string nonceStr = Guid.NewGuid().ToString().Replace("-", "").Substring(0,15); 生成簽名時間戳（timestamp）/// <summary> /// 獲取當前時間戳 /// </summary> /// <returns></returns> public static long GetCurrentUinxTime() { DateTime currentDate = DateTime.Now;//當前時間 //轉化為時間戳 DateTime localTime = TimeZone.CurrentTimeZone.ToLocalTime(new DateTime(1970, 1, 1)); return long.Parse((currentDate - localTime).TotalSeconds.ToString().Split('.')[0]); } 獲取當前網頁URL后端注意：一定要是在安全域名內，否則生成的是無效的簽名（url必須是調用JS接口頁面的完整URL）。 //獲取當前網頁完整的URL（包括URL中的參數） string currentWebUrl = Request.Url.ToString(); 前端//獲取當前網頁完整的URL（包括URL中的參數） var currentWebUrl =self.location.href; 生成簽名（signature）簽名算法說明簽名生成規則如下：參與簽名的字段包括noncestr（隨機字符串）, 有效的jsapi_ticket, timestamp（時間戳）, url（當前網頁的URL，不包含#及其后面部分） 。對所有待簽名參數按照字段名的ASCII 碼從小到大排序（字典序）后，使用URL鍵值對的格式（即key1=value1&key2=value2…）拼接成字符串string1。這里需要注意的是所有參數名均為小寫字符。對string1作sha1加密，字段名和字段值都采用原始值，不進行URL 轉義。 即signature=sha1(string1)。 示例： noncestr=Wm3WZYTPz0wzccnW jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg timestamp=1414587457 url=http://mp.weixin.qq.com?params=value 步驟1. 對所有待簽名參數按照字段名的ASCII 碼從小到大排序（字典序）后，使用URL鍵值對的格式（即key1=value1&key2=value2…）拼接成字符串string1： jsapi_ticket=sM4AOVdWfPE4DxkXGEs8VMCPGGVi4C3VM0P37wVUCFvkVAy_90u5h9nbSlYy3-Sl-HhTdfl2fzFy1AOcHKP7qg&noncestr=Wm3WZYTPz0wzccnW×tamp=1414587457&url=http://mp.weixin.qq.com?params=value 步驟2. 對string1進行sha1簽名，得到signature： 0f9de62fce790f9a083d5c99e95740ceb90c27ed 注意事項
獲取簽名代碼/// <summary> /// 獲取簽名 /// </summary> /// <param name="jsapi_ticket">微信公眾號調用微信JS臨時票據</param> /// <param name="nonceStr">隨機串</param> /// <param name="timestamp">時間戳</param> /// <param name="url">當前網頁URL</param> /// <returns></returns> public static string GetSignature(string jsapi_ticket, string nonceStr, long timestamp, string url) { var string1Builder = new StringBuilder(); //注意這里參數名必須全部小寫，且必須有序 string1Builder.Append("jsapi_ticket=").Append(jsapi_ticket).Append("&") .Append("noncestr=").Append(nonceStr).Append("&") .Append("timestamp=").Append(timestamp).Append("&") .Append("url=").Append(url.IndexOf("#") >= 0 ? url.Substring(0, url.IndexOf("#")) : url); return Sha1(string1Builder.ToString(),Encoding.UTF8); } /// <summary> /// 簽名加密，使用SHA加密所得 /// </summary> /// <param name="content">簽名加密參數</param> /// <param name="encode">編碼UTF-8</param> /// <returns></returns> public static string Sha1(string content, Encoding encode) { try { SHA1 sha1 = new SHA1CryptoServiceProvider(); byte[] bytesIn = encode.GetBytes(content); byte[] bytesOut = sha1.ComputeHash(bytesIn); sha1.Dispose(); string result = BitConverter.ToString(bytesOut); result = result.Replace("-", ""); return result; } catch (Exception ex) { throw new Exception("SHA1加密出錯：" + ex.Message); } } invalid signature簽名錯誤排查假如你遇到簽名錯誤的情況，建議你按照以下順序進行排查。
參考資料
作者：追逐時光者 來源：博客園 該文章在 2023/12/26 9:53:17 編輯過 |
關鍵字查詢
相關文章
正在查詢... 
|
400 186 1886
