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项目内的代码实现吧：

1、首先我们先创建一个名为“basiccontroller”的业务基类，并继承“controller”类。其作用有两个，一是将验证是否正确获取openid的业务封装成基类，二是方便其它业务控制器使用openid。具体代码如下：

/// <summary>
/// 业务基类
/// </summary>
public class basiccontroller:controller
{
	//当前用户openid
	protected string currentuseropenid { set; get; }

	public basiccontroller()
	{
		//从cookie中获取当前用户的openid
		var cookie = cookies.getcookiebyuser();
		//如果没有，则导航到指定提示页，需要用户关闭后重新进入
		if (string.isnullorempty(cookie))
		{
			system.web.httpcontext.current.response.redirect("/vxinweb/index");
			return;
		}

		currentuseropenid = cookie;
	}
}

2、再创建一个名为“vxinwebcontroller”的控制器与view视图。其作用是用来接受来自微信公众号菜单内的链接入口，并自动完成获取用户openid。代码如下：

/// <summary>
/// 此页面用于对外微信菜单地址，用于获取用户openid
/// 这是本系统网页的入口
/// </summary>
public class vxinwebcontroller : controller
{
	public actionresult index()
	{
		//获取当前进到本系统的微信用户的openid
		//该请求从微信那边过来
		if (request.querystring["code"] != null)
		{
			var code = request.querystring["code"].tostring();
			var openid = vxinutils.getopenid(code);
			if (openid == null)//没有获取到openid
			{
				//返回当前视图，需要提示用户关闭窗口，尝试重新进入
				return view();
			}
			//将openid放入cookie，放到cookie之前需将openid进行加密，取出来后再解密
			cookies.setusertocookie(openid);
			return redirecttoaction("index", "home");
		}
		return view();
	}
}

3、在第二步时，我们发现有个vxinutils类，该类封装了对微信公众号api的操作，具体代码如下：

/// <summary>
/// 微信公众号工具类
/// </summary>
public class vxinutils
{

	/// <summary>
	/// 微信token
	/// </summary>
	public static string weixintoken { get { return configurationmanager.appsettings["weixintoken"].tostring(); } }

	/// <summary>
	/// 微信appid
	/// </summary>
	public static string appid { get { return configurationmanager.appsettings["appid"].tostring(); } }


	/// <summary>
	/// 微信aappsecret
	/// </summary>
	public static string appsecret { get { return configurationmanager.appsettings["appsecret"].tostring(); } }


	/// <summary>
	/// 获得access_token地址
	/// </summary>
	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); } }

	/// <summary>
	/// 通过code换取网页授权access_token地址
	/// </summary>
	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); } }


	/// <summary>
	/// 微信菜单创建提交地址
	/// </summary>
	public static string menu_post_url { get { return "https://api.weixin.qq.com/cgi-bin/menu/create?access_token="; } }


	/// <summary>
	/// 微信获取用户分组地址
	/// </summary>
	public static string group_get_url { get { return "https://api.weixin.qq.com/cgi-bin/groups/get?access_token="; } }


	/// <summary>
	/// 微信修改用户分组地址
	/// </summary>
	public static string group_update_url { get { return "https://api.weixin.qq.com/cgi-bin/groups/members/update?access_token="; } }



	/// <summary>
	/// 微信获取用户所属分组地址
	/// </summary>
	public static string group_getusergroup_url { get { return "https://api.weixin.qq.com/cgi-bin/groups/getid?access_token="; } }

	/// <summary>
	/// 拉取用户信息(需scope为 snsapi_userinfo)
	/// 如果网页授权作用域为snsapi_userinfo，则此时开发者可以通过access_token和openid拉取用户信息了。
	/// https://api.weixin.qq.com/sns/userinfo?access_token=access_token&openid=openid&lang=zh_cn
	/// </summary>
	public static string getuseruserinfo_url { get { return "https://api.weixin.qq.com/sns/userinfo?lang=zh_cn&access_token="; } }


	/// <summary>
	/// 获取用户的openid
	/// </summary>
	/// <param name="code"></param>
	/// <returns></returns>
	public static string getopenid(string code)
	{
		var openid = "";
		using (var wl = new webclient())
		{
			wl.headers.add(httprequestheader.accept, "json");
			wl.headers.add(httprequestheader.contenttype, "application/json;charset=utf-8");
			wl.headers.add(httprequestheader.useragent, "mozilla/4.0");
			wl.encoding = encoding.utf8;
			openid = wl.downloadstring(web_access_token_url + code);
		}
		if (!string.isnullorempty(openid))
		{
			var token = jobject.parse(openid).selecttoken("openid");
			if (token != null)
				openid = token.tostring();
		}
		return openid;
	}

}

总结

1、基于“snsapi_base为scope发起的网页授权”的微信公众号方案，可以很方便的实现用户静默授权及获取用户的openid。

2、通过将获取到的openid写入在cookie中，并封装一个业务基类完成cookie的读取与判断，可以使其它业务类很方便的使用openid。

好了，以上就是这篇文章的全部内容了，希望本文的内容对大家的学习或者工作具有一定的参考学习价值，如果有疑问大家可以留言交流，谢谢大家对的支持。