腾讯微博 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 的插件功能，基本上包含常用的方法。按个人习惯可以选择使用。