您的位置:首页 > 其它

【QQ登录】使用Implicit_Grant方式获取Access_Token

2012-05-26 22:03 633 查看


1. 简介

即client-side模式,是OAuth2.0认证的一种模式,又称User-Agent
Flow;

适用于需要通过客户端访问的方式,例如需要通过浏览器的javascript代码,或者电脑/移动终端上的客户端访问时。

其授权验证流程示意图如下(图片来源:OAuth2.0协议草案V21的4.2节



对于应用而言,只需要一步:构造授权地址,即可获取Access_Token。


2. 过程详解

请求地址:

PC网站: https://graph.qq.com/oauth2.0/authorize
WAP网站:https://graph.z.qq.com/moc2/authorize

请求参数:

请求参数请包含如下内容:

参数是否必须含义
response_type必须授权类型,此值固定为“token”。
client_id必须申请QQ登录成功后,分配给应用的appid。
redirect_uri必须成功授权后的回调地址,必须是注册appid时填写的主域名下的地址,建议设置为网站首页或网站的用户中心。
scope可选请求用户授权时向用户显示的可进行授权的列表。

可填写的值是【QQ登录】API文档中列出的接口,以及一些动作型的授权(目前仅有:do_like),如果要填写多个接口名称,请用逗号隔开。

例如:scope=get_user_info,list_album,upload_pic,do_like

不传则默认请求对接口get_user_info进行授权。

建议控制授权项的数量,只传入必要的接口名称,因为授权项越多,用户越可能拒绝进行任何授权。
state可选client端的状态值。用于第三方应用防止CSRF攻击,成功授权后回调时会原样带回。
display可选PC网站接入时使用。

用于展示的样式。不传则默认展示为为PC下的样式。

如果传入“mobile”,则展示为mobile端下的样式。
g_ut可选WAP网站接入时使用。

QQ登录页面版本(1:wml版本; 2:xhtml版本),默认值为1。

返回说明:

如果用户成功登录并授权,则会跳转到指定的回调地址,并在URL后加“#”号,带上Access Token以及expires_in等参数。如果redirect_uri地址后已经有“#”号,则加“&”号,带上相应的返回参数。如:

PC网站:http://graph.qq.com/demo/index.jsp?#access_token=FE04************************CCE2&expires_in=7776000

WAP网站:http://open.z.qq.com/demo/index.jsp?#access_token=FE04************************CCE2&expires_in=7776000

说明:expires_in是该access token的有效期,单位为秒。

Tips:

1. 可通过js方法:window.location.hash来获取URL中#后的参数值。

2. 建议用js设置cookie存储token。

错误码说明:

接口调用有错误时,会返回code和msg字段,以url参数对的形式返回,value部分会进行url编码(UTF-8)。

PC网站接入时,错误码详细信息请参见:100000-100031:PC网站接入时的公共返回码

WAP网站接入时,错误码详细信息请参见:8000-8999:通过Implicit模式获取Access
Token时,发生错误。


3. 快速上手

详见:【QQ登录】开发攻略_Client-side
内容来自用户分享和网络整理,不保证内容的准确性,如有侵权内容,可联系管理员处理 点击这里给我发消息
标签: 
相关文章推荐