微信授权步骤与详解 -- c#篇

微信授权步骤与详解 -- c#篇

注：这里不涉及界面操作，只介绍代码操作。

1.基本原理如下：

　　

　　从图上所知，第一步用户访问我们的网页，第二步我们后台跳转到微信授权页面，第三步用户点击授权，第四步微信重定向到第三方（我们后台）并且返回code，第五步请求accesstoken获取accesstoken和openid。

2.详细介绍

　　第一步，用户访问我们网页。

例如，http://test.authorization.com/Main/TA

　　第二步，我们后台跳转到微信授权页面。（第一次握手）

首先，我们跳转到微信页面，传参数为appid、redirectUrl、response_type、scope、state。

url为："https://open.weixin.qq.com/connect/oauth2/authorize?appid=" + appId + "&redirect_uri=" + redirectUrl + "&response_type=code&scope=snsapi_userinfo&state=" + state + "#wechat_redirect"

redirectUrl 为当前后台请求的url。代码如下：

string response_type = "code";//    返回类型，此时固定为：code
string scope = "snsapi_userinfo";//应用授权作用域，snsapi_base （不弹出授权页面，直接跳转，只能获取用户openid），snsapi_userinfo （弹出授权页面，可通过openid拿到昵称、性别、所在地。并且，即使在未关注的情况下，只要用户授权，也能获取其信息）
string state = "state";//随便写，微信提供给我们的自定义参数。重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节
string url = string.Format("https://open.weixin.qq.com/connect/oauth2/authorize?appid={0}&redirect_uri={1}&response_type={2}&scope={3}&state={4}#wechat_redirect",appid, redirect_uri, response_type, scope, state);
hconHttpContextBase.Response.Redirect(url, true);//跳转到微信授权

　　　第三步，用户点击授权。

　

　　第四步，微信重定向到第三方（我们后台）并且返回code（第二次握手）

微信重定向回我们后台时，会返回code，所以我们可以判断是否有code来确定微信是第几次握手。没code是第一次握手，有code是第二次握手。

　　第五步，请求accesstoken获取accesstoken和openid

请求代码如下：

            
　　　　　　　string url = "https://api.weixin.qq.com/sns/oauth2/access_token";//请求的url
            string sUrlpara = "appid=" + appId + "&secret=" + appSecret +
                         "&code=" + code + "&grant_type=authorization_code";//请求的参数
            string jsonStr = Toos.HttpGet(url, sUrlpara);//网络get请求
            //放回json解析
            WeiXinAccessTokenResult result = new WeiXinAccessTokenResult();
            if (jsonStr.Contains("errcode"))
            {
                WeiXinErrorMsg errorResult = new WeiXinErrorMsg();
                errorResult = JsonHelper.ParseFormJson<WeiXinErrorMsg>(jsonStr);
                result.ErrorResult = errorResult;
                result.Result = false;
            }
            else
            {
                WeiXinAccessTokenModel model = new WeiXinAccessTokenModel();
                model = JsonHelper.ParseFormJson<WeiXinAccessTokenModel>(jsonStr);
                result.SuccessResult = model;
                result.Result = true;
            }    

返回的json是：　　

//正确的时候：
{
   "access_token":"ACCESS_TOKEN",
   "expires_in":7200,
   "refresh_token":"REFRESH_TOKEN",
   "openid":"OPENID",
   "scope":"SCOPE",
   "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL" //这里一般没有返回，待定。
}

//错误的时候：
{"errcode":40029,"errmsg":"invalid code"}

json解析的对象代码

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

        public WeiXinErrorMsg ErrorResult { get; set; }
    }

    /// <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; }
    }

    /// <summary>
    /// 微信错误访问的情况 
    /// </summary>
    public class WeiXinErrorMsg
    {
        /// <summary>
        /// 错误编号
        /// </summary>
        public int errcode { get; set; }
        /// <summary>
        /// 错误提示消息
        /// </summary>
        public string errmsg { get; set; }
    }

　

Tool.HttpGet方法

        public static string HttpGet(string Url, string postDataStr)
        {
            HttpWebRequest request = (HttpWebRequest)WebRequest.Create(Url + (postDataStr == "" ? "" : "?") + postDataStr);
            request.Method = "GET";
            request.ContentType = "text/html;charset=UTF-8";

            HttpWebResponse response = (HttpWebResponse)request.GetResponse();
            Stream myResponseStream = response.GetResponseStream();
            StreamReader myStreamReader = new StreamReader(myResponseStream, Encoding.GetEncoding("utf-8"));
            string retString = myStreamReader.ReadToEnd();
            myStreamReader.Close();
            myResponseStream.Close();

            return retString;
        }

