duibaView
来自于:开发者
兑吧积分商城模块描述
兑吧积分商城模块,主要运用提高app的运营手段,提升用户粘性。 技术支持QQ:848254798
单几步,让你迅速搭建你的积分商城。
注册后台账号,创建应用,在兑吧创建一个账号。
服务器接口开发,进行服务器端接口的开发。免登陆url。用户积分扣除接口。兑换结果消息通知接口。
客户端集成积分商城用户界面是h5网页,开发者需要将其集成到App中即可。使用兑吧提供的源码可以达到最佳体验。
商城配置,配置你的商城页面,在客户端开始一次兑换吧。
对接流程
对接流程即是对积分商城的整体对接流程的简单介绍。
术语的定义
为了方便双方的理解,兑吧将对一些名词赋予特定的意义。
开发者:使用兑吧积分商城服务的开发者简称。
积分:开发者与兑吧商城对接使用的“虚拟货币单位”,开发者可以自己更改“货币名称”和“货币汇率”。
汇率:开发者自己平台上的虚拟货币与现实中人民币的大致比率。如:100积分 = 1元 意味着100积分可以兑换1元面值的商品。
服务端:指开发者的服务器,用于接口对接。
客户端:又称用户端,目前支持Android(安卓)、iOS、微信、纯H5方式接入。
免登录url:又称自动登录url,在用户进入兑吧积分商城的时候由服务端实时生成,提供用户的登录信息,包含用户id和积分值。
扣积分接口:用户发起兑换请求后,兑吧会向开发者发一个扣积分的http请求,开发者接收到请求后,需创建订单、扣除用户相应的积分,并响应相应的信息。
通知接口:用户在兑吧兑换成功/失败后,兑吧会向开发者发通知请求,告知订单最终结果,开发者需根据通知结果修改本地订单状态,如果结果为失败,还需要退还用户之前扣除的积分。
开发者账号:开发者在兑吧注册的账号
应用(app):开发者账号下可以创建多个应用,便于统一账号下管理。
appKey:每个应用都有一个唯一的标识码。
签名:遍历请求参数的值进行MD5编码,比对sign值,确保请求不可伪造。
自有虚拟商品:由开发者自己平台向用户提供充值的商品,如:会员等级,礼品卡,月卡,游戏点数,虚拟货币等。
对接原理
-整体原理图如下:
交互流程图
客户端、开发者服务端、兑吧服务端交互流程图
特别强调,在开发过程中,需看兑吧官方文档,鉴权url部分需要兑吧工程师配合来调试。
兑吧积分商城官方地址:http://www.duiba.com.cn
show
打开兑吧积分商城模块
show(parames);
此处需要强调,打开兑吧积分商城是不需要回调函数的。 因为打开兑吧传入的url参数,是开发者自己的server和兑吧server进行鉴权后得到的免登陆url,开发者在打开兑吧之前需要进行过鉴权操作。 Apicloud只需要open一个新窗口即可。 详细的业务逻辑参考兑吧官方文档。
params
bgColor:
- 类型:字符串
- 描述:顶部栏背景颜色
textColor:
- 类型:字符串
- 描述:标题颜色
textSize:
- 类型:数字
- 描述:标题大小
titleHeight:
- 类型:字符串
- 描述:顶部栏高度
imageUrl:
- 类型:字符串
- 描述:返回按钮图片地址
imageUrl:
- 类型:字符串
- 描述:兑吧链接地址(注意,此处的url是服务器返回的url,进行的兑吧免登陆授权操作)
示例代码
apiready = function () {
var duibaView = api.require('duibaView');
duibaView.show({
bgColor:'#ff0000',//顶部栏背景颜色
textColor:'#ffffff',//标题颜色
textSize:20,//标题大小
titleHeight:45,//顶部栏高度
imageUrl:'widget://res/goback.png',//返回按钮图片地址
duibaUrl: 'http://www.duiba.com.cn/test/demoRedirectSAdfjosfdjdsa'//兑吧链接地址
});
};
可用性
iOS系统,Android系统
可提供的1.0.0及更高版本