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

    语法

    tt.openEcCart(options);

    参数说明

    options 为 Object 类型,属性如下:
    属性名
    类型
    默认值
    必填
    说明
    最低支持版本
    shopId
    string
    --
    当前小程序绑定的抖音小店 ID,可从 抖店店铺信息设置 中获得
    抖音 1.96.0,抖音极速版 2.19.0
    type
    number
    1
    跳转购物车类型
    1:跳转全局购物车(暂时只支持传 1)
    2:跳转单店购物车
    2.72.0
    selectedType
    number
    --
    跳转购物车后默认选中类型,不传入表示不选中任何商品
    1:选中本店店铺的所有商品
    2:选中指定加购后的商品,需传入 cartIds
    2.72.0
    cartIds
    array<string>
    --
    否(selectedType为 2 时,必传)
    跳转后选中的购物车商品 ID 列表,cartIds 的来源如下:
      多次调用 tt.addToEcCart,收集返回的 cartId 拼装成数组;
    2.72.0
    success
    function
    --
    接口调用成功的回调函数
    抖音 1.96.0,抖音极速版 2.19.0
    fail
    function
    --
    接口调用失败的回调函数
    抖音 1.96.0,抖音极速版 2.19.0
    complete
    function
    --
    接口调用结束的回调函数(调用成功或失败都会执行)
    抖音 1.96.0,抖音极速版 2.19.0
    type 的合法值:
    类型
    描述
    1
    number
    跳转全局购物车
    2
    number
    跳转单店购物车
    selectedType 的合法值:
    类型
    描述
    1
    number
    选中本店店铺的所有商品
    2
    number
    选中指定加购的商品,需传入 cartIds
    cartIds 的合法值:
    类型
    描述
    ["xxxxxx","xxxxxx"]
    array<string>
    跳转后选中的购物车商品 ID 列表,cartIds 的来源如下:
      多次调用 tt.addToEcCart,收集返回的 cartId 拼装成数组;

    回调成功

    参数为 Object 类型,属性如下:
    参数
    参数类型
    说明
    最低支持版本
    errMsg
    string
    回调信息
    抖音 1.96.0,抖音极速版 2.19.0

    回调失败

    参数为 Object 类型,属性如下:
    参数
    参数类型
    说明
    最低支持版本
    errNo
    number
    错误码
    抖音 1.96.0,抖音极速版 2.19.0
    errMsg
    string
    错误信息
    抖音 1.96.0,抖音极速版 2.19.0

    错误码说明

    errNo
    errMsg
    说明
    最低支持版本
    10301
    feature is not supported in app
    当前 App 不支持这个功能
    抖音 1.96.0,抖音极速版 2.19.0
    20001
    param should be string, but got xxx
    参数校验错误
    抖音 1.96.0,抖音极速版 2.19.0
    21500
    The session id is unavailable, please check login status
    获取宿主 sessionid 失败,用户未登录
    抖音 1.96.0,抖音极速版 2.19.0
    21501
    server error
    网络错误
    抖音 1.96.0,抖音极速版 2.19.0
    21502
    server data error
    服务端网关错误
    抖音 1.96.0,抖音极速版 2.19.0
    21503
    has no bind relation
    当前小程序与传入的商铺无绑定关系
    抖音 1.96.0,抖音极速版 2.19.0
    21100
    host open schema fail: %s, schema == %s
    宿主 openSchema 错误
    抖音 1.96.0,抖音极速版 2.19.0
    21562
    cartIds cannot be undefined when selectedType is 2
    selectedType 为 2,cartIds 必须存在
    2.72.0

    代码示例

    <!-- ttml --> <button type="default" size="default" bindtap="openEcCart"> 跳转小店购物车 </button>
    // js tt.openEcCart({ shopId: "1234354", type: 1, selectedType: 2, cartIds: ["xxxxxx", "xxxxxx", "xxxxxx"], success(res) { console.log("调用成功", res); }, fail(res) { console.log("调用失败", res); }, });

    Bug & Tip

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