开发攻略_Server-side

阅读前提

本开发攻略基于使用Authorization Code获取Access Token的授权验证流程，适用于需要从web server访问的应用，例如Web/wap网站。

阅读本开发攻略前，请阅读【QQ登录】使用Authorization Code获取Access Token以了解认证流程。

1. 体验一把

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

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

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

2. 快速上手

准备工作

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

Step1：放置QQ登录按钮

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

Step2：获取Authorization Code

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

2. 如果用户已经有登录态，会弹出提示一个确认页。如果还没有登录，会弹出登录页，如下图所示：

3. 成功登录后，弹出授权框引导用户授权（仅在第一次成功登录，以及第一次访问某个未授权的OpenAPI时会出现授权页），如下图所示：

注意：
如果用户点击“跳过”，则跳转到回调地址，返回默认的头像、昵称和性别。
建议第三方应用控制授权项，即参数scope中只传入必须使用的OpenAPI名称。因为授权项越多，用户越有可能拒绝授权。

4. 如果用户点击“确认”授权，则成功跳转到指定的redirect_uri，并跟上Authorization Code（注意此code会在10分钟内过期）。
例如回调地址是：www.qq.com/my.php，则会跳转到：

注意：
回调地址建议设置为网站首页或网站的用户中心。

Step3：通过Authorization Code获取Access Token

1.发送请求到如下地址（请将参数值替换为你自己的，参数解释详见这里）：

2. 即可获取到Access Token：

可在回调URL对应的程序（见下文的示例代码）中接受请求，并完成获取Access Token的工作。

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

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

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

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

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

1. 建议网站在用户登录后，即调用get_user_info接口，获得该用户的头像、昵称并显示在网站上，使用户体验统一。
2. 调用其他OpenAPI，以访问和修改用户数据。所有OpenAPI详见【QQ登录】API文档。

以调用get_user_info接口为例：
（1）发送请求到get_user_info的URL（请将access_token，appid等参数值替换为你自己的）：

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

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

3. 示例代码