腾讯微博 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接口,存取微博数据。调试接口

描述

1
2
<span style=‘font-family: "courier new", courier;‘>Object T.api(String apiName [,Object apiParams [,String dataType [,String type]]])
</span>

参数: 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 的插件功能,基本上包含常用的方法。按个人习惯可以选择使用。

郑重声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。