淘宝百川
init showItemDetailPage getUserInfo showShopPage showMyCar is_instll 百川申请教程 注意事项
概述
百川模块接入了阿里百川的基础功能:手淘授权登陆、打开我的订单、打开宝贝详情,和通过网址打开内部优惠券,唤醒手淘,高佣转链,跨店结算等功能。支持最新(唤醒手淘/高佣转链/跨店结算)功能,可以直接进行动态高佣转链,无须服务端的转链。
使用此模块之前建议先配置 config.xml 文件,配置完毕,需通过云端编译生效,配置方法如下:
- 名称:baichuan
- 参数:urlScheme
- 配置示例:
<param name="urlScheme" value="tbopen12345678" />
</feature>
字段描述:
urlScheme:(必须配置) 用于实现应用间跳转及数据交换,本应用可以启动手淘客户端,也可以从手淘客户端跳回本应用。urlScheme 的 value 值的后面12345678是从百川开放平台获取的appkey(申请或获取教程查看底部的 百川申请教程),需要将12345678替换成你自己的appkey。
<preference name="querySchemes" value="tmall,tbopen,taobao" />
接口描述
init
初始化百川,所有的接口,必须在这个正常初始化完成才能使用.只有初始化成功.其它接口才能正常工作.这个init一般会放在主页中,网络连接后就执行一次,整款APP只需执行一次即可.(强烈建议在网络连接成功后再执行初始化,因为IOS端首次安装完成启动,会询问用户是否允许网络连接,如果在未点允许前初始化百川可能会导致百川授权登录提示网络不通或其它情况)
init({params},callback(ret, err))
pid:
- 类型:字符串
- 描述:联盟的PID,走高佣需要用到这个
- 例 : mm_111222_333333_44444
taokeyAppkey: (可选)
- 类型:字符串
- 描述:联盟的的appkey,不能填写百川的appkey,必须是和pid对应一个网址下的.(在阿里妈妈申请一个网址备案,会得到一个appkey,具体查看页面底部的 高佣申请教程处理有获取说明 ) 一般不建议填写,因为多数都是在服务器端进行了高佣转链,旧版本测试发现会被百川二次转链,具体请自行测试
backUrl: (可选)
- 类型:字符串
- 描述:作用是返回到当前APP(打开淘宝APP后会显示返回的小把手,点击后就跳转到此处设置的APP),一般是设置成config.xml中的urlScheme(IOS端测试时发现传了后返回不了APP,安卓端不传会默认读取config.xml中baichuan下面的urlScheme) 建议不填此项
- 默认值: 无
- 例: tbopen12345678:// (tbopen+当前百川的appkey)
failMode: (可选)
- 类型:整数
- 描述:唤醒淘宝APP失败的处理方法
- 可选值:
- 0=跳转到H5页面
- 1=不做任何操作
- 2=跳转到下载淘宝APP的页面
- 3=跳转到浏览器打开(ios没有)
- 默认: 0
callback(ret, err)
ret:
- 类型:JSON对象
- 说明:如果code=0则为成功 其它全是失败
- 内部字段:
{
msg:'百川初始化成功',
code:0
}
//全局初始化一次即可(建议在网络连接后再进行初始化)
err:
- 类型:JSON对象
- 内部字段:
{
msg:错误信息,
code:-1
}
var params = {pid:'mm_111111_222222_3333',taokeyAppkey:'123456',backUrl:'tbopen27891410',failMode:0,}
api.require('baichuan').init(params,function(ret){
alert(JSON.stringify(ret));
});
var params = {pid:'mm_111111_222222_3333'}
api.require('baichuan').init(params,function(ret){
});
iOS系统,Android系统 可提供的1.0.0及更高版本
showUrlPage
通过url打开商品详情页 showUrlPage({params}, callback(ret, err))
params
url:
- 类型:字符串
- 描述:商品的链接地址如
pid: 可选
- 类型:字符串
- 描述:联盟的pid
- 例:mm_13204895_6578426_109195400466 一般不用填写
code: 可选(安卓端有效)
- 类型:字符串
- 描述:官方说是套件名称,留着备用,一般不传此字段即可,可以看看百川官方说明 https://baichuan.taobao.com/docs/doc.htm?treeId=129&articleId=118174&docType=1
callback(ret, err)
ret:
- 类型:JSON对象
内部字段:
{
type:"pay_success", //购物成功是pay_success ,加入购物车成功是add2car
orders:"5570976264118545541,5570976264118545541", //orders是个字符串,多个订单号是用豆号格开的
code:0, //为0就代表操作成功
"msg":"购物成功5570976264118545541" //成功或失败消息
}
//有可能这里的callback也不会执行,具体请自行测试
err:
- 类型:JSON对象
- 内部字段:
{
code: -1 //数字类型
msg: "商品url不能为空" //错误描述
}
示例代码
var baichuan= api.require('baichuan');
baichuan.showUrlPage({url:"https://s.click.taobao.com/MSdFZbw"},function(ret){
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
showItemDetailPage
通过商品id打开淘宝详情页
showItemDetailPage({params}, callback(ret, err))
params
itemid:
- 类型:数字
- 描述:淘宝的商品itemid
pid: 可选
- 类型:字符串
- 描述:联盟的pid
- 例:mm_13204895_6578426_109195400466
- 如果在init时没传这里需要传一个,这里填写后会临时覆盖全局的
callback(ret, err)
ret:
- 类型:JSON对象
- 内部字段:
{
type:"pay_success", //购物成功是pay_success ,加入购物车成功是add2car
orders:"5570976264118545541", //orders是个字符串,多个订单号是用豆号格开的
code:0, //为0就代表操作成功
"msg":"购物成功5570976264118545541" //成功或失败消息
}
//这里的回调可能不会执行,具体需自行测试
err:
- 类型:JSON对象
- 内部字段:
示例代码
var baichuan= api.require('baichuan');
baichuan.showItemDetailPage({itemid:"557642364230"},function(ret){
alert(JSON.stringify(ret));
});
//这里的回调可能不会执行,具体需自行测试
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
showLogin
显示百川授权登录页面,成功后回调用户信息
showLogin(callback(ret, err))
callback(ret, err)
- 类型:JSON对象
- 内部字段:
{
nick:"张三", //用户的淘宝昵称
openid:"AAGLZP1a58d4a6A", //用户的唯一openid(不是token,官方不提供token)
code:0, //成功为0,失败为百川原始code
msg:"登录成功" //登录成功提示
//附加信息,正常是不提供, 免费增送的
topAccessToken:"6300010abb4d5ea2899389afb1f66ccd9564128ecec76a81905489005",
topAuthCode:"QxOATw3E8Dtsd0dx2pxgT1vY6839908",
topExpireTime:"7776000",//ios端没有
userid:"1905489033",//ios端没有
openSid:"0d752ca1ad9cff0a7f0c80ee60840f679b481d73dce54545996142889ae9f98d705024826837276dc351f30c9cb006d8" //ios端没有
}
err:
- 类型:JSON对象
- 内部字段:
{
code: 112 //数字类型,
msg:"登录失败"
}
示例代码
var baichuan= api.require('baichuan');
baichuan.showLogin({
openType: 2,
}, function(ret, err){
alert(JSON.stringify(ret));
});
iOS系统,Android系统 可提供的1.0.0及更高版本
getUserInfo
获取用户信息
getUserInfo(callback(ret, err))
callback(ret, err)
ret:
- 类型:JSON对象
- 内部字段:
{
nick:"张三", //用户的淘宝昵称
openid:"AAGLZP1a58d4a6A", //用户的唯一openid
avatarUrl:https://gw.alicdn.com/tps/i3/123456.jpg //用户的头像地址
code:0, //成功为0,失败为百川原始code
msg:"获取成功", //登录成功或失败的提示
//附加信息,正常是不提供, 免费增送的
topAccessToken:"6300010abb4d5ea2899389afb1f66ccd9564128ecec76a81905489005",
topAuthCode:"QxOATw3E8Dtsd0dx2pxgT1vY6839908",
topExpireTime:"7776000",//ios端没有
userid:"1905489033",//ios端没有
openSid:"0d752ca1ad9cff0a7f0c80ee60840f679b481d73dce54545996142889ae9f98d705024826837276dc351f30c9cb006d8" //ios端没有
}
err:
- 类型:JSON对象
- 内部字段:
{
code: 112 //数字类型,
msg:"获取用户信息失败"
}
示例代码
var baichuan= api.require('baichuan');
baichuan.getUserInfo(function(ret, err){
});
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
logout
退出登录
logout(callback(ret, err))
callback(ret, err)
ret:
- 类型:JSON对象
- 内部字段:
{
code:0, //成功为0,失败为百川原始code
msg:"退出成功" //退出提示
}
err:
- 无
示例代码
var baichuan= api.require('baichuan');
baichuan.logout(function(ret, err){
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
showShopPage
打开店铺
showShopPage({params}, callback(ret, err))
params
shopid:必填
- 类型:数字
- 描述:淘宝店铺的ID 如162511891
callback(ret, err)
ret:
- 类型:JSON对象
- 内部字段:
err:
- 无
示例代码
var baichuan= api.require('baichuan');
baichuan.showShopPage({shopid:"1333311"},function(ret){
alert(JSON.stringify(ret));
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
showMyOrders
打开我的订单页面
showMyOrders({params}, callback(ret, err))
params
type:必填
- 类型:int
- 描述:显示订单的类型 一般为0即可
- 可选项 : 0:全部;1:待付款;2:待发货;3:待收货;4:待评价
all: 必填
- 类型:boolean
- 描述: 是否显示全部订单 一般为true即可
ret:
- 类型:JSON对象
- 内部字段:
{
type:"pay_success", //购物成功是pay_success ,加入购物车成功是add2car
orders:"5570976264118545541", //orders是个字符串,多个订单号是用豆号格开的
code:0, //为0就代表操作成功
"msg":"打开成功" //成功或失败消息
}
//这里的回调可能不会执行,具体需自行测试
err:
- 无
示例代码
var baichuan= api.require('baichuan');
baichuan.showMyOrders({type:0,all:true},function(ret, err){
alert(JSON.stringify(ret));
});
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
showMyCar
显示我的购物车 (测试发现有时购物车是空的,明明有加了商品,属于百川或淘宝问题)
showMyCar( callback(ret, err))
示例代码
var baichuan= api.require('baichuan');
baichuan.showMyCar();
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
getCookies
获取某网站的cookie(附增功能,如果想调用淘宝任意数据,可以自己拿cookie然后破解吧)
getCookies({params}, callback(ret, err))
params
url:
- 类型:字符串
- 描述:获取某网站的cookie
- 例 :
callback(ret, err)
ret:
- 类型:JSON对象
- 内部字段:
{
data:[
{
name:'abc',
value:'123',
},
{
name:'ccc',
value:'4444555',
}
],
code:0, //为0就代表操作成功
"msg":"打开成功" //成功或失败消息
}
//这里的回调可能不会执行,具体需自行测试
- 无
示例代码
var baichuan= api.require('baichuan');
baichuan.getCookies({url:'https://taobao.com'},function(rs){
alert(JSON.stringify(rs));
});
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
is_instll
淘宝app是否已安装(同步方法,直接返回)
is_instll()
示例代码
var baichuan= api.require('baichuan');
var ist = baichuan.is_instll();
//true || false
alert(ist);
可用性
iOS系统,Android系统 可提供的1.0.0及更高版本
私域授权说明
授权直接用showUrlPage打开页面即可
示例代码
var redirect_uri = encodeURIComponent('https://api.zhetaoke.com:10001/api/open_taokeshouquan_return.ashx?appkey=12345678910');
var url ='https://oauth.taobao.com/authorize?response_type=code&client_id=25635011&view=wap&redirect_uri='+redirect_uri
baichuan.showUrlPage({ url: url});
给需要返利APP用户一些提示:
redirect_uri 为返回到你网站的某一个页面,最好不要带参数&符号.可能解析失败,我这边是用折淘客的来授权,然后服务器调用订单查询,然后返利.(appkey是折淘客那边获取)
client_id参数为你的联盟appkey
一些个人经验分享
返利的话必须要先在联盟申请淘客私域权限,否则是无法获取订单信息的.
做私域授权,需要授权两次,1是百川授权登录,2再进行私域授权,
以前在百川3.x.x的时候这个授权被淘客玩乱了,为了只授权一次,用户将第2次的授权页面隐藏掉,或是注入JS模拟点击 淘宝授权 按钮,这样看起来就是授权1次就成功了.所以现在出来了4.0.0的强制升级.
用户在授权私域完成后,不会自动关闭页面(这里需要在服务器端获取code,然后换到用户信息),在这个返回的页面展示一个友好提示页面,或是调用百川的JSBridge接口进行关闭页面.
百川JSBridge提供的方法挂载到了window.Baichuan上,属性和方法通过该对象来调用
Baichuan.closeWebView(callback)
参考地址 https://baichuan.taobao.com/docs/doc.htm?treeId=129&articleId=118201&docType=1
百川申请教程
1.打开 百川官网 http://baichuan.taobao.com/ 2.点击 立即使用 会来到百川控制台
3.点击 创建应用 填写自己的APP信息
注意: Android端Package Name 和 IOS端Bundle ID 只能选一个(新版规定) 不过安卓和IOS的可以共用一个appkey(在百川后台,对应的应用里面,系统设置->应用设置,填写后提交,再换ios/android填好再提交) 这里需要填写正式版的包名,不然后面要重新生成一次yw122.jpg 安卓申请正式版的证书,苹果最好也先申请好APP的证书.
- 创建好应用后,在 应用管理 处找到刚刚申请的应用,点后面的 应用证书
复制应用的appkey,填写在 config.xml 中如下(替换掉123456)
这里申请完了,再需要进入 我的产品后台 申请 百川电商SDK权限
申请套件
上面的步骤都完成后,需要生成 yw122.jpg 安全图片
下载百川模块包 并解压
链接:http://pan.baidu.com/s/1kUNRUuj 密码:nnwl
点击百川控制台左侧的 安全图片获取
选择IOS,填写上您IOS的package name 然后点击下载,下载完成后,按Ctrl+C复制这个图片 然后进入刚下载的百川模块包/ios/目录下,双击打开baichuan_doudoujuan.zip这个文件 进入/target/目录下,会看到有一个存在的yw122.jpg,直接按粘贴 ,将刚刚复制的图片替换掉这个压缩包中的yw122.jpg 这样IOS的模块包制作完成
再在百川那边,选择 使用V5版安全图片 再选择 Android ,然后将您的正式安卓包(正式签名的apk) 选择并上传到百川 百川处理完后会生成一个yw122.jpg,点击下载,下载完后,复制它,复制到Android目录下baichuan_doudoujuan.zip中的\baichuan_doudoujuan\res_baichuan_doudoujuan\res\drawable\ 目录下面,替换掉原yw122.jpg 这样android的模块包制作完成
添加百川模块
在apiColud控制台->模块->模块库中添加百川模块,然后选择自定义模块 点击 上传自定义模块 模块名称填写 baichuan_doudoujuan 模块概要 和 版本设置 随意填写 选择文件 安卓选择 模块yw122包\Android\下面的baichuan_doudoujuan.zip 这个压缩 文件 苹果选择 模块yw122包\iOS\下面的baichuan_doudoujuan.zip 这个压缩 文件 上传完成后, 保存 自定义模块就完成了. 这样可以重新编译个自定义loader来进行引用和测试了.
跨店高佣教程
- 打开阿里妈妈官网 然后登录
- 进入 淘宝联盟(站长)页面 https://pub.alimama.com/myunion.htm
- 点击推广管理->网站管理->新增网站推广(填写自己的信息,然后等审核,审核需要1-3天左右),如果有申请过这一步可以不用管
申请通过后,需要点击这个网站后面的 查看权限 这样就会有一个 联盟合作网站API的权限,后面有一个APPKEY, 复制这串数字,填写在百川模块初始化处(init方法的参数taobaoAppkey)
再点击联盟后台->推广管理->推广位管理->如果没有创建过推广位,去创建一个就是(打开 随便选一个商品,立即推广,选择网站推广,刚刚的网站名称,推广位写个app 然后确定就行,然后刷新推广位的页面,就有了推广位) 复制这个pid(mm_123123123_123123_33333333)这样一串字符,复制到初始化APP处(init方法中的参数pid),这样就行了. 确定appkey和pid都属于同一个账号,同一个站点下,就能自动走高佣
注意事项
- 1,安卓端编译时,必须使用 升级环境 编译
- 2,还需将编译版本设为4.1.2(淘宝的些SDK限制了编译版本),不然会编译出错(见下图)
- 具体参考下面图片