alibaic

立即使用

Method

论坛示例

为帮助用户更好更快的使用模块,论坛维护了一个示例,示例中包含示例代码、知识点讲解、注意事项等,供您参考。

概述

alibaic模块 封装了阿里百川电商sdk(4.0.0.8),能够使你的app快速集成淘宝的电商功能,包括授权登录,查看商品详情,查看店铺,查看我的订单,查看购物车和商品支付等整个交易闭,使你能够更随心的定义自己的界面,支持用H5实现“APP内交易闭环”或拉起手机淘宝实现“外呼手淘交易闭环”,详情请查看淘宝公告 。使用此模块,需要登录阿里百川,进入控制台,创建应用并获取sdk的安全图片。

模块概述

封装了阿里百川电商sdk,快速集成淘宝的电商功能

准备事项

一,创建应用并获取AppKey Image text 二,申请API权限: Image text 三,开通百川电商sdk: Image text 四,生成安全图片(使用V5版安全图片): Image text

五,配置 自定义模块 alibaicKey:

首先下载 alibaicKey模块 alibaicKey.zip ) ,将安全图片 yw_1222.jpg 更换,重新打包成zip,即可作为自定义模块使用

六,开通阿里妈妈 1、开通阿里妈妈会员,获取淘客PID(返利用),打开阿里妈妈传送门,显示以下界面则说明开通成功 Image text 2、需要人工审,一般1-2个工作日

七,加入淘宝联盟

1、用于查看收益,并把收益转入支付宝,点此加入淘宝联盟

2、需要人工审核,一般1-2个工作日

八,配置 config.xml 文件:(tbopen + AppKey)

 <preference name="querySchemes" value="tbopen,tmall"/>
  <feature name="alibaic">
    <param name="urlScheme" value="tbopen234155822"/>
  </feature>

注意

本模块可以与aliPayTradePlus模块同时使用 不能与aliPayTrade同时使用

模块接口

addEventListener

-设置监听后可以添加api事件监听来获取相关信息:

  alibaic.addEventListener(function(ret) {
                  var code = ret.code;
                  //code=0 交易成功 1 加购成功 -1 失败  paySuccessOrders 成功订单  payFailedOrders 失败订单
                   alert(JSON.stringify(ret))
        });

