电商定制
注意事项
- 1.小程序不允许内嵌 H5。
- 2.小程序内涉及到图片上传(如相册上传等)需要对接敏感图校验接口图片检测 V2。
- 3.「C2B定制类目」涉及特殊接入方案,具体见【电商插件小程序】C2B定制小程序接入指南。
开发流程
- 1.从连接上获取定制小程序关键信息。
- 2.定制小程序用户提交接口。
- 3.开发者注册信息接口。
- 4.订单补全查询接口。
前端接入
电商定制 API 为开发者提供了用户支付成功后为订单定制信息提交的能力。
前端侧接入主要分为两个环节:
- •获取订单关键信息:即当消费者下单后从我的订单发起跳转进入小程序过程,开发者可以获取到一些关键信息用来辅助小程序渲染。
- •用户定制信息提交:即当消费者填写完定制信息后,点击小程序上的按钮进行信息提交,开发者需要将用户定制的信息交还给平台进行落库。
安装抖音 app
请使用如下指定安装包进行定制 API 的接入调试。
安卓
安装包:
也可在各大应用商店下载抖音 20.6.0 及以上版本。
iOS
iOS 请在 Apple Store 下载抖音 20.6.0 及以上版本。
注意
可以在 IDE 上进行开发,但需要使用真机预览进行调试。以真机上的效果为准。
获取订单关键信息
当用户从定制入口打开定制小程序时,会在 query 属性上携带订单 id、商品 id、sku_id 等信息,属性具体获取方法如下。
示例
App({ /** * * @param {Object} options * @param {Object} options.query * @param {string} options.query.order_id 订单id * @param {string} options.query.product_id 商品id * @param {string} options.query.sku_id sku_id */ onLaunch(options) { const { order_id, product_id, sku_id } = options.query; // do something }, });
注意
目前定制页面必须命名为
pages/custom-goods/custom-goods
,否则会导致订单定制无法跳转到对应页面。用户定制信息提交
使用定制信息提交 API 前需要基础库支持, 可以通过以下方式判断。
// 判断是否支持定制信息提交API if (tt.canIUse("submitEcCustomGoods")) { // do something }
后端接入