閱讀前提

本開發(fā)攻略基于使用Authorization Code獲取Access Token的授權驗證流程，適用于需要從web server訪問的應用，例如Web/wap網站。

閱讀本開發(fā)攻略前，請閱讀【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規(guī)范將按鈕放置在頁面合適的位置。
按鈕圖標下載 按鈕放置規(guī)范

Step2：獲取Authorization Code

1. 打開瀏覽器，訪問如下地址（請將client_id，redirect_uri，scope等參數值替換為你自己的）：

2. 如果用戶已經有登錄態(tài)，會彈出提示一個確認頁。如果還沒有登錄，會彈出登錄頁，如下圖所示：

3. 成功登錄后，彈出授權框引導用戶授權（僅在第一次成功登錄，以及第一次訪問某個未授權的OpenAPI時會出現授權頁），如下圖所示：

注意：
如果用戶點擊“跳過”，則跳轉到回調地址，返回默認的頭像、昵稱和性別。
建議第三方應用控制授權項，即參數scope中只傳入必須使用的OpenAPI名稱。因為授權項越多，用戶越有可能拒絕授權。

4. 如果用戶點擊“確認”授權，則成功跳轉到指定的redirect_uri，并跟上Authorization Code（注意此code會在10分鐘內過期）。
例如回調地址是：www.qq.com/my.php，則會跳轉到：

注意：
回調地址建議設置為網站首頁或網站的用戶中心。

Step3：通過Authorization Code獲取Access Token

1.發(fā)送請求到如下地址（請將參數值替換為你自己的，參數解釋詳見這里）：

2. 即可獲取到Access Token：

可在回調URL對應的程序（見下文的示例代碼）中接受請求，并完成獲取Access Token的工作。

Step4：使用Access Token來獲取用戶的OpenID

1. 發(fā)送請求到如下地址（請將access_token等參數值替換為你自己的）：

2. 獲取到用戶OpenID，返回包如下：

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

Step5：使用Access Token以及OpenID來訪問和修改用戶數據

1. 建議網站在用戶登錄后，即調用get_user_info接口，獲得該用戶的頭像、昵稱并顯示在網站上，使用戶體驗統(tǒng)一。
2. 調用其他OpenAPI，以訪問和修改用戶數據。所有OpenAPI詳見【QQ登錄】API文檔。

以調用get_user_info接口為例：
（1）發(fā)送請求到get_user_info的URL（請將access_token，appid等參數值替換為你自己的）：

（2）成功返回后，即可獲取到用戶數據：

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

3. 示例代碼