ASP.NET Core2實現靜默獲取微信公衆號的用戶OpenId

最近在作個微信公衆號的項目，須要將入口放置在公衆號二級菜單內，經過點擊該菜單連接後進入到該項目中去，進入到項目後程序會自動經過微信公衆號的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項目內的代碼實現吧：

一、首先咱們先建立一個名爲「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 }

 

二、再建立一個名爲「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 }

 

三、在第二步時，咱們發現有個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 }

 

總結

一、基於「snsapi_base爲scope發起的網頁受權」的微信公衆號方案，能夠很方便的實現用戶靜默受權及獲取用戶的OpenId。

二、經過將獲取到的OpenId寫入在Cookie中，並封裝一個業務基類完成Cookie的讀取與判斷，可使其它業務類很方便的使用OpenId。

 

聲明

本文爲做者原創，轉載請備註出處與保留原文地址，謝謝。如文章能給您帶來幫助，請點下推薦或關注，感謝您的支持！