要讓網站支援 QQ 登入,最省事的方式是採用騰訊提供的 QConnect JS SDK。流程大致分兩步:先載入授權腳本,再選擇用官方按鈕或自製按鈕發起登入。
把 appid 與 redirecturi 寫在 script 標籤的 data 屬性上:
<script type="text/javascript" src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js" data-appid="101140406" data-redirecturi="https://127.0.0.1" charset="utf-8"></script>
appid 是你在 QQ 互联平台上申請應用後拿到的編號,redirecturi 則是授權完成後要跳回的位置,必須與後台設定完全一致,否則會被拒絕。
呼叫 QC.Login 並指定容器節點 id,SDK 會自動在那個位置插入登入按鈕。缺點是會彈出新視窗:
QC.Login({
// btnId:插入按鈕的節點 id,必填
btnId: "qqLoginBtn",
// 需要確認的授權範圍,可選,預設 all
scope: "all",
// 按鈕尺寸,可用值 [A_XL|A_L|A_M|A_S|B_M|B_S|C_S],可選,預設 B_S
size: "B_M"
}, function (reqData, opts) {
// 登入成功
console.log(reqData, opts);
// 依回傳資料把按鈕換成「已登入」狀態
var dom = document.getElementById(opts['btnId']);
var _logoutTemplate = [
'<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(_logoutTemplate, {
nickname: QC.String.escHTML(reqData.nickname), // 做 XSS 過濾
figureurl: reqData.figureurl
}));
}, function (opts) {
// 登出成功
alert('QQ 登入 登出成功');
});
這裡有個細節值得學:QC.String.escHTML() 對暱稱做了轉義。使用者暱稱是使用者可控的內容,直接塞進 innerHTML 等於替 XSS 開了後門,這個動作不能省。
若不喜歡彈窗,可以自己畫一個 <a>,讓使用者點擊後跳去授權頁;回跳回來之後,再呼叫 API 取得使用者資料:
QC.api("get_user_info", {})
// 指定介面存取成功的回呼,s 為成功時的 Response 物件
.success(function (s) {
console.log(s);
alert("獲取用戶信息成功!當前用戶暱稱為:" + s.data.nickname);
})
// 存取失敗
.error(function (f) {
alert("獲取用戶信息失敗!");
})
// 請求完成(不論成敗都會執行)
.complete(function (c) {
alert("獲取用戶信息完成!");
});
// 檢查是否已登入
if (QC.Login.check()) {
QC.Login.getMe(function (openId, accessToken) {
alert(["當前登入用戶的",
"openId 為:" + openId,
"accessToken 為:" + accessToken].join("\n"));
});
// 這裡可以呼叫自己的後端介面,把 openId 與自家帳號做綁定
}
accessToken 只能存在前端暫時使用。正式環境的正確流程是:前端取得 code 或 token 後傳給自己的後端,由後端帶著 appsecret 去換取正式的 access_token,再呼叫 QQ 的 user info 介面。appsecret 一旦寫進前端程式碼,等於公開,任何人都能冒用你的應用。
openId 才是可靠的識別碼。暱稱與頭像會變,openId 才是同一使用者在同一應用下的固定標識,帳號綁定請一律以它為依據。
注意 SDK 與 API 的世代差異。上面這套 QConnect 屬於較早期的整合方式,QR 掃碼登入的官方入口與參數命名後續有過調整。新專案建議直接查閱 QQ 互联目前公布的文件,以免照抄到已停用的介面。