微信開發筆記——微信網頁登錄授權，獲取用戶信息

最近做了一個公司的微信的公眾號，對微信的流程清楚了不少，這里記錄下，算不上多高深的，只希望能幫助到一部分人吧。

我們公司的測試微信公眾號：NPCgo 可以感受下，哈哈~~

閑話少說，開始：

首先大家要看下微信的API文檔。

微信網頁授權，獲取用戶的微信官方API文檔地址：
http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html

三次握手
微信認證流程（我自己簡稱三次握手）：
1、用戶同意授權，獲取code
2、通過code換取網頁授權access_token，用戶openId等信息
3、通過access_token和用戶的openId獲取該用戶的用戶信息

思路：
經過研究，我這邊的思路是：讓所有頁面都繼承同一個頁面，在這個頁面里做微信登錄授權處理，
因為第一步必須要經過微信的登錄授權，不能網頁后端請求，所以先要經過用戶同意，通過頁面網頁請求組裝的微信請求鏈接。請求該鏈接，
獲取code后，后端模擬請求。獲取用戶信息。

微信三次握手的方法（代碼）

public class WeiXinOAuth
{
    /// <summary>
    /// 獲取微信Code
    /// </summary>
    /// <param name="appId"></param>
    /// <param name="appSecret"></param>
    /// <param name="redirectUrl"></param>
    public string GetWeiXinCode(string appId,string appSecret,string redirectUrl)
    {
        Random r = new Random();
        //微信登錄授權
        //string url = "https://open.weixin.qq.com/connect/qrconnect?appid=" + appId + "&redirect_uri=" + redirectUrl +"&response_type=code&scope=snsapi_login&state=STATE#wechat_redirect";
        //微信OpenId授權
        //string url = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + appId + "&redirect_uri=" + redirectUrl +"&response_type=code&scope=snsapi_login&state=STATE#wechat_redirect";
        //微信用戶信息授權
        string url = "https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + appId + "&redirect_uri=" + redirectUrl + "&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect";

        return url;
    }
    /// <summary>
    /// 通過code獲取access_token
    /// </summary>
    /// <param name="appId"></param>
    /// <param name="appSecret"></param>
    /// <param name="code"></param>
    /// <returns></returns>
    public Model.WeiXinAccessTokenResult GetWeiXinAccessToken(string appId,string appSecret,string code)
    {
        string url = "https://api.weixin.qq.com/sns/oauth2/access_token?appid="+appId+"&secret="+appSecret+
            "&code="+ code + "&grant_type=authorization_code";
        string jsonStr = Tools.GetHttpRequest(url);

        Model.WeiXinAccessTokenResult result = new Model.WeiXinAccessTokenResult();
        if (jsonStr.Contains("errcode"))
        {
            Model.WeiXinErrorMsg errorResult = new Model.WeiXinErrorMsg();
            errorResult=JsonHelper.ParseFromJson<Model.WeiXinErrorMsg>(jsonStr);
            result.ErrorResult = errorResult;
            result.Result = false;
        }
        else
        {
            Model.WeiXinAccessTokenModel model = new Model.WeiXinAccessTokenModel();
            model = JsonHelper.ParseFromJson<Model.WeiXinAccessTokenModel>(jsonStr);
            result.SuccessResult = model;
            result.Result = true;
        }
        return result;
    }
    /// <summary>
    /// 拉取用戶信息
    /// </summary>
    /// <param name="accessToken"></param>
    /// <param name="openId"></param>
    /// <returns></returns>
    public Model.WeiXinUserInfoResult GetWeiXinUserInfo(string accessToken,string openId)
    {
        string url = "https://api.weixin.qq.com/sns/userinfo?access_token="+accessToken+"&openid="+openId+"&lang=zh_CN";

        string jsonStr = Tools.GetHttpRequest(url);
        Model.WeiXinUserInfoResult result = new Model.WeiXinUserInfoResult();
        if(jsonStr.Contains("errcode"))
        {
            Model.WeiXinErrorMsg errorResult = new Model.WeiXinErrorMsg();
            errorResult = JsonHelper.ParseFromJson<Model.WeiXinErrorMsg>(jsonStr);
            result.ErrorMsg = errorResult;
            result.Result = false;
        }
        else
        {
            Model.WeiXinUserInfo userInfo = new Model.WeiXinUserInfo();
            userInfo = JsonHelper.ParseFromJson<Model.WeiXinUserInfo>(jsonStr);
            result.UserInfo = userInfo;
            result.Result = true;
        }
        return result;
    }
}

所需要的對應實體類

WeiXinAccessTokenResult 類:

public class WeiXinAccessTokenResult
{
    public WeiXinAccessTokenModel SuccessResult { get; set; }
    public bool Result { get; set; }

    public WeiXinErrorMsg ErrorResult { get; set; }

}

WeiXinAccessTokenModel類：

