aliTradePlus

来自于：开发者

Method

initSDK showLogin logout showItemDetailPage showPage showCartsPage addItem2Cart showMyOrders showShopPage

论坛示例

为帮助用户更好更快的使用模块，论坛维护了一个示例，示例中包含示例代码供您参考。

概述

该模块已停止维护，请使用该模块的优化版alibcTrade模块。aliTradePlus是aliTrade的升级版，封装了阿里百川电商sdk，能够使你的app快速集成淘宝的电商功能，包括授权登录，查看商品详情，查看店铺，查看我的订单，查看购物车和商品支付等整个交易闭环，使用本模块需要遵从阿里百川的申请流程，需要登录阿里百川，进入控制台，创建应用并获取sdk的安全图片，此外该模块需要和 aliTradeAppendix（该模块为自定义模块）模块绑定使用. 注意:本次更新了3.1.1.205的SDK，在使用时请重新下载最新的安全图片，因为我使用SDK的版本原因，选择图片版本的时候请使用V4版安全图片，否则会造成API未授权的情况

阿里百川电商SDK

向开发者提供标准化的商品、交易、支付组件，配合相应的数据服务，应用内建造商城不再困难。

打开手机淘宝，直接同步手机淘宝登录状态，用户无需再次输入账号密码，登录转化率提升2倍。

应用可以直接呼起手机淘宝，用户在手机淘宝内完成交易流程，成交提升3-5倍。

支持App与手机淘宝间互相跳转，用户可通过"Tip"随时从手机淘宝快速返回App。

客户案例

什么值得买、优酷、新浪微博、今日头条、小米生活、美柚、果库、她社区、小恩爱、半塘、爱豆、礼物说、虎扑识货、中华万年历、抢货、疯狂造人、高德地图、路口、毒物、惠喵、优衣库

基本流程

在阿里百川控制台创建应用获取appkey：
在阿里百川控制台“API申请”中申请相应的API权限：
在阿里百川控制台"我的产品后台"中开通新版百川电商sdk：
生成安全图片：(android 需要上传apk，即为自己要发布的应用，iOS只需要填写 bundleId：可在apicloud控制台概览里查看)
配置 Android 自定义模块 aliTradeAppendix：

首先下载 aliTradeAppendix 模块，将其解压并将Android的安全图片 yw_1222.jpg 放到文件夹 aliTradeAppendix\res_aliTradeAppendix\res\drawable 下，重新打包成zip，即可作为自定义模块使用
配置 iOS 自定义模块 aliTradeAppendix：

首先下载 aliTradeAppendix 模块，将其解压并将iOS的安全图片 yw_1222.jpg 放到 aliTradeAppendix/target 目录下，重新打包成zip，即可作为自定义模块使用

使用此模块之前需先配置 config.xml 文件，配置完毕，需通过云端编译生效，配置方法如下：

名称：aliTradePlus
参数：urlScheme, querySchemes
参数说明：
- urlScheme参数用于处理应用间的跳转，值为tbopen+appkey, appkey是在阿里百川上申请的appkey.
- querySchemes参数用于配置可被检测的URL Scheme,多个参数用逗号隔开，本模块需添加tbopen,tmall两个参数.
配置示例：

 <preference name="urlScheme" value="tbopen23442471"/>
 <preference name="querySchemes" value="tbopen,tmall"/>

initSDK

初始化SDK（调用优先级最高，只需要调用一次）

initSDK({params},callback(ret))

params

isVVersion：

类型：字符串
描述：(可选)设置App版本,可用于标识App版本,服务器若不做处理，可不传

isVCode:

类型：（可选）字符串
描述：(可选)设置App标识字段,和isvcode同义,可用于区分使用本SDK的具体App,服务器若不做处理，可不传

callback(ret, err)

ret:

类型：JSON对象
描述：返回值

