无线开放 API

接入流程

1.在TAE中创建前台应用

TAE容器会自动在每个页面里面加上TidaSDK最新版本,包括所需要的最新UI的css文件。 若本地调试,可以自行引入。其中最新版本号需要跟随变更

<script src="//g.alicdn.com/tmapp/tida2/2.0.40/tida.js?appkey=应用的前台appkey"></script>

用天猫/淘宝客户端可以查看demo

部分demo还不完善,敬请期待

2.调用Tida.ready(config, callback)接口,传入必要参数进行初始化工作

所有的接口调用前必须首先调用ready方法进行必要的初始化工作。

/**
 * module支持的模块有:
 *
 * draw:抽奖
 * sensor:传感器
 * buy:交易
 * device:基础设备接口
 * media:多媒体相关
 * social:社交相关
 * widget:客户端UI
 * im: 旺旺
 * server:调用服务端网关接口
 * share:分享
 * award:淘金币、支付宝红包
 */
Tida.ready({
    //interactId:"", // 互动实列ID type string 若无抽奖模块,此参数无须传入。给错误的实例ID会走错误流程
    //module: [] // 应用所需要的模块。非必选,默认加载所有模块。支持的模块见注释。
}, function(){
    // TODO
})

这样就完了?有木有?请继续往下看

3. 请求客户端对应用授权

取得用户同意后,部分需要开通权限的接口才能使用。若仍有部分接口不能使用,请检查自己应用权限包是否包含接口

/**
* @param options 参数,支持boolean型 function 或object 或者不传第1个参数 直接为function表示不强制授权
* @param [options.refresh=false] 是否重新授权 true: 即使已经有授权,会清掉之前的授权信息重启授权流程, false:授权有效直接返回授权成功
*/
Tida.doAuth(options,function(data){
    if(data.finish){
        // 授权成功 可以顺利调用需要授权的接口了
    }else {
        // 未能成功授权
    }
});

// 另一种调用
Tida.doAuth(function(data){
    if(data.finish){
        // 授权成功 可以顺利调用需要授权的接口了
    }else {
        // 未能成功授权
    }
});

// 强制授权 每次都会弹出授权框
Tida.doAuth(true, function(data){
    if(data.finish){
        // 授权成功 可以顺利调用需要授权的接口了
    }else {
        // 未能成功授权
    }
});

data 格式:

{
    errorCode: 0, //通用错误码
    errorMessage: "用户已授权",
    finish: true //true为授权成功 false授权失败 授权失败请参考data.errorCode
}