萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JavaScript 接入 QQ 互聯實現第三方登入:JS SDK 完整接入流程與程式碼範例

網站快速接入 QQ 登入:基於 JS SDK 的前端整合完整指南

QQ 互聯(QQ Connect)提供 OAuth 2.0 授權體系,讓網站用戶無需註冊即可使用 QQ 帳號登入。本文基於官方 JS SDK,詳細說明前端接入流程、按鈕渲染、登入回調、用戶資訊獲取與登出實作,並附上完整可執行程式碼範例。

一、前置準備

  1. 在 QQ 互聯管理中心 建立應用,獲取 App ID 與 App Key。
  2. 設定授權回調域(需與部署域名一致,支援子域名通配)。
  3. 審核通過後獲得 appid,即可開始前端開發。

二、引入 JS SDK

<!-- 在 <head> 中引入,非同步載入 -->
<script type="text/javascript"
    src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js"
    data-appid="YOUR_APP_ID"
    data-redirecturi="YOUR_CALLBACK_URL" <!-- 必須帶 http(s):// -->
    charset="utf-8">
</script>

參數說明:

  • data-appid:申請到的 App ID。
  • data-redirecturi:授權回調地址(需 URL 編碼),例如 https://www.example.com/qq-callback。
  • charset:建議 utf-8。

三、渲染登入按鈕與處理回調

<div id="qqLoginBtn"></div> <!-- 按鈕容器,SDK 會自動渲染 -->

<script>
window.onload = function () {
    QC.Login({
        btnId: 'qqLoginBtn' // 按鈕容器 ID
    }, function (reqData, opts) {
        // 登入成功回調
        var dom = document.getElementById(opts.btnId);
        var logoutTpl = [
            '<span><img src="{figureurl}" class="{size_key}" /></span>', // 頭像
            '<span>{nickname}</span>',                                      // 暱稱
            '<span><a href="javascript:QC.Login.signOut();">退出</a></span>' // 登出連結
        ].join('');

        dom && (dom.innerHTML = QC.String.format(logoutTpl, {
            nickname: QC.String.escHTML(reqData.nickname), // XSS 過濾
            figureurl: reqData.figureurl
        }));

        // 可在此發送 reqData 到後端換取 access_token、綁定帳號等
        console.log('QQ 登入成功:', reqData);
    }, function (opts) {
        // 登出成功回調
        alert('已登出');
        // 重置按鈕 UI
        document.getElementById(opts.btnId).innerHTML = '';
        // 重新初始化登入按鈕(可選)
        QC.Login({ btnId: opts.btnId });
    });
};
</script>

四、呼叫 OpenAPI 獲取用戶詳細資訊

// 檢測是否已登入並獲取 openid、access_token
QC.api('get_user_info', {
    oauth_consumer_key: 'YOUR_APP_ID' // 可選,SDK 會自動補全
}).success(function (response) {
    if (response.ret === 0) {
        console.log('用戶資訊:', response);
        // response 包含:nickname, figureurl, figureurl_1, figureurl_2, gender, vip 等
    } else {
        console.error('API 調用失敗:', response.msg);
    }
});

// 另一種方式:直接獲取 openid/access_token(需用戶已授權)
if (QC.Login.check()) {
    QC.Login.getMe(function (openId, accessToken) {
        console.log('openId:', openId, 'accessToken:', accessToken);
        // 將 openId、accessToken 送往後端換取用戶資料、綁定本地帳號
    });
}

五、完整可執行單頁面範例

<!DOCTYPE html>
<html><head><meta charset="utf-8"><title>QQ 登入 Demo</title></head><body>
<div class="login-area">
  <h3>QQ 登入示例</h3>
  <div id="qqLoginBtn"></div>
  <div id="user-info" style="margin-top:20px; display:none;"></div>
</div>

<script src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js"
        data-appid="YOUR_APP_ID"
        data-redirecturi="https://YOUR_DOMAIN/qq-callback"
        charset="utf-8"></script>
<script>
QC.Login({
    btnId: 'qqLoginBtn'
}, function (reqData, opts) {
    var dom = document.getElementById(opts.btnId);
    var tpl = '<img src="{figureurl}" style="width:32px;height:32px;border-radius:50%"/> '
            + '<span>{nickname}</span> '
            + '<button onclick="QC.Login.signOut()">退出登入</button>';
    dom.innerHTML = QC.String.format(tpl, {
        nickname: QC.String.escHTML(reqData.nickname),
        figureurl: reqData.figureurl_qq_1 || reqData.figureurl
    });
    document.getElementById('user-info').style.display = 'block';
    document.getElementById('user-info').innerHTML = '<pre>' + JSON.stringify(reqData, null, 2) + '</pre>';
}, function (opts) {
    document.getElementById(opts.btnId).innerHTML = '';
    document.getElementById('user-info').style.display = 'none';
    QC.Login({ btnId: opts.btnId }); // 重新渲染登入按鈕
});
</script>
</body></html>

六、常見問題與避坑指南

問題原因解決方案
按鈕不顯示/點擊無反應SDK 載入失敗、appid 錯誤、redirecturi 不匹配Console 檢查網路請求;確認 redirecturi 與後台設定完全一致(含協議、域名、路徑)
redirect_uri_mismatch回調地址不在白名單QQ 互聯後台「應用配置」→「授權回調域」新增完整域名
獲取不到用戶頭像/暱稱reqData 字段名變更Console log reqData 確認實際字段;優先用 figureurl_qq_1/2
登出後按鈕不恢復未重新初始化 QC.Login登出回調中呼叫 QC.Login({ btnId }) 重新渲染
HTTPS 站點引入 HTTP SDK混合內容被瀏覽器阻擋SDK 網址已支援 HTTPS,確保使用 https://qzonestyle.gtimg.cn/...

七、安全性與後端配合

  1. 前端僅獲取授權碼/access_token,敏感操作(綁定帳號、發放 JWT)必須在後端完成。
  2. 後端驗證 access_token:呼叫 https://graph.qq.com/oauth2.0/me?access_token=... 獲取 openid,再呼叫 get_user_info 獲取用戶資料。
  3. 防 CSRF:OAuth 流程中加入 state 參數,回調時驗證。
  4. Token 儲存:access_token 有效期較短(通常 3 個月),需實作刷新機制或引導用戶重新授權。

掌握以上流程,您就能在半小時內為網站接入 QQ 登入,顯著降低用戶註冊門檻,提升轉化率。

copyright © 萬盛學電腦網 all rights reserved