微信平台开发02-OAuth2.0授权

1.背景

在微信中定义了菜单,然后就需要得到用户的登录信息来区别用户的操作,比如是谁下单,当前用户的账号里有多少money等等。这其中核心要素就是绑定用户,也就是获取用户的身份信息。

2.分析

授权过程比较复杂,但是还好是顺序的流程。

graph LR
用户关注服务号-->在服务号中发送url给用户
在服务号中发送url给用户-->用户点击URL并同意
用户点击URL并同意-->得到code
得到code-->向服务器获取AccessToken
向服务器获取AccessToken-->获取用户信息

对于程序的调用流程来说是:

  • 第三方发起微信授权登录请求,微信用户允许授权第三方应用后,微信会拉起应用或重定向到第三方网站,并且带上授权临时票据code参数;

  • 通过code参数加上AppID和AppSecret等,通过API换取access_token;

  • 通过access_token进行接口调用,获取用户基本数据资源或帮助用户实现基本操作。

这远要比QQ的授权要复杂一些,至少在请求过程中需要多appid和appsecret参数才能正常通讯。


工作原理
第一步 配置权限和回调uri:
  • 确认在服务号后台的[开发者中心中]查看[接口权限列表],[网页服务]栏目中的[网页授权获取用户基本信息]是否是[已获得]的状态,这个需要服务号经过认证过才行;
  • 输入用于处理回调的页面域名,注意域名不能带http://
第二步 发给用户,用户同意授权,获取code:
https://open.weixin.qq.com/connect/oauth2/authorize?appid=${appid}&redirect_uri=${redirect_uri}&response_type=code&scope=${scope}&state=${state}#wechat_redirect

[图片上传失败...(image-579681-1514516869173)]

参数 说明
appid 公众号的标识,在微信后台里可以找到
redirect_uri 授权之后重定向需要调用的地址
scope 授权的作用域,snsapi_base直接授权了,只能获得用户的openid,snsapi_userinfo,这个可以继续通过用户的openid获取进一步的用户信息
state 重定向之后需要保留的参数,值由调用者指定,任意值
#wechat_redirect 直接点击链接可以不放这个参数,如果是读文章,已经读了一半用这个参数可以保留阅读进度

这一步的主要作用就是用来获取进一步通讯使用的临时code,需要用这个code加上AppID和AppSecret来换调用api所需要的access_token。
成功调用之后,需要用户授权,同意微信平台将回调之前我们给定的redirect_uri地址,以get的方式传回code和之前给定的state参数。

第三步 通过code换取网页授权access_token:

跟上一个步骤是很类似的,组合一个url,通过get方式请求

https://api.weixin.qq.com/sns/oauth2/access_token?appid=${APPID}&secret=${SECRET}&code=${CODE}&grant_type=authorization_code
参数 说明
appid 公众号的标识
secret 公众号的secret密钥
code 第二步中请求获得的临时票据code
grant_type authorization_code,默认参数

正常情况下以json格式返回:

{
   "access_token":"ACCESS_TOKEN",
   "expires_in":7200,
   "refresh_token":"REFRESH_TOKEN",
   "openid":"OPENID",
   "scope":"SCOPE"
}
参数 说明
access_token 网页授权接口调用凭证,此access_token与基础支持的access_token不同
expires_in access_token接口调用凭证超时时间,单位(秒)
refresh_token 用户刷新access_token需要调用另外一个接口,因为refresh_token会有更长的有效期,所以可以凭借refresh_token来再次获取access_token,简化获取code后再去获取access_token的步骤
openid 用户唯一标识,请注意,在未关注公众号时,用户访问公众号的网页,也会产生一个用户和公众号唯一的OpenID
scope 用户授权的作用域,使用逗号(,)分隔

如果调用错误那么会有一个错误的消息返回,具体可以参考【全局返回码】

第四步 拉取用户信息:

构建以下url,通过get方式获取

https://api.weixin.qq.com/sns/userinfo?access_token=${ACCESS_TOKEN}&openid=${OPENID}&lang=zh_CN
参数 描述
access_token 网页授权接口调用凭证,注意:此access_token与基础支持的access_token不同
openid 用户的唯一标识
lang 返回国家地区语言版本,zh_CN 简体,zh_TW 繁体,en 英语

返回值仍然是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"
}
参数 描述
openid 用户的唯一标识
nickname 用户昵称
sex 用户的性别,值为1时是男性,值为2时是女性,值为0时是未知
province 用户个人资料填写的省份
city 普通用户个人资料填写的城市
country 国家,如中国为CN
headimgurl 用户头像,最后一个数值代表正方形头像大小(有0、46、64、96、132数值可选,0代表640*640正方形头像),用户没有头像时该项为空。若用户更换头像,原有头像URL将失效。
privilege 用户特权信息,json 数组,如微信沃卡用户为(chinaunicom)
unionid 只有在用户将公众号绑定到微信开放平台帐号后,才会出现该字段。详见获取用户基本信息(UnionID机制)更新

这里简单展开一下openid和unionid的区别:

  • 每个用户对每个公众号的OpenID是唯一的。对于不同公众号,同一用户的openid不同,公众号可通过本接口来根据OpenID获取用户基本信息,包括昵称、头像、性别、所在城市、语言和关注时间。
  • 多个公众号,或在公众号、移动应用之间统一用户帐号的需求,需要前往微信开放平台(open.weixin.qq.com)绑定公众号后,才可利用UnionID机制来满足上述需求。在返回的用户基本信息中,可以用unionid来区分用户的唯一性。

3.注意事项

因为access_token资源比较有限,一般使用存放我们微信服务程序的服务器来获取,简单来说,需要一个专门的程序去拉取access_token,之后所有需要用到请求的程序,都从服务器获取全局的access_token来实现调用。初步的设想是每隔7000秒去调用一次获取access_token的请求,然后存放在全局缓存中供整体使用。

4.代码实现

以上内容是参考网址学习整理所得:http://mp.weixin.qq.com/wiki/4/9ac2e7b1f1d22e9e57260f6553822520.html

你可能感兴趣的:(微信平台开发02-OAuth2.0授权)