jdKepler

来自于:APICloud立即使用

init login cancelAuth openByH5 openPage openDetail openOrderList openNav openSearch openShoppingCart addToCart

概述

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

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

  • 名称:jdKepler
  • 参数:appKey_iOS、appSecret_iOS、urlScheme、appKey_android、appSecret_android
  • 配置示例:
  1. <feature name="jdKepler">
  2. <param name="appKey_iOS" value="a1a079063f304ad18a290102e07a850d" />
  3. <param name="appSecret_iOS" value="7faaab98b3d94f7baef0bbe8041fe28a" />
  4. <param name="appKey_android" value=""/>
  5. <param name="appSecret_android" value=""/>
  6. <param name="urlScheme" value="sdkbacka1a079063f304ad18a290102e07a850d" />
  7. </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

  1. iOS 平台上添加白名单,如下: ```xml <preference name="querySchemes" value="openapp.jdmobile,jdlogin,weixin" />
  1. ***iOS 平台注意:*** 管理平台 点击 SDK下载,输入iOS应用的BundleID,生成并下载SDK,将SDK打包成一个附加自定义模块上传 APICloud 平台。制作方法如下:下载 [jdKeplerAppendix](https://docs.apicloud.com/img/jdKepler/jdKeplerAppendix.zip) 模块 zip 包并解压,把 zip 包内 target 目录下的 JDKeplerSDK.framework 和 Kepler.bundle 文件替换为自己从京东开普勒平台获取的SDK。然后重新压缩为 zip 包文件上传自定义模块,云编译时勾选该模块。
  2. ***注意:*** android 除了要配置上面的 appKey & keySecret 之外还需要使用安全图片,具体操作流程如下:
  3. - 到京东开普勒平台创建应用 [传送门](http://kepler.jd.com/console)
  4. - 创建应用后在 “应用概览” 中可查看 appKey & keySecret
  5. - 在“sdk下载”中下载sdk,注意此处需要上传需要使用sdkapk,(主要进行apk包名 & 签名验证)
  6. - 解压下载的sdk,在jdsdk\_lib\\src\\main\\res\\raw 目录下找到 safe.jpg(即安全图片)
  7. - 下载配置模块 [jdKeplerConfig](https://docs.apicloud.com/img/jdKepler/jdKeplerConfig.zip),如果模块版本为1.0.4+, 下载自定义模块[jdKeplerConfigV1](https://docs.apicloud.com/img/jdKepler/jdKeplerConfigV1.zip),解压后将模块中的jdkepler\_module-release.aar,如果模块版本为1.0.4+,解压文件jdkeplerconfig-release.aar(.aar文件可以使用标准解压软件解压,如360解压缩软件等) 文件再次解压,将上一步的安全图片放置在 res\\raw 目录下即可,再将jdkepler\_module-release目录下的AndroidManifest.xml中的

  1. data 的标签用sdk目录下 src\\main中的data标签替换掉,然后再次打包aar以及 jdKeplerConfig.zip,然后将jdKepler\_config模块以自定义模块的形式与jdKepler一块编译即可
  2. # init
  3. 初始化sdk 此接口仅支持Android
  4. init(callback(ret))
  5. ## callback(ret)
  6. ret
  7. - 类型:JSON 对象
  8. - 内部字段:

{ success: true, //布尔类型;初始化是否成功 }

  1. ## 示例代码

var jdKepler = api.require(‘jdKepler’); jdKepler.init(function(ret){ alert(JSON.stringify(ret)); });

  1. ## 可用性
  2. Android系统
  3. 可提供的1.0.0及更高版本
  4. # login
  5. 登录授权
  6. login(callback(ret))
  7. ## callback(ret)
  8. ret
  9. - 类型:JSON 对象
  10. - 内部字段:

{ success: true, //布尔类型;是否成功 }

  1. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # cancelAuth
  5. 取消授权
  6. cancelAuth()
  7. ## 示例代码

var jdKepler = api.require(‘jdKepler’); jdKepler.cancelAuth();

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openByH5
  5. 是否强制使用H5打开界面
  6. openByH5({params})
  7. ## params
  8. h5
  9. - 类型:布尔类型
  10. - 描述:是否强制使用H5打开界面,设置为false时,调用商品详情页,订单列表,购物车等方法时将跳转到京东app并打开对应的界面
  11. - 默认:true
  12. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openPage
  5. 通过URL打开任意商品页面
  6. openPage({params})
  7. ## params
  8. url
  9. - 类型:字符串类型
  10. - 描述:(可选项)页面url
  11. - 默认:打开京东商城首页
  12. jumpType
  13. - 类型:数值类型
  14. - 描述:(可选项)跳转类型 1代表present 2代表push
  15. - 默认:2
  16. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openDetail
  5. 通过SKU打开Kepler单品页
  6. openDetail({params})
  7. ## params
  8. sku
  9. - 类型:字符串类型
  10. - 描述:商品SKU
  11. - 默认:无
  12. jumpType
  13. - 类型:数值类型
  14. - 描述:(可选项)跳转类型 1代表present 2代表push
  15. - 默认:2
  16. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openOrderList
  5. 打开订单列表
  6. openOrderList({params})
  7. ## params
  8. jumpType
  9. - 类型:数值类型
  10. - 描述:(可选项)跳转类型 1代表present 2代表push
  11. - 默认:2
  12. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openNav
  5. 打开导航页
  6. openNav({params})
  7. ## params
  8. jumpType
  9. - 类型:数值类型
  10. - 描述:(可选项)跳转类型 1代表present 2代表push
  11. - 默认:2
  12. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openSearch
  5. 根据搜索关键字打开搜索结果页
  6. openSearch({params})
  7. ## params
  8. searchKey
  9. - 类型:字符串类型
  10. - 描述:搜索关键字
  11. - 默认:无
  12. jumpType
  13. - 类型:数值类型
  14. - 描述:(可选项)跳转类型 1代表present 2代表push
  15. - 默认:2
  16. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # openShoppingCart
  5. 打开购物车界面
  6. openShoppingCart({params})
  7. ## params
  8. jumpType
  9. - 类型:数值类型
  10. - 描述:(可选项)跳转类型 1代表present 2代表push
  11. - 默认:2
  12. ## 示例代码

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

  1. ## 可用性
  2. iOS系统,Android系统
  3. 可提供的1.0.0及更高版本
  4. # addToCart
  5. 添加到购物车
  6. addToCart({params},callback(ret,err))
  7. ## params
  8. sku
  9. - 类型:字符串类型
  10. - 描述:商品sku
  11. - 默认:无
  12. num
  13. - 类型:字符串类型
  14. - 描述:(可选项)商品数量
  15. - 默认:1
  16. ## callback(ret,err)
  17. ret
  18. - 类型:JSON 对象
  19. - 内部字段:

{ success: true, //布尔类型;是否成功 }

  1. err
  2. - 类型:JSON 对象
  3. - 内部字段:

{ code: 1, // 数值类型;错误code }

  1. ## 示例代码

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及更高版本