騰訊微博 JS-SDK接入

官方文檔：

open.js

api查詢

api調試接口

 

1.接口初始化

加載openjs源代碼。

<script type="text/javascript" src="http://mat1.gtimg.com/app/openjs/openjs.js"></script>

初始化

T.init({ appkey: 123456 //執行初始化,appkey爲123456
});

描述

Object T.init(Object initObject)

T.int執行初始化。

參數

initObject 必選，初始化參數選項。更多可配置參數，請參考initObject

返回

T

 

2.獲取數據API接口

T.api調用騰訊微博API接口，存取微博數據。調試接口

描述

Object T.api(String apiName [,Object apiParams [,String dataType [,String type]]])

參數： apiName 必選，API接口名稱。

A.apiParams 可選，該接口對應的JSON格式的參數表。

B.dataType 可選，json或xml，默認爲json。

C.type 可選，GET或POST，默認爲GET。  

返回 ： DeferredObject

T.api("/status/public_timeline",null,"json","GET") .success(function (response) { //調用成功
    alert("成功") }) .error(function (code, message){ //調用失敗
 alert(message) });

 

 

3. task 任務組。（FB平臺上面沒有看到這類功能接口）

描述：

Object T.task(DeferredObject action [,DeferredObject action[,DeferredObject action [,...]]])

T.task可建立任務組，可用來同時完成多項任務，如調用騰訊微博API接口或其它返回DeferredObject的接口。

參數 ： action 必選，DeferredObject延時對象。

返回：　DeferredObject

T.task( T.api("/statuses/home_timeline"), // 這是第一個任務
  T.api("/statuses/public_timeline") // 這是第二個任務
  //... 能夠在這裏建立多個任務
 ) .success(function (homeData,publicData) {// 兩項任務均成功，數據依次回調
     //標明兩個任務均成功
     alert("成功"); }) .error(function (code, message){// 有任務發生了失敗
     //任務中有失敗的狀況
 alert(message); }) .complete(function () { // 兩個任務均有結果，無論其爲成功仍是失敗
     //      alert("任務執行完畢"); });

 

4.重要事件

1)tokenReady

描述

Object T.tokenReady(Function handler)

T.tokenReady 保證用戶登陸狀態肯定後執行。  

如用戶登陸態已準備好，則直接執行回調函數，不然等待至用戶登陸態準備好後觸發。

參閱事件和openjs支持的六種事件。

T.tokenReady( function () { //登陸態已準備好
    var loginStatus = this.loginStatus();
    if (loginStatus.access_token) {
        alert("access_token = " + loginStatus.access_token);
    }
});

 

2)documentReady

描述

Object T.documentReady(Function handler)

T.documentReady 保證DOM可操做後執行。  

如DOM已可操做，則直接執行handler。不然等待至DOM可操做再執行handler，與jQuery.ready方法等同。

T.documentReady( function () {
    alert(「DOM is ready」);
});

 

3)ready

描述

Object T.ready(Function handler)

T.ready保證回調函數在用戶登陸態和DOM都可操做後執行。  

如用戶登陸態和DOM都已可操做，則直接執行handler。不然等待至條件知足後執行。(T.ready至關於documentReady而且tokenReady)。

T.ready( function () {
    alert(「everything is ready」);
});

 

7.輔助接口

1)localStorage對象

localStorage提供跨瀏覽器的數據本地存儲支持，兼容絕大多數主流瀏覽器，方便應用存儲離線數據到用戶的瀏覽器端，以加強客戶端體驗。

T.localStorage.save  

描述

Object T.localStorage.save(String key, Mixed value [,Number expires])

T.localStorage.save存儲鍵值到瀏覽器本地存儲空間中。  

參數

key 必選，鍵名。

value 必選，鍵值。 expires 可選，數據過時時間，以天爲單位。默認爲7天。 

返回

value {Mixed} 保存在本地存儲空間中的值(能夠據此判斷存儲是否成功)。

T.localStorage.save("foo", "bar");

 

T.localStorage.get

描述

Object T.localStorage.get(String key [,Mixed defaultValue])

 

T.localStorage.get根據鍵名取出鍵值。

參數

key 必選，鍵名。

defaultValue 可選，若鍵值不存在的返回值。

返回

value {Mixed} 保存在本地存儲空間中的值。

T.localStorage.get("foo", "bar"); // 若foo對應的鍵值不存在，則返回bar

 

T.localStorage.remove

描述

Object T.localStorage.remove(String key)

T.localStorage.remove刪除本地存儲，釋放本地存儲空間。

參數

key 必選，鍵名。

返回

true或false，表示刪除是否成功

T.localStorage.remove("foo");

 

 

6.openjs.js 還帶了相似jQuery 的插件功能，基本上包含經常使用的方法。按我的習慣能夠選擇使用。