閱讀前提

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

閱讀本開發(fā)攻略前，請閱讀【QQ登錄】使用Authorization Code獲取Access Token以了解認(rèn)證流程。

1. 體驗(yàn)一把

1. 瀏覽器訪問：http://qzs.qq.com/qzone/openapi/client.html 。
2. 點(diǎn)擊頁面中的“登錄”按鈕：

3. 在彈出的登錄框中輸入QQ帳號和密碼：

4. 登錄成功后，跳轉(zhuǎn)到指定的回調(diào)地址，URL中帶有Access Token：

2. 快速上手

準(zhǔn)備工作

1. 請確保您的網(wǎng)站已經(jīng)提交接入QQ登錄的申請，并成功獲取到appid和appkey。申請接入
2. 請?jiān)谀愕姆?wù)器上ping openapi.qzone.qq.com ，保證網(wǎng)站和Qzone的連接暢通。

Step1：放置QQ登錄按鈕

網(wǎng)站需要下載“QQ登錄”按鈕圖片，并按照UI規(guī)范將按鈕放置在頁面合適的位置。
按鈕圖標(biāo)下載 按鈕放置規(guī)范

Step2：獲取Authorization Code

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

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

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

注意：
如果用戶點(diǎn)擊“跳過”，則跳轉(zhuǎn)到回調(diào)地址，返回默認(rèn)的頭像、昵稱和性別。
建議第三方應(yīng)用控制授權(quán)項(xiàng)，即參數(shù)scope中只傳入必須使用的OpenAPI名稱。因?yàn)槭跈?quán)項(xiàng)越多，用戶越有可能拒絕授權(quán)。

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

注意：
回調(diào)地址建議設(shè)置為網(wǎng)站首頁或網(wǎng)站的用戶中心。

Step3：通過Authorization Code獲取Access Token

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

2. 即可獲取到Access Token：

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

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

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

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

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

Step5：使用Access Token以及OpenID來訪問和修改用戶數(shù)據(jù)

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

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

（2）成功返回后，即可獲取到用戶數(shù)據(jù)：

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

3. 示例代碼