抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发教程与代码示例
  • 入门
  • 小程序框架
  • 小程序运行时
  • 自定义组件
  • 基础教程
  • 能力教程
  • 流量入口
  • 通用能力
  • 推广变现
  • 经营能力
  • 行业能力
  • 配置行业 SDK 的权限
  • 本地团购类小程序(步骤一:前端开发)
  • 本地团购类小程序(步骤二:商品库接入)
  • 电商
  • 电商定制
  • 电商会员
  • 插件扩展能力
  • AI/AR 算法能力
  • 性能优化
  • 安全
  • 注意事项

      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 }

    后端接入