3. 获取用户信息
　　获取用户很简单，只需要传一个token以及openid获取用户的基本信息。

代码如下：

            string url = "https://api.weixin.qq.com/sns/userinfo";
            string urlParam = "access_token=" + accessToken + "&openid=" + openId +
                         "⟨=zh_CN";
            string jsonStr = Toos.HttpGet(url, urlParam); ;
            WeiXinUserInfoResult result = new WeiXinUserInfoResult();
            result.token = accessToken;
            if (jsonStr.Contains("errcode"))
            {
                WeiXinErrorMsg errorResult = new WeiXinErrorMsg();
                errorResult = JsonHelper.ParseFormJson<WeiXinErrorMsg>(jsonStr);
                result.ErrorMsg = errorResult;
                result.Result = false;
            }
            else
            {
                WXUserInfo userInfo = new WXUserInfo();
                userInfo = JsonHelper.ParseFormJson<WXUserInfo>(jsonStr);
                result.UserInfo = userInfo;
                result.Result = true;
            }    

返回的json对象

{
   "openid":" OPENID",
   " nickname": NICKNAME,
   "sex":"1",
   "province":"PROVINCE"
   "city":"CITY",
   "country":"COUNTRY",
    "headimgurl":    "http://wx.qlogo.cn/mmopen/g3MonUZtNHkdmzicIlibx6iaFqAc56vxLSUfpb6n5WKSYVY0ChQKkiaJSgQ1dZuTOgvLLrhJbERQQ4eMsv84eavHiaiceqxibJxCfHe/46", 
    "privilege":[
    "PRIVILEGE1"
    "PRIVILEGE2"
    ],
    "unionid": "o6_bmasdasdsad6_2sgVt7hMZOPfL"
}

解析json对象

    public class WeiXinUserInfoResult
    {

        public string token { get; set; }
        /// <summary>
        /// 微信用户信息
        /// </summary>
        public WXUserInfo UserInfo { get; set; }
        /// <summary>
        /// 结果
        /// </summary>
        public bool Result { get; set; }
        /// <summary>
        /// 错误信息
        /// </summary>
        public WeiXinErrorMsg ErrorMsg { get; set; }

        public override string ToString()
        {
            return string.Format("UserInfo: {0}, Result: {1},   ErrorMsg: {2},  token:{3}", UserInfo, Result, ErrorMsg, token);
        }
    }


  

备注：

添加jsonhelp类

    public class JsonHelper
    {
        public JsonHelper()
        {
            //
            // TODO: Add constructor logic here
            //
        }

        /// <summary>
        /// 把对象序列化 JSON 字符串 
        /// </summary>
        /// <typeparam name="T">对象类型</typeparam>
        /// <param name="obj">对象实体</param>
        /// <returns>JSON字符串</returns>
        public static string GetJson<T>(T obj)
        {
            //记住 添加引用 System.ServiceModel.Web 
            /**
             * 如果不添加上面的引用,System.Runtime.Serialization.Json; Json是出不来的哦
             * */
            DataContractJsonSerializer json = new DataContractJsonSerializer(typeof (T));
            using (MemoryStream ms = new MemoryStream())
            {
                json.WriteObject(ms, obj);
                string szJson = Encoding.UTF8.GetString(ms.ToArray());
                return szJson;
            }
        }

        /// <summary>
        /// 把JSON字符串还原为对象
        /// </summary>
        /// <typeparam name="T">对象类型</typeparam>
        /// <param name="szJson">JSON字符串</param>
        /// <returns>对象实体</returns>
        public static T ParseFormJson<T>(string szJson)
        {
            T obj = Activator.CreateInstance<T>();
            using (MemoryStream ms = new MemoryStream(Encoding.UTF8.GetBytes(szJson)))
            {
                DataContractJsonSerializer dcj = new DataContractJsonSerializer(typeof (T));
                return (T) dcj.ReadObject(ms);
            }
        }
    }

详细请看微信官方说明：

http://qydev.weixin.qq.com/wiki/index.php?title=WeixinJS%E6%8E%A5%E5%8F%A3

可以关注本人的公众号，多年经验的原创文章共享给大家。