ASP.NET Core2实现静默获取微信公众号的用户OpenId

时间:2021-03-15 18:22:29

最近在做个微信公众号的项目,需要将入口放置在公众号二级菜单内,通过点击该菜单链接后进入到该项目中去,进入到项目后程序会自动通过微信公众号的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。

 

声明

本文为作者原创,转载请备注出处与保留原文地址,谢谢。如文章能给您带来帮助,请点下推荐或关注,感谢您的支持!