Jd Kepler

·/ Title: jdKepler Description: jdKepler /

来自于:APICloud立即使用

概述

jdKepler 模块封装了京东开普勒导购模式SDK,在合作方的APP里嵌入京东的货架,由合作方引流至该货架,并形成闭环交易。和传统广告佣金模式对比将整套交易流程进行闭环,可提升客户体验,并提高订单转换率,享受完整的京东标准的配送和售后服务体系。开普勒导购模式能力开通流程

使用此模块之前必须先配置 config 文件,配置方法如下:

  • 名称:jdKepler
  • 参数:appKey_iOS、appSecret_iOS、urlScheme、appKey_android、appSecret_android
  • 配置示例:
  <feature name="jdKepler">
    <param name="appKey_iOS" value="a1a079063f304ad18a290102e07a850d" />
    <param name="appSecret_iOS" value="7faaab98b3d94f7baef0bbe8041fe28a" />
    <param name="appKey_android" value=""/>
    <param name="appSecret_android" value=""/>
    <param name="urlScheme" value="sdkbacka1a079063f304ad18a290102e07a850d" />
  </feature>
  • 字段描述:

    appKey_iOS:京东开普勒平台创建应用的APP Key appSecret_iOS:京东开普勒平台创建应用的APP Secret appKey_android:京东开普勒平台创建应用的android APP Key appSecret_android:京东开普勒平台创建应用的android APP Secret urlScheme:用于实现应用间跳转及数据交换,urlScheme 的 value 值为sdkback+你的appKey_iOS

iOS 平台上添加白名单,如下:     ```xml  <preference name="querySchemes" value="openapp.jdmobile,jdlogin,weixin" /> ```

iOS 平台注意: 在 管理平台 点击 SDK下载,输入iOS应用的BundleID,生成并下载SDK,将SDK打包成一个附加自定义模块上传 APICloud 平台。制作方法如下:下载 jdKeplerAppendix 模块 zip 包并解压,把 zip 包内 target 目录下的 JDKeplerSDK.framework 和 Kepler.bundle 文件替换为自己从京东开普勒平台获取的SDK。然后重新压缩为 zip 包文件上传自定义模块,云编译时勾选该模块。

注意: android 除了要配置上面的 appKey & keySecret 之外还需要使用安全图片,具体操作流程如下:

  • 到京东开普勒平台创建应用 传送门
  • 创建应用后在 “应用概览” 中可查看 appKey & keySecret
  • 在“sdk下载”中下载sdk,注意此处需要上传需要使用sdk的apk,(主要进行apk包名 & 签名验证)
  • 解压下载的sdk,在jdsdk_lib\src\main\res\raw 目录下找到 safe.jpg(即安全图片)
  • 下载配置模块 jdKeplerConfig,解压后将模块中的jdkepler_module-release.aar(.aar文件可以使用标准解压软件解压,如360解压缩软件等) 文件再次解压,将上一步的安全图片放置在 res\raw 目录下即可,再将jdkepler_module-release目录下的AndroidManifest.xml中的
<activity 
    android:exported="true" 
    android:name="com.kepler.jd.sdk.KeplerBackActivity" 
    android:theme="@android:style/Theme.Translucent">
            <intent-filter>
                <action android:name="android.intent.action.VIEW"/>
                <category android:name="android.intent.category.DEFAULT"/> 
                <data android:scheme="sdkbackc49b61cd6cb50123641e01e5a19cc0bb"/>
            </intent-filter>
</activity>

data 的标签用sdk目录下 src\main中的data标签替换掉,然后再次打包aar以及 jdKeplerConfig.zip,然后将jdKepler_config模块以自定义模块的形式与jdKepler一块编译即可

login

登录授权

login(callback(ret))

callback(ret)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    success: true,   //布尔类型;是否成功
}

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.login(function(ret){
                    alert(JSON.stringify(ret));
               });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

cancelAuth

取消授权

cancelAuth()

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.cancelAuth();

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openByH5

是否强制使用H5打开界面

openByH5({params})

params

h5:

  • 类型:布尔类型
  • 描述:是否强制使用H5打开界面,设置为false时,调用商品详情页,订单列表,购物车等方法时将跳转到京东app并打开对应的界面
  • 默认:true

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openByH5({
                      h5 : false
                });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openPage

通过URL打开任意商品页面

openPage({params})

params

url:

  • 类型:字符串类型
  • 描述:(可选项)页面url
  • 默认:打开京东商城首页

jumpType:

  • 类型:数值类型
  • 描述:(可选项)跳转类型 1代表present 2代表push
  • 默认:2

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openPage({ 
                   });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openDetail

通过SKU打开Kepler单品页

openDetail({params})

params

sku:

  • 类型:字符串类型
  • 描述:商品SKU
  • 默认:无

jumpType:

  • 类型:数值类型
  • 描述:(可选项)跳转类型 1代表present 2代表push
  • 默认:2

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openDetail({
                        sku : '1152042'
                        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openOrderList

打开订单列表

openOrderList({params})

params

jumpType:

  • 类型:数值类型
  • 描述:(可选项)跳转类型 1代表present 2代表push
  • 默认:2

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openOrderList({
                        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openNav

打开导航页

openNav({params})

params

jumpType:

  • 类型:数值类型
  • 描述:(可选项)跳转类型 1代表present 2代表push
  • 默认:2

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openNav({});

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openSearch

根据搜索关键字打开搜索结果页

openSearch({params})

params

searchKey:

  • 类型:字符串类型
  • 描述:搜索关键字
  • 默认:无

jumpType:

  • 类型:数值类型
  • 描述:(可选项)跳转类型 1代表present 2代表push
  • 默认:2

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openSearch({
                        searchKey : 'macbookPro'
                        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

openShoppingCart

打开购物车界面

openShoppingCart({params})

params

jumpType:

  • 类型:数值类型
  • 描述:(可选项)跳转类型 1代表present 2代表push
  • 默认:2

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.openShoppingCart({
                        });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本

addToCart

添加到购物车

addToCart({params},callback(ret,err))

params

sku:

  • 类型:字符串类型
  • 描述:商品sku
  • 默认:无

num:

  • 类型:字符串类型
  • 描述:(可选项)商品数量
  • 默认:1

callback(ret,err)

ret:

  • 类型:JSON 对象
  • 内部字段:
{
    success: true,   //布尔类型;是否成功
}

err:

  • 类型:JSON 对象
  • 内部字段:
{
    code: 1,   // 数值类型;错误code
}

示例代码

var jdKepler = api.require('jdKepler');
jdKepler.addToCart({
                       sku : '1152042',
                       num : '2'
                   },function(ret,err){
                       if (ret.success) {
                           alert(JSON.stringify(ret));
                        }else {
                           alert(JSON.stringify(err));
                        }
                    });

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本