{
    status : true // 布尔类型；是否初始化成功
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.initSDK({
   isVVersion: '',
   isVCode: ''
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showLogin

授权登录

showLogin(callback(ret))

callback(ret)

ret:

类型：JSON对象
描述：返回值

{
   isLogin : true,          //是否授权登录成功
    nick : '',               //昵称
    avatarUrl : '',          //头像地址
    openId : '',             //用户标识
    openSid : ''             //用户标识
    topAccessToken:''        //仅iOS有此返回值
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.showLogin(function(ret, err){
       if (ret) {
           alert(JSON.stringify(ret));
       }else {
            alert(JSON.stringify(err));
       }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

logout

注销

logout(callback(ret))

callback(ret)

ret:

类型：JSON对象
描述：返回值

{
    status:true  // 布尔类型；返回登录状态
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.logout(function(ret, err){
        alert(JSON.stringify(ret));
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showItemDetailPage

显示商品详情

showItemDetailPage({params},callback(ret))

params

itemId：

类型：字符串
描述：商品id

taokePid:

类型：（可选）字符串
描述：淘客 pid （需登录阿里妈妈，实名认证后可获取 pid）

openType:

类型：（可选）字符串
描述：打开页面的方式：拉起手淘和h5打开页面，默认值：auto
可选范围
- auto //智能判断
- native //手机淘宝
- h5 // h5

callback(ret)

ret:

类型：JSON对象
描述：返回值

{
    status:true  // 布尔类型；返回交易状态
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.showItemDetailPage({
    itemId: '41576306115',
    taokePid: '',
    openType: 'auto'
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showPage

用url打开商品页面

showPage({params},callback(ret))

params

url：

类型：字符串
描述：页面url地址

taokePid:

类型：（可选）字符串
描述：淘客 pid （需登录阿里妈妈，实名认证后可获取 pid）

openType:

类型：（可选）字符串
描述：打开页面的方式：拉起手淘和h5打开页面，默认值：auto
可选范围
- auto //智能判断
- native //手机淘宝
- h5 // h5

callback(ret)

ret:

类型：JSON对象
描述：返回值，如果openType为h5，且交易成功，则有返回值


{
     status:true,                 // 布尔类型；返回交易状态
     orderResultList:[]           // 数组类型；订单编号
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.showPage({
    url : '',
    taokePid: '',
    openType: 'auto'
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showCartsPage

打开购物车

showCartsPage(callback(ret))

params

taokePid:

类型：（可选）字符串
描述：淘客 pid （需登录阿里妈妈，实名认证后可获取 pid）

openType:

类型：（可选）字符串
描述：打开页面的方式：拉起手淘和h5打开页面，默认值：auto
可选范围
- auto //智能判断
- native //手机淘宝
- h5 // h5

callback(ret)

ret:

类型：JSON对象
描述：返回值

{
    status:true  // 布尔类型；返回交易状态
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.showCartsPage({
    taokePid: '',
    openType: 'auto'
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

addItem2Cart

添加商品到购物车

addItem2Cart({params},callback(ret))

params

itemId：

类型：字符串
描述：商品id

taokePid:

类型：（可选）字符串
描述：淘客 pid （需登录阿里妈妈，实名认证后可获取 pid）

openType:

类型：（可选）字符串
描述：打开页面的方式,默认值：auto
可选范围
- auto //智能判断
- native //手机淘宝
- h5 // h5

callback(ret)

ret:

类型：JSON对象
描述：返回值

{
    status:true  // 布尔类型；返回交易状态
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.addItem2Cart({
     itemId: '',
    taokePid: '',
    openType: 'auto'
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

iOS系统，Android系统

可提供的1.0.0及更高版本

showMyOrders

打开我的订单

showMyOrders({parmas})

params

isAllOrder:

类型：布尔
描述：（可选）是否显示全部订单
默认值： true

orderType:

类型：数字
描述：（可选）订单类型
默认值： 0
取值范围：
- 0 (全部订单)
- 1 (待付款订单)
- 2 (待发货订单)
- 3 (待收货订单)
- 4 (待评价订单)

taokePid:

类型：（可选）字符串
描述：淘客 pid （需登录阿里妈妈，实名认证后可获取 pid）

openType:

类型：（可选）字符串
描述：打开页面的方式：拉起手淘和h5打开页面，默认值：auto，
可选范围
- auto //智能判断
- native //手机淘宝
- h5 // h5

callback(ret)

ret:

类型：JSON对象
描述：返回值,如果openType为h5，且交易成功，则有返回值

{
    status:true ,                // 布尔类型；返回交易状态
    orderResultList:[]           // 数组类型；订单编号
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.showMyOrders({
    orderType: 0,
    isAllOrder: true,
    taokePid: '',
    openType: 'auto' 
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

Android系统, iOS系統

可提供的1.0.0及更高版本

showShopPage

打开店铺

showShopPage(param, callback(ret, err))

params

shopId：

类型：字符
描述：店铺id

taokePid:

类型：（可选）字符串
描述：淘客 pid （需登录阿里妈妈，实名认证后可获取 pid）

openType:

类型：（可选）字符串
描述：打开页面的方式：拉起手淘和h5打开页面，默认值：auto
可选范围
- auto //智能判断
- native //手机淘宝
- h5 // h5

callback(ret)

ret:

类型：JSON对象
描述：返回值

{
    status:true  // 布尔类型；返回交易状态
}

err:

类型：JSON对象
描述：返回值

{
    code:0,      // 数字类型；错误码
    msg:''       // 字符串；错误提示信息
}

示例代码

var aliTradePlus = api.require('aliTradePlus');
aliTradePlus.showShopPage({
    shopId: '60552065',
    taokePid: '',
    openType: 'auto' 
},function(ret, err){
    if(ret.status){
        alert(JSON.stringify(ret));
    } else {
        alert(JSON.stringify(err));
    }
});

可用性

Android系统, iOS系統

可提供的1.0.0及更高版本

APICloud

模块开发

端API

设备访问

功能扩展

界面布局

导航菜单

开放SDK

云服务对接

AVM多端模块

H5模块

前端框架

云API

技术专题

开发工具

下载

微信公众号适配

七天培训课教程

其他

Faq

开放平台接入指南

自定义加速域名

云主机

入门教程

部署与管理

常见FAQ

MTL.js

aliTradePlus

论坛示例

概述

阿里百川电商SDK

客户案例

基本流程

initSDK

params

callback(ret, err)

示例代码

可用性

showLogin

callback(ret)

示例代码

可用性

logout

callback(ret)

示例代码

可用性

showItemDetailPage

params

callback(ret)

示例代码

可用性

showPage

params

callback(ret)

示例代码

可用性

showCartsPage

params

callback(ret)

示例代码

可用性

addItem2Cart

params

callback(ret)

示例代码

可用性

showMyOrders

params

callback(ret)

示例代码

可用性

showShopPage

params

callback(ret)

示例代码

可用性