利用JS_SDK实现QQ第三方登录

前言

现如今,第三方登录已成为大部分网站必备的一项基础技能,引入时髦的第三方登录不仅能帮你吸引更多的用户,也让你的网站可以充分利用其他大型网站的用户资源。本次教程将让你的网站最快捷便利地引入QQ登录。

QQ第三方登录目前提供了JS SDK功能,这也是目前最简单直接的接入QQ互联的方式,没有之一。下面我将通过简单的几步轻松地让你的网站接入QQ登录。

准备工作

在正式接入之前你需要了解以下名词的含义:

1. appid :应用的唯一标识。在OAuth2.0认证过程中,appid的值即为oauth_consumer_key的值。

2. appkey:appid对应的密钥,访问用户资源时用来验证应用的合法性。在OAuth2.0认证过程中,appkey的值即为oauth_consumer_secret的值。

3. redirecturl:成功授权后的回调地址,必须是注册appid时填写的主域名下的地址,建议设置为网站首页或网站的用户中心。注意需要将url进行URLEncode。

4. access token:用来判断用户在本网站上的登录状态,具有3个月有效期,用户再次登录时自动刷新。

5. openid:是此网站上唯一对应用户身份的标识,网站可将此ID进行存储便于用户下次登录时辨识其身份,或将其与用户在网站上的原有帐号进行绑定。

第一步

要接入QQ登录,必不可少的是appid和appkey,通过申请接入QQ登录,按照相应步骤操作即可轻松获得,在此不做赘述。

第二步

在需要放置QQ登录按钮的页面加入下面SCRIPT代码:

<script type="text/javascript" src="http://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js" data-appid="APPID" data-redirecturi="REDIRECTURI" charset="utf-8"></script>

PS:APPID 和 REDIRECTURI 换成第一步申请所得到的对应内容,REDIRECTURI 就是登录之后返回的回调地址,在申请页面自己填写,一般写网站主域名即可。注意:回调地址必须以http或https开头。

第三步

在页面放置一个元素节点用来展现登录按钮,并且指定其ID,如:

<div id="qq"></div>

然后在页面加入如下SCRIPT:

<script type="text/javascript">

    QC.Login({

       btnId:"qq"    //插入按钮的节点id

});

</script>

这时你就可以在页面看到如下效果:

如何你对这个展示效果不满意,也可以自定义登录按钮

第四步

在  REDIRECTURI 即回调地址页面加入如下SCRIPT:

<script type="text/javascript"

src="http://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js" charset="utf-8" data-callback="true"></script>

PS:官方说法如果回调地址页与加入QQ登录按钮是同一个页面,则只需要引用一次脚本文件。如果你理解不了这种官方说法,可以在第一步的脚本中加入data-callback="true"属性,而忽略第四步,前提是回调地址页与加入QQ登录按钮的页面是同一个页面。

第五步

因为JS SDK封装了获取Access Token以及OpenID的方法,因此开发者不需要用开发代码进行获取,直接调用QQ登录OpenAPI即可。

调用OpenAPI时,请统一遵循下述调用方式:

QC.api(api, paras, fmt, method)

参数说明:

参数名称 是否必须 描述
api 必须 指定要调用的OpenAPI名称。例如:调用add_t时,OpenAPI名称为“add_t”。 
各OpenAPI的名称具体请参见API列表。
paras 必须 指定要调用的OpenAPI对应的参数。各参数使用JSON的键值对格式列出。 
OpenAPI对应的参数具体请参见API列表中各OpenAPI的参数说明。
注意:此处参数不需要自行传递access_token与openid
fmt 可选 指定OpenAPI的返回格式,可用值为“json”或“xml”。默认为“json”。 
注意:json、xml为小写,否则将不识别。
method 可选 指定OpenAPI调用请求的发起方式,可用值为“GET”或“POST”。根据配置,默认发送数据为“POST”,获取数据为“GET”。

最后

提供一种代码接入思路,仅供参考:

QC.api("get_user_info", {}) //get_user_info是API参数

//指定接口访问成功的接收函数,s为成功返回Response对象

       .success(function (s) {

           //成功回调,通过s.data获取OpenAPI的返回数据

           nick = s.data.nickname; //获得昵称

           headurl = s.data.figureurl_qq_1; //获得头像

           if (QC.Login.check()) {//判断是否登录

               QC.Login.getMe(function (openId, accessToken) { //这里可以得到openId和accessToken

                   //下面可以调用自己的保存方法

                   ……

               });

           }

       })

//指定接口访问失败的接收函数,f为失败返回Response对象

       .error(function (f) {

           //失败回调

           alert("获取用户信息失败!");

       });

   ////指定接口完成请求后的接收函数,c为完成请求返回Response对象

   //.complete(function (c) {

   //    //完成请求回调

   //    alert("获取用户信息完成!");

   //});

结束语

如果按照上述步骤操作后得不到你需要的用户信息,别担心,刷新下页面可能会有意想不到的惊喜哦。这是因为你在本地测试和你在申请时填的回调地址不匹配造成的,真正上线之后就没有问题了。

最后希望本次教程对大家有点帮助和启发。

 

本文原创自我爱学框架,欢迎转载,请保留原文链接!

原文链接:http://www.itframe.top/Detail/Index/article/eed968bd-a64a-47d3-b9cf-40291bdcc7be.html

posted @ 2016-06-30 15:09  孤星隐客  阅读(5595)  评论(0编辑  收藏  举报