plugin.openEcShopCustom
收藏我的收藏
收藏基础库 3.43.0.0 开始支持本接口。
提供跳转抖音小店店铺自定义页面能力，传入 tempelateId 指定，仅支持抖音 App 和抖音极速版 App。
前置条件
- 1.参考 电商小程序接入指南 完成小程序及资质的准备；
- 2.参考 申请行业插件 完成插件的申请，注意只有小程序拥有电商类目资质才可见申请入口；
- 3.参考 使用行业插件 进行能力的调用；
行业插件在抖音 App 版本 31.8.0 及以上，小程序基础库版本 3.4x.0.0 及以上时支持。
语法
plugin.openEcShopCustom(options);
参数说明
属性名 | 类型 | 默认值 | 必填 | 说明 | 最低支持版本 |
shopId | string | -- | 是 | 当前小程序绑定的抖音小店id | 2.56.0.0 |
tempelateId | string | -- | 是 | 指定跳转店铺自定义页面模板 id，请从商家后台获取 | 2.56.0.0 |
success | function | -- | 否 | 接口调用成功的回调函数 | 2.56.0.0 |
fail | function | -- | 否 | 接口调用失败的回调函数 | 2.56.0.0 |
complete | function | -- | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） | 2.56.0.0 |
成功回调
参数 | 参数类型 | 说明 | 最低支持版本 |
errMsg | string | 回调信息 | 2.56.0.0 |
回调失败
参数为 Object 类型，属性如下：
参数 | 参数类型 | 说明 | 最低支持版本 |
errNo | number | 错误码 | 2.56.0.0 |
errMsg | string | 错误信息 | 2.56.0.0 |
错误码说明
errNo | errMsg | 说明 | 最低支持版本 |
10101 | Platform auth deny | 权限错误，不在白名单内； | 2.56.0.0 |
10301 | The feature is only support in Douyin and DonyinLite | 仅支持在抖音、抖音Lite使用，当前 App 不支持这个功能 | 2.56.0.0 |
20000 | xxx should be string, but got xxx | 参数类型校验错误，请检查参数类型 | 2.56.0.0 |
21500 | Invalid login status, please check login status | 获取宿主 sessionid 失败，用户未登录 | 2.56.0.0 |
21501 | Network error | 网络错误，请检查网络状况 | 2.56.0.0 |
21502 | Server error | 服务端网关错误（如 404、502等），请联系客服助手 | 2.56.0.0 |
代码示例
// 代码示例 const plugin = tt.requirePlugin('tt95aee3130ae1cbe911'); Page({ openEcShopCustom() { tt.login({ success: () => { plugin.openEcShopCustom({ shopId: "1111116433", tempelateId: "7101488025674432812", success: (res) => { console.log("openEcShopCustom", res); }, fail: (res) => { console.log("调用失败", res); }, }); }, fail: (err) => { console.log(err); }, }); }, });
Bug & Tip
- •Tip：使用该接口时需要用户身份信息，请确保在调用接口前，用户已经登录宿主 App；
- •Tip：目前该接口只支持抖音 App 和抖音极速版 App，所以请在抖音 App 和抖音极速版 App 中调用。
