抖音开放平台Logo
开发者文档
小程序
控制台
  • JS API 列表
  • 基础
  • TTML
  • 网络
  • 媒体
  • 地图
  • 文件
  • 数据缓存
  • 地理位置
  • 设备
  • 画布
  • 界面
  • 页面导航
  • 开放接口
  • 登录
  • 用户信息
  • 广告
  • 支付
  • 分享
  • 小程序跳转
  • 抖音视频能力
  • 收货地址
  • 设置
  • 授权
  • 评价能力
  • 数据分析
  • 视频拍摄器
  • 引导关注
  • 订阅消息
  • 电商插件能力（即将废弃）
  • 会员运营
  • 权益核销
  • 流量引导
  • 导购成交
  • （即将废弃）tt.batchAddToEcCart
  • （即将废弃）tt.openEcGood
  • （即将废弃）tt.addToEcCart
  • 商品和订单查询
  • C2B 定制
  • （即将废弃）tt.openEcCart
  • （即将废弃）tt.openEcOrder
  • （即将废弃）tt.getShopRecordToken
  • （即将废弃）tt.updateShopMemberPoints
  • AI/AR能力
  • 转发和挂载
  • 直播能力
  • 流量来源识别
  • 侧边栏能力
  • 隐私信息授权
  • web化
  • 行业开放
  • 第三方平台
  • 其它
    • 注意
    本文档即将废弃，新文档请参见 plugin.addToEcCart 。
    ​
    基础库 2.74.0.0 开始支持本接口，使用时可用 tt.canIUse 判断是否可用。
    提供小程序绑定的抖音小店的商品加购能力，仅支持抖音 App 和抖音极速版 App。
    在使用行业相关的组件和 API 前，需要在代码中配置行业 SDK 的权限：行业 SDK 的权限配置，行业 SDK 的权限配置在基础库 2.74.0.0 抖音版本 23.0 以上支持。

    语法

    tt.addToEcCart(options);

    参数说明

    options 为 Object 类型，属性如下：
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    productId
    string
    --
    是
    要加购的商品 ID，来自当前小程序绑定的抖音小店，可从 抖店商品管理模块 获得，确保商品售卖中且有库存
    2.44.0.0
    skuId
    string
    --
    是
    要加购的商品 SKU ID，来自当前小程序绑定的抖音小店，可从 抖店库存管理模块 获得，确保商品售卖中有库存，且 productId 与 skuId 匹配
    2.44.0.0
    skuAmount
    number
    --
    是
    要加购的 SKU 数量，加购的数量与购物车已有数量相加不能超过 100
    2.44.0.0
    success
    function
    --
    否
    接口调用成功的回调函数
    2.44.0.0
    fail
    function
    --
    否
    接口调用失败的回调函数
    2.44.0.0
    complete
    function
    --
    否
    接口调用结束的回调函数（调用成功、失败都会执行）
    2.44.0.0

    回调成功

    参数为 Object 类型，属性如下：
    参数
    参数类型
    说明
    最低支持版本
    errMsg
    string
    回调信息
    2.44.0.0
    cartId
    string
    购物车中的商品 ID
    2.44.0.0

    回调失败

    参数为 Object 类型，属性如下：
    参数
    参数类型
    说明
    最低支持版本
    errNo
    number
    错误码
    2.44.0.0
    errMsg
    string
    错误信息
    2.44.0.0

    错误码说明

    errNo
    errMsg
    说明
    最低支持版本
    10101
    platform auth deny
    权限错误，不在白名单内
    2.44.0.0
    10301
    The feature is not supported in app
    当前 App 不支持这个功能
    2.44.0.0
    20000
    param should be string, but got xxx
    参数校验错误
    2.44.0.0
    21500
    The session id is unavailable, please check login status
    获取宿主登录信息失败，用户未登录
    2.44.0.0
    21501
    server error
    网络错误
    2.44.0.0
    21502
    server data error
    服务端网关错误
    2.44.0.0
    21510
    --
    亲，该商品不支持加购购买，请直接购买
    2.44.0.0
    21520
    --
    当前活动不存在
    2.44.0.0
    每人限购 xx 件，当前已达购买上限
    2.44.0.0
    每人限购 xx 件，当前最多可购买 xx 件
    2.44.0.0
    当前已达购买上限
    2.44.0.0
    当前最多可购买 xx 件
    2.44.0.0
    加购数量大于商品库存
    2.44.0.0
    最多添加 xx 件
    2.44.0.0
    您购物车商品总数已满 xx 件，建议先去结算或清理
    2.44.0.0
    该商品不存在
    2.44.0.0
    同时操作人数过多，请稍后重试
    2.44.0.0
    21521
    --
    该商品不存在
    2.44.0.0
    21540
    --
    生成 cart_id 失败
    2.44.0.0
    添加购物车失败
    2.44.0.0
    21550
    --
    Invalid Params
    2.44.0.0
    21560
    --
    添加购物车失败
    2.44.0.0
    21564
    --
    请求下游失败
    2.44.0.0

    代码示例

    <!-- ttml -->
<button type="default" size="default" bindtap="addToEcCart">
  点击加购
</button>
    // js
Page({
  addToEcCart(e) {
    tt.addToEcCart({
      productId: "11123",
      skuId: "333",
      skuAmount: 1,
      success(res) {
        console.log("调用成功", res);
      },
      fail(res) {
        console.log("调用失败", res);
      },
    });
  },
});

    Bug & Tip

      •Tip：使用该接口时需要用户身份信息，请确保在调用接口前，用户已经登录宿主 App；
      •Tip：目前该接口只支持抖音 App 和抖音极速版 App，所以请在抖音 App 和抖音极速版 App 中调用。
    ​