透過 JS SDK 呼叫 OpenAPI 時,SDK 會自動帶上登入成功後快取的 accessToken 與 openID 這兩個核心參數,不需要 ourselves 另外傳入。以下示範取得使用者資料的作法,其他 OpenAPI 的呼叫方式大致相同。
先在頁面中引入 SDK 載入器,並帶上自己的 AppID 與 redirect URI:
<script type="text/javascript" src="https://qzonestyle.gtimg.cn/qzone/openapi/qc_loader.js" data-appid="APPID" data-redirecturi="REDIRECTURI" charset="utf-8"></script>
<script type="text/javascript">
// get_user_info 不需要輸入參數,因此 paras 為空物件
var paras = {};
QC.api("get_user_info", paras)
// 存取成功時的回呼,s 為回傳的 Response 物件
.success(function (s) {
// 透過 s.data 取得 OpenAPI 回傳的資料
alert("取得使用者資料成功!目前使用者暱稱為:" + s.data.nickname);
})
// 存取失敗時的回呼,f 為失敗的 Response 物件
.error(function (f) {
alert("取得使用者資料失敗!");
})
// 請求完成後的回呼,c 為完成的 Response 物件
.complete(function (c) {
alert("取得使用者資料完成!");
});
</script>
accessToken 與 openID 由 SDK 自動處理,呼叫端不必關心。success、error、complete 三個回呼分別對應成功、失敗與請求結束,可組成一條清楚的鏈式寫法。s.data 取得,例如 s.data.nickname 就是暱稱。