分享到 :

开发攻略_Client-side

阅读前提

本开发攻略适用于使用Implicit Grant方式获取Access Token的授权验证流程，适用于需要通过客户端访问的方式，例如需要通过浏览器的javascript代码，或者电脑/移动终端上的客户端访问时。
阅读本开发攻略前，请阅读使用Implicit Grant方式获取Access Token以了解认证流程。

1. 体验一把

1. 浏览器访问：http://qzs.qq.com/qzone/openapi/client.html 。
2. 点击页面中的“登录”按钮：

3. 在弹出的登录框中输入QQ账号和密码：

4. 登录成功后，跳转到指定的回调地址，URL中带有Access Token：
OAuth_guide_V2_5.png

2. 快速上手

准备工作

1. 请确保您的网站已经提交接入QQ登录的申请，并成功获取到appid和appkey。申请接入
2. 请在你的服务器上ping graph.qq.com ，保证网站和互联的连接畅通。

Step1：放置QQ登录按钮

网站需要下载“QQ登录”按钮图片，并按照UI规范将按钮放置在页面合适的位置。
按钮图标下载
按钮放置规范

Step2：获取Access Token

1. 打开浏览器，访问如下地址（请将client_id，redirect_uri，scope等参数值替换为你自己的）：

https://graph.qq.com/oauth2.0/authorize?response_type=token&client_id=[YOUR_APPID]&redirect_uri=[YOUR_REDIRECT_URI]&scope=[THE_SCOPE]

2. 跳转登录授权页，如下图所示：

3. 如果用户点击“授权并登录”，则成功跳转到指定的redirect_uri，并在URL后加“#”号，带上Access Token以及expires_in等参数。如果redirect_uri地址后已经有“#”号，则加“&”号，带上相应的返回参数。
例如回调地址是：www.qq.com，则会跳转到：

http://www.qq.com/?#access_token=YOUR_ACCESS_TOKEN&expires_in=3600

特别提示：
1. 请求时传入的recirect_uri必须与注册时填写的回调地址一致，用来进行第三方应用的身份验证。
2. 可通过js方法：window.location.hash来获取URL中#后的参数值，详见下面的示例代码。
3. 建议用js设置cookie存储token。

4. 获取到的access token具有60天有效期，用户再次登录时自动刷新。

Step3：使用Access Token来获取用户的OpenID

1. 发送请求到如下地址（请将access_token等参数值替换为你自己的）：

https://graph.qq.com/oauth2.0/me?access_token=YOUR_ACCESS_TOKEN

2. 获取到用户OpenID，返回包如下：

callback( {"client_id":"YOUR_APPID","openid":"YOUR_OPENID"} );

Step4：使用Access Token以及OpenID来访问和修改用户数据

1. 建议网站在用户登录后，即调用get_user_info接口，获得该用户的头像、昵称并显示在网站上，使用户体验统一。
2. 调用其他OpenAPI，以访问和修改用户数据。所有OpenAPI详见API列表。
以调用get_user_info接口为例：
（1）发送请求到get_user_info的URL（请将access_token，appid等参数值替换为你自己的）：

https://graph.qq.com/user/get_user_info?access_token=YOUR_ACCESS_TOKEN&oauth_consumer_key=YOUR_APP_ID&openid=YOUR_OPENID

（2）成功返回后，即可获取到用户数据：

{
  "ret":0,
   "msg":"",
   "nickname":"YOUR_NICK_NAME",
   ...
}

3. 示例代码

下面给出了一个JavaScript的样例（只需要按照注释修改部分代码即可运行）

  <html>
     <head>
        <title>Client Flow Example</title>
     </head>
     <body>
        <script>
           function callback(user)
           {
              var userName = document.getElementById('userName');
              var greetingText = document.createTextNode('Greetings, '+ user.openid + '.');
              userName.appendChild(greetingText);
           }
           //应用的APPID，请改为你自己的
            var appID = "YOUR_APP_ID";
           //成功授权后的回调地址，请改为你自己的
            var redirectURI = "http://qzs.qq.com/qzone/openapi/success.html";
           //构造请求
           if (window.location.hash.length == 0)
           {
              var path = 'https://graph.qq.com/oauth2.0/authorize?';
              var queryParams = ['client_id=' + appID,'redirect_uri=' + redirectURI,'
              scope=' + 'get_user_info,list_album,upload_pic,add_feeds,do_like','response_type=token'];
              var query = queryParams.join('&');
              var url = path + query;
              window.open(url);
           }
           else
           {
              //获取access token
              var accessToken = window.location.hash.substring(1);
              //使用Access Token来获取用户的OpenID
              var path = "https://graph.qq.com/oauth2.0/me?";
              var queryParams = [accessToken, 'callback=callback'];
              var query = queryParams.join('&');
              var url = path + query;
              var script = document.createElement('script');
              script.src = url;
              document.body.appendChild(script);
           }
        </script>
     </body>
 </html>

4. 使用JS SDK

为了让应用更快接入，腾讯提供了JS SDK，应用只需引入js脚本，再进行少量的代码修改，即可接入QQ登录，过程非常简单快速。
详见：
JS SDK使用说明

返回顶部