最近在做個微信公眾號的項目，需要將入口放置在公眾號二級菜單內，通過點擊該菜單鏈接后進入到該項目中去，進入到項目后程序會自動通過微信公眾號的API完成用戶的OpenId獲取。需求很簡單，實現起來也不復雜，於是在一番折騰后需求實現了。為此，寫下此文僅為初次接觸的朋友提供個小小的幫助。
准備
老規矩，在開始動手前，咱們先簡單介紹下實現的組成部分，如下：
微信公眾號靜默獲取用戶OpenId：要實現該功能，可以通過微信公眾號提供的“網頁授權”接口完成（官網描述：以snsapi_base為scope發起的網頁授權，是用來獲取進入頁面的用戶的openid的，並且是靜默授權並自動跳轉到回調頁的。用戶感知的就是直接進入了回調頁（往往是業務頁面）），具體說明在此：https://mp.weixin.qq.com/wiki?t=resource/res_main&id=mp1421140842
Lezhima.Site：是一個基於ASP.NET Core2的Web Mvc帶視圖的程序，用來模擬接受微信公眾號菜單鏈接的請求，並自動獲取用戶的OpenId。
實現
如上面所述，我們已經清楚了整個實現思路，那么下面就來看看Lezhima.Site項目內的代碼實現吧：
1、首先我們先創建一個名為“BasicController”的業務基類，並繼承“Controller”類。其作用有兩個，一是將驗證是否正確獲取OpenId的業務封裝成基類，二是方便其它業務控制器使用OpenId。具體代碼如下：
1 /// <summary> 2 /// 業務基類 3 /// </summary> 4 public class BasicController:Controller 5 { 6 //當前用戶openId 7 protected string CurrentUserOpenId { set; get; } 8 9 public BasicController() 10 { 11 //從Cookie中獲取當前用戶的openId 12 var openId = Cookies.GetCookieByUser(); 13 //如果沒有，則導航到指定提示頁，需要用戶關閉后重新進入 14 if (string.IsNullOrEmpty(openId)) 15 { 16 System.Web.HttpContext.Current.Response.Redirect("/VxinWeb/Index"); 17 return; 18 } 19 20 CurrentUserOpenId = openId; 21 } 22 }
2、再創建一個名為“VxinWebController”的控制器與View視圖。其作用是用來接受來自微信公眾號菜單內的鏈接入口，並自動完成獲取用戶OpenId。代碼如下：
1 /// <summary> 2 /// 此頁面用於對外微信菜單地址，用於獲取用戶openId 3 /// 這是本系統網頁的入口 4 /// </summary> 5 public class VxinWebController : Controller 6 { 7 public ActionResult Index() 8 { 9 //獲取當前進到本系統的微信用戶的openid 10 //該請求從微信那邊過來 11 if (Request.QueryString["code"] != null) 12 { 13 var code = Request.QueryString["code"].ToString(); 14 var openId = VxinUtils.GetOpenID(code); 15 if (string.IsNullOrEmpty(openId))//沒有獲取到openId 16 { 17 //返回當前視圖，需要提示用戶關閉窗口，嘗試重新進入 18 return View(); 19 } 20 //將openId放入cookie，放到cookie之前需將openId進行加密，取出來后再解密 21 Cookies.SetUserToCookie(openId); 22 return RedirectToAction("Index", "Home"); 23 } 24 return View(); 25 } 26 }
3、在第二步時，我們發現有個VxinUtils類，該類封裝了對微信公眾號API的操作，具體代碼如下：
1 /// <summary> 2 /// 微信公眾號工具類 3 /// </summary> 4 public class VxinUtils 5 { 6 7 /// <summary> 8 /// 微信token 9 /// </summary> 10 public static string WeiXinToken { get { return ConfigurationManager.AppSettings["WeiXinToken"].ToString(); } } 11 12 /// <summary> 13 /// 微信appID 14 /// </summary> 15 public static string AppID { get { return ConfigurationManager.AppSettings["AppID"].ToString(); } } 16 17 18 /// <summary> 19 /// 微信Aappsecret 20 /// </summary> 21 public static string Appsecret { get { return ConfigurationManager.AppSettings["Appsecret"].ToString(); } } 22 23 24 /// <summary> 25 /// 獲得access_token地址 26 /// </summary> 27 public static string Access_token_URL { get { return string.Format("https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={0}&secret={1}", AppID, Appsecret); } } 28 29 /// <summary> 30 /// 通過code換取網頁授權access_token地址 31 /// </summary> 32 public static string Web_Access_token_URL { get { return string.Format("https://api.weixin.qq.com/sns/oauth2/access_token?appid={0}&secret={1}&grant_type=authorization_code&code=", AppID, Appsecret); } } 33 34 35 /// <summary> 36 /// 微信菜單創建提交地址 37 /// </summary> 38 public static string MENU_POST_URL { get { return "https://api.weixin.qq.com/cgi-bin/menu/create?access_token="; } } 39 40 41 /// <summary> 42 /// 微信獲取用戶分組地址 43 /// </summary> 44 public static string Group_Get_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/get?access_token="; } } 45 46 47 /// <summary> 48 /// 微信修改用戶分組地址 49 /// </summary> 50 public static string Group_Update_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token="; } } 51 52 53 54 /// <summary> 55 /// 微信獲取用戶所屬分組地址 56 /// </summary> 57 public static string Group_GetUserGroup_Url { get { return "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token="; } } 58 59 /// <summary> 60 /// 拉取用戶信息(需scope為 snsapi_userinfo) 61 /// 如果網頁授權作用域為snsapi_userinfo，則此時開發者可以通過access_token和openid拉取用戶信息了。 62 /// https://api.weixin.qq.com/sns/userinfo?access_token=ACCESS_TOKEN&openid=OPENID&lang=zh_CN 63 /// </summary> 64 public static string GetUserUserinfo_Url { get { return "https://api.weixin.qq.com/sns/userinfo?lang=zh_CN&access_token="; } } 65 66 67 /// <summary> 68 /// 獲取用戶的OpenId 69 /// </summary> 70 /// <param name="code"></param> 71 /// <returns></returns> 72 public static string GetOpenID(string code) 73 { 74 var openid = ""; 75 using (var wl = new WebClient()) 76 { 77 wl.Headers.Add(HttpRequestHeader.Accept, "json"); 78 wl.Headers.Add(HttpRequestHeader.ContentType, "application/json;charset=UTF-8"); 79 wl.Headers.Add(HttpRequestHeader.UserAgent, "Mozilla/4.0"); 80 wl.Encoding = Encoding.UTF8; 81 openid = wl.DownloadString(Web_Access_token_URL + code); 82 } 83 if (!string.IsNullOrEmpty(openid)) 84 { 85 var token = JObject.Parse(openid).SelectToken("openid"); 86 if (token != null) 87 openid = token.ToString(); 88 } 89 return openid; 90 } 91 92 }
總結
1、基於“snsapi_base為scope發起的網頁授權”的微信公眾號方案，可以很方便的實現用戶靜默授權及獲取用戶的OpenId。
2、通過將獲取到的OpenId寫入在Cookie中，並封裝一個業務基類完成Cookie的讀取與判斷，可以使其它業務類很方便的使用OpenId。
聲明
本文為作者原創，轉載請備注出處與保留原文地址，謝謝。如文章能給您帶來幫助，請點下推薦或關注，感謝您的支持！