/// <summary>
/// 通過code獲取access_token 請求成功的實體
/// </summary>
public class WeiXinAccessTokenModel
{
    /// <summary>
    /// 接口調用憑證
    /// </summary>
    public string access_token { get; set; }
    /// <summary>
    /// access_token接口調用憑證超時時間，單位（秒）
    /// </summary>
    public int expires_in { get; set; }
    /// <summary>
    /// 用戶刷新access_token
    /// </summary>
    public string refresh_token { get; set; }
    /// <summary>
    /// 授權用戶唯一標識
    /// </summary>
    public string openid { get; set; }
    /// <summary>
    /// 用戶授權的作用域，使用逗號（,）分隔
    /// </summary>
    public string scope { get; set; }
}

WeiXinErrorMsg類:

/// <summary>
/// 微信錯誤訪問的情況 
/// </summary>
public class WeiXinErrorMsg
{
    /// <summary>
    /// 錯誤編號
    /// </summary>
    public int errcode { get; set; }
    /// <summary>
    /// 錯誤提示消息
    /// </summary>
    public string errmsg { get; set; }
}

WeiXinUserInfoResult類:

 

/// <summary>
/// 獲取微信用戶信息
/// </summary>
public class WeiXinUserInfoResult
{
    /// <summary>
    /// 微信用戶信息
    /// </summary>
    public WeiXinUserInfo UserInfo { get; set; }
    /// <summary>
    /// 結果
    /// </summary>
    public bool Result { get; set; }
    /// <summary>
    /// 錯誤信息
    /// </summary>
    public WeiXinErrorMsg ErrorMsg { get; set; }
}

WeiXinUser 類 :

public class WeiXinUserInfo
{
    /// <summary>
    /// 用戶的唯一標識
    /// </summary>
    public string openid { get; set; }
    /// <summary>
    /// 用戶昵稱
    /// </summary>
    public string nickname { get; set; }
    /// <summary>
    /// 用戶的性別，值為1時是男性，值為2時是女性，值為0時是未知
    /// </summary>
    public string sex { get; set; }
    /// <summary>
    /// 用戶個人資料填寫的省份
    /// </summary>
    public string province { get; set; }
    /// <summary>
    /// 普通用戶個人資料填寫的城市
    /// </summary>
    public string city { get; set; }
    /// <summary>
    /// 國家，如中國為CN
    /// </summary>
    public string country { get; set; }
    /// <summary>
    /// 用戶頭像，最后一個數值代表正方形頭像大小（有0、46、64、96、132數值可選，0代表640*640正方形頭像），用戶沒有頭像時該項為空
    /// </summary>
    public string headimgurl { get; set; }
    /// <summary>
    /// 用戶特權信息，json 數組，如微信沃卡用戶為（chinaunicom）
    /// </summary>
    public string[] privilege { get; set; }
}

所有的頁面，都會繼承BasePage頁面，這樣方便處理，繼承這個頁面的其他頁面就不需要考慮認證的問題了。

public partial class BasePage : System.Web.UI.Page
{
    public BasePage()
    {
        this.Page.Load += new EventHandler(Page_Load);
        this.Page.Unload += new EventHandler(Page_UnLoad);
    }
    protected void Page_Load(object sender, EventArgs e)
    {
        DoWith();
    }

    protected void Page_UnLoad(object sender, EventArgs e)
    {
    }
    private void DoWith()
    {
        //用戶尚未登錄
        if (BLL.UserInfoManager.Instance().GetUserId() <= 0)
        {
            //獲取appId,appSecret的配置信息
            string appId = System.Configuration.ConfigurationSettings.AppSettings["appid"];
            string appSecret = System.Configuration.ConfigurationSettings.AppSettings["secret"];
            Core.WeiXinOAuth weixinOAuth = new WeiXinOAuth();
            //微信第一次握手后得到的code 和state
            string _code = Cmn.Request.Get("code");
            string _state = Cmn.Request.Get("state");

            if (_code == "" || _code == "authdeny")
            {
                if (_code == "")
                {
                    //發起授權(第一次微信握手)
                    string _authUrl = weixinOAuth.GetWeiXinCode(appId, appSecret, HttpContext.Current.Server.UrlEncode(HttpContext.Current.Request.Url.ToString()));
                    HttpContext.Current.Response.Redirect(_authUrl, true);
                }
                else
                { // 用戶取消授權
                    HttpContext.Current.Response.Redirect("~/Error.html", true);
                }
            }
            else
            {
                //獲取微信的Access_Token（第二次微信握手）
                Core.Model.WeiXinAccessTokenResult modelResult = weixinOAuth.GetWeiXinAccessToken(appId, appSecret, _code);

                //獲取微信的用戶信息(第三次微信握手)
                Core.Model.WeiXinUserInfoResult _userInfo = weixinOAuth.GetWeiXinUserInfo(modelResult.SuccessResult.access_token,modelResult.SuccessResult.openid);

                //用戶信息（判斷是否已經獲取到用戶的微信用戶信息）
                if (_userInfo.Result && _userInfo.UserInfo.openid != "")
                {
                    //保存獲取到的用戶微信用戶信息，並保存到數據庫中
                }
                else
                {
                    GameTradingByPublic.ExceptionLog.writeFile(2, "獲取用戶OpenId失敗");
                }
            }
        }
    }
}

 2016-6-16 更新：

關於模擬請求Request相關方法說明。可以參考我另外一篇文章：http://www.cnblogs.com/woaic/p/3942923.html