`

可用性

Android,ios系统

可提供的1.0.7

init

初始化SDK(优先级最高,只调用一次)

-设置监听后可以添加api事件监听来获取相关信息:

 alibaic.init(function(ret, err) {
                if (ret.code == 0) {
                      //0成功
                      alert(ret.text);
                } else {
                      alert(ret.text);
                }
      });

可用性

Android,ios系统

可提供的1.0.7

login

授权登录

var alibaic = api.require('alibaic');
alibaic.login(function(ret){
    if(ret.code==0){
        alert(JSON.stringify(ret));
    }

});

可用性

Android,ios系统

可提供的1.0.7

logout

注销

var alibaic = api.require('alibaic');
alibaic.logout(function(ret){
    if(ret.code==0){
        alert(JSON.stringify(ret));
    }else{
        alert(JSON.stringify(ret));
    }
});

可用性

Android,ios系统

可提供的1.0.7

getUser

获取用户信息

ret:

-类型:JSON对象

-描述:返回值

-内部字段:

{

    code: 0|-1,             //数值型,0成功 -1失败
    isLogin : true,         //是否授权登录了淘宝
    nick : '',              //昵称
    avatarUrl : '',         //头像地址
    openId : '',            //用户标识
    openSid : '',           //用户标识
    userid : '',            //仅android有此返回值
    topExpireTime : '',     //仅android有此返回值
    topAccessToken:''       //仅iOS有此返回值 
    topAuthCode : ''        //仅iOS有此返回值

}

示例代码

var alibaic = api.require('alibaic');
alibaic.getUser(function(ret){
    if(ret.code==0){
        alert(JSON.stringify(ret));
    }else{
        alert(JSON.stringify(err));
    }
});

可用性

Android,ios系统

可提供的1.0.7

setConfig

设置常用配置项

alibaic.setConfig({
            isvVersion:'',//设置三方App版本,可用于标识App版本
            isvAppName:'',//设置三方App名字,可用于标识App名字(仅iOS有效)
            isvCode:'',//设置App标识字段,可用于区分使用本SDK的具体三方App
            isForTaoke: false,//设置SDK 淘客打点策略(sdk默认采用淘客同步打点)
            isAuthVip: false,//开启接口免授权模式:请不要随便设置,没有在后台申请相关的权限的,开启后会导致网络请求失败
            isAlizfNative: false//设置是否需要 Native AliZf 接口
      }, function(ret, err) {
            alert(JSON.stringify(ret));
    });

可用性

Android,ios系统

可提供的1.0.7

setChannel

设置渠道信息(如果有渠道专享价,需要设置)

var alibaic = api.require('alibaic');
alibaic.setChannel({
          typeName:'0',//设置渠道类型
          channelName:'developer'//设置渠道名称
         });

可用性

Android,ios系统

可提供的1.0.7

openPageByBizCode

bizCode方式打开百川页面

alibaic.openPageByBizCode({
                        bizCode: 'detail',// detail 商品页   shop 店铺页  cart 购物车
                        itemId: '575688730394',//商品id 当 bizCode:detail有效
                        shopId:'',//店铺id 当 bizCode:shop有效
                        showParam:{
                                    pageClose:true,//android H5页面有效  购买商品支付成功后是否关闭淘宝页面
                                    showTitleBar:true,//android有效
                                    proxyWebview:true,//android有效
                                    backUrl:'',//android有效  用于打开手淘时的 “返回(小把手)” 的点击返回,目前ios传空字符串,android传config.xml文件中配置的urlScheme(即tbopen+appkey)
                                    isNeedPush:true,//ios有效
                                    openType:0,//0 Auto 1 Native 打开页面的方式:拉起手淘/天猫 和 h5打开页面,默认值:h5
                                    nativeFailMode:0,// AlibcNativeFailModeJumpH5 = 0 AlibcNativeFailModeJumpDownloadPage = 1  AlibcNativeFailModeNone = 2
                                    isNeedCustomNativeFailMode:false,//ios有效
                                    linkKey:'taobao',//taobao tmail  当打开页面的方式
                                    degradeUrl:''//降级url,如果唤端失败且设置了降级url
                                   },
                         taokeParam:{
                                     pid: 'mm_17791462_59700500_97877400088',//淘客pid
                                     subPid:'',// 可选项
                                     unionId:'',// 可选项
                                     adzoneId:'',//淘宝联盟adzoneId。高佣转链/跨店结算 功能所需
                                     extParams:{
                                          taokeAppkey: "", //淘宝联盟后台的APPKEY字段
                                          sellerId: ""     //bizCode为 shop  必传
                                      }
                                },
                          customParam:{}//(可选项)自定义参数
                 }, function(ret, err) {
                         alert(JSON.stringify(ret));
       });

可用性

Android,ios系统

可提供的1.0.7

openPageByBizCodeWeb

嵌入式bizCode方式打开百川页面

alibaic.openPageByBizCode({
                        rect:{x:0, y:0,w:'auto', h:'auto'},
                        fixedOn:api.frameName,
                        fixed:true,
                        bizCode: 'detail',// detail 商品页   shop 店铺页  cart 购物车
                        itemId: '575688730394',//商品id 当 bizCode:detail有效
                        shopId:'',//店铺id 当 bizCode:shop有效
                        showParam:{
                                    pageClose:true,//android H5页面有效  购买商品支付成功后是否关闭淘宝页面
                                    showTitleBar:true,//android有效
                                    proxyWebview:true,//android有效
                                    backUrl:'',//android有效  用于打开手淘时的 “返回(小把手)” 的点击返回,目前ios传空字符串,android传config.xml文件中配置的urlScheme(即tbopen+appkey)
                                    isNeedPush:true,//ios有效
                                    openType:0,//0 Auto 1 Native 打开页面的方式:拉起手淘/天猫 和 h5打开页面,默认值:h5
                                    nativeFailMode:0,// AlibcNativeFailModeJumpH5 = 0 AlibcNativeFailModeJumpDownloadPage = 1  AlibcNativeFailModeNone = 2
                                    isNeedCustomNativeFailMode:false,//ios有效
                                    linkKey:'taobao',//taobao tmail  当打开页面的方式
                                    degradeUrl:''//降级url,如果唤端失败且设置了降级url
                                   },
                         taokeParam:{
                                     pid: 'mm_17791462_59700500_97877400088',//淘客pid
                                     subPid:'',// 可选项
                                     unionId:'',// 可选项
                                     adzoneId:'',//淘宝联盟adzoneId。高佣转链/跨店结算 功能所需
                                     extParams:{
                                          taokeAppkey: "", //淘宝联盟后台的APPKEY字段
                                          sellerId: ""     //bizCode为 shop  必传
                                      }
                                },
                          customParam:{}//(可选项)自定义参数
                 }, function(ret, err) {
                         alert(JSON.stringify(ret));
       });

可用性

Android,ios系统

可提供的1.0.7

openPageByUrl

url方式打开百川页面

alibaic.openPageByUrl({
                        url: '',
                        showParam:{
                                    pageClose:true,//android H5页面有效  购买商品支付成功后是否关闭淘宝页面
                                    showTitleBar:true,//android有效
                                    proxyWebview:true,//android有效
                                    backUrl:'',//android有效  用于打开手淘时的 “返回(小把手)” 的点击返回,目前ios传空字符串,android传config.xml文件中配置的urlScheme(即tbopen+appkey)
                                    isNeedPush:true,//ios有效
                                    openType:0,//0 Auto 1 Native 打开页面的方式:拉起手淘/天猫 和 h5打开页面,默认值:h5
                                    nativeFailMode:0,// AlibcNativeFailModeJumpH5 = 0 AlibcNativeFailModeJumpDownloadPage = 1  AlibcNativeFailModeNone = 2
                                    isNeedCustomNativeFailMode:false,//ios有效
                                    linkKey:'taobao',//taobao tmail  当打开页面的方式
                                    degradeUrl:''//降级url,如果唤端失败且设置了降级url
                                   },
                         taokeParam:{
                                     pid: 'mm_17791462_59700500_97877400088',//淘客pid
                                     subPid:'',// 可选项
                                     unionId:'',// 可选项
                                     adzoneId:'',//淘宝联盟adzoneId。高佣转链/跨店结算 功能所需
                                     extParams:{
                                          taokeAppkey: "", //淘宝联盟后台的APPKEY字段
                                          sellerId: ""     //bizCode为 shop  必传
                                      }
                                },
                          customParam:{}//(可选项)自定义参数
                 }, function(ret, err) {
                         alert(JSON.stringify(ret));
       });

可用性

Android,ios系统

可提供的1.0.7

openPageByUrlWeb

嵌入式url方式打开百川页面

alibaic.openPageByUrlWeb({
                        rect:{x:0, y:0,w:'auto', h:'auto'},
                        fixedOn:api.frameName,
                        fixed:true,
                        url: '',
                        showParam:{
                                    pageClose:true,//android H5页面有效  购买商品支付成功后是否关闭淘宝页面
                                    showTitleBar:true,//android有效
                                    proxyWebview:true,//android有效
                                    backUrl:'',//android有效  用于打开手淘时的 “返回(小把手)” 的点击返回,目前ios传空字符串,android传config.xml文件中配置的urlScheme(即tbopen+appkey)
                                    isNeedPush:true,//ios有效
                                    openType:0,//0 Auto 1 Native 打开页面的方式:拉起手淘/天猫 和 h5打开页面,默认值:h5
                                    nativeFailMode:0,// AlibcNativeFailModeJumpH5 = 0 AlibcNativeFailModeJumpDownloadPage = 1  AlibcNativeFailModeNone = 2
                                    isNeedCustomNativeFailMode:false,//ios有效
                                    linkKey:'taobao',//taobao tmail  当打开页面的方式
                                    degradeUrl:''//降级url,如果唤端失败且设置了降级url
                                   },
                         taokeParam:{
                                     pid: 'mm_17791462_59700500_97877400088',//淘客pid
                                     subPid:'',// 可选项
                                     unionId:'',// 可选项
                                     adzoneId:'',//淘宝联盟adzoneId。高佣转链/跨店结算 功能所需
                                     extParams:{
                                          taokeAppkey: "", //淘宝联盟后台的APPKEY字段
                                          sellerId: ""     //bizCode为 shop  必传
                                      }
                                },
                          customParam:{}//(可选项)自定义参数
                 }, function(ret, err) {
                         alert(JSON.stringify(ret));
       });

可用性

Android,ios系统

可提供的1.0.7

removeWeb

从视图中移除当前通过xxxWeb打开的百川页面。

removeWeb()

示例代码

var alibaic = api.require('alibaic');
alibaic.removeWeb();

可用性

Android,ios系统

可提供的1.0.7