duibaView

来自于:开发者

show

兑吧积分商城模块描述

兑吧积分商城模块,主要运用提高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,进行的兑吧免登陆授权操作)

示例代码

  1. apiready = function () {
  2. var duibaView = api.require('duibaView');
  3. duibaView.show({
  4. bgColor:'#ff0000',//顶部栏背景颜色
  5. textColor:'#ffffff',//标题颜色
  6. textSize:20,//标题大小
  7. titleHeight:45,//顶部栏高度
  8. imageUrl:'widget://res/goback.png',//返回按钮图片地址
  9. duibaUrl: 'http://www.duiba.com.cn/test/demoRedirectSAdfjosfdjdsa'//兑吧链接地址
  10. });
  11. };

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本