1 接入流程

优质
小牛编辑
137浏览
2023-12-01

1.在EWS中创建前台应用

其中最新版本号需要跟随变更

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

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

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

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

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

/**
 * module支持的模块有:
 *
 * draw:抽奖 (这个模块中的查看奖品接口依赖widget模块)
 * sensor:传感器
 * buy:交易
 * device:基础设备接口
 * media:多媒体相关
 * social:粉丝传播类
 * widget:界面操作类接口
 * im: 旺旺
 * server:调用服务端网关接口
 * share:分享
 * award:淘金币、支付宝红包
 * prize: 每日宝箱
 * calendar: 日历
 */
Tida.ready({
    // interactId:"", // 互动实列ID type string 若无抽奖模块,此参数无须传入。给错误的实例ID会走错误流程
    // module: [] // 应用所需要的模块。非必选,默认加载所有模块。支持的模块见注释。
    // sellerNick:"" // 商家名称 
    // shopId:123 // 店铺ID 从url中取 可选
}, 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
}