(即将废弃)tt.requestEc
注意
基础库 2.75.0 开始支持本接口,使用时可用 tt.canIUse 判断是否可用。
目前该接口暂未对外全量开放,如需要使用,请先获取调用 API 白名单权限,对接方案产品经理开通 API 权限。其次到抖店应用控制台,确定已获取 电商小程序-商品信息 权限,如未获得权限,请参考文档 抖店开放平台-如何获取权限。
语法
tt.requestEc(options);
参数说明
options 为 Object 类型,属性如下:
参数名 | 类型 | 默认值 | 是否必传 | 描述 | 最低支持版本 |
shopId | string | -- | 是 | 2.75.0 | |
path | string | -- | 是 | 请求对应接口的路径 | 2.75.0 |
body | string | -- | 否 | 请求对应接口的请求体对象,值均传 JSON.stringify 后的 JSON 字符串 | 2.75.0 |
success | function | -- | 否 | 接口调用成功的回调函数 | 2.75.0 |
fail | function | -- | 否 | 接口调用失败的回调函数 | 2.75.0 |
complete | function | -- | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) | 2.75.0 |
回调成功
参数为 Object 类型,属性如下:
参数名 | 类型 | 说明 | 最低支持版本 |
errMsg | string | 回调信息 | 2.75.0 |
data | object | 接口返回的数据,数据格式可参考请求接口的说明文档 | 2.75.0 |
回调失败
参数为 Object 类型,属性如下:
参数名 | 类型 | 说明 | 最低支持版本 |
errMsg | string | 错误信息 | 2.75.0 |
errNo | number | 错误码 | 2.75.0 |
目前支持调用的接口说明
获取商品详情
代码示例:
tt.requestEc({ shopId: "52257178", path: "/product/getDetailForBuyer", body: { product_id: "3571940207794229115", }, success(res) { console.log("调用成功", res); }, fail(res) { console.log("调用失败", res); }, });
调用成功返回结果:
{ "errMsg": "requestEc:ok", "data": { "item_detail": { "category_info": { "first_name": "女装", "fourth_name": "", "second_name": "裤子", "third_name": "休闲裤" }, "comments_aggr": { "appends_count": 0, "bad_count": 0, "good_count": 0, "good_ratio": "0.00", "medium_count": 0, "photo_count": 0, "photo_video_count": 0, "tags": [], "total": 0, "video_count": 0 }, "detail_imgs": [ "http://p26-item.ecombdimg.com/obj/ecom-shop-material/YYhSTfEy_m_430dcb088f8ae0dfe6ff586041383469_sx_208278_www750-864", "http://p3-item.ecombdimg.com/obj/ecom-shop-material/YYhSTfEy_m_60ecf4b160eb1e3dc0644cd9d475da4e_sx_100501_www750-493" ], "detail_props": [ { "name": "品牌", "values": "Uniqlo/优衣库" }, { "name": "面料材质", "values": "聚酯纤维" }, { "name": "风格", "values": "简约风" }, { "name": "女裤裤型", "values": "女裤裤型" }, { "name": "厚薄", "values": "常规" }, { "name": "上市年份季节", "values": "上市年份季节" }, { "name": "裤长", "values": "长裤" } ], "images": [ "https://p26-item.ecombdimg.com/img/ecom-shop-material/YYhSTfEy_m_6c9124153297549870abcc1c38056693_sx_98245_www1000-1000~tplv-5mmsx3fupr-resize:1080:1080.jpeg", "https://p26-item.ecombdimg.com/img/ecom-shop-material/YYhSTfEy_m_bb14784516f20feec4399685e6feac72_sx_101485_www1000-1000~tplv-5mmsx3fupr-resize:1080:1080.jpeg", "https://p26-item.ecombdimg.com/img/ecom-shop-material/YYhSTfEy_m_53409798855d8746fc4e6b2b0ce862fa_sx_104222_www1000-1000~tplv-5mmsx3fupr-resize:1080:1080.jpeg", "https://p26-item.ecombdimg.com/img/ecom-shop-material/YYhSTfEy_m_d0df1c5802a78fe2c6ba53fab27a3c2a_sx_105343_www1000-1000~tplv-5mmsx3fupr-resize:1080:1080.jpeg", "https://p3-item.ecombdimg.com/img/ecom-shop-material/YYhSTfEy_m_727ee8dc22a5861a158878b5358e68d4_sx_370952_www1000-1000~tplv-5mmsx3fupr-resize:1080:1080.jpeg" ], "logistics_info": { "logistic_text": "48小时内发货,包邮", "post_fee_text": "包邮", "send_from": "48小时内发货" }, "name": "优衣库 女装 HEATTECH仿羊羔绒运动裤(长裤 秋冬新品) 449879", "pre_sell_type": 0, "price_info": { "max_price": 19900, "min_price": 19900, "regular_price": 19900, "sale_num": 1 }, "privileges": [ { "code": "delay_send_pay_money", "content": "若发货超时或物流异常,将为你补贴至少3元无门槛优惠券(特殊商品、大促活动及不可抗力因素除外)", "icon": "http://sf3-ttcdn-tos.pstatp.com/obj/temai/delay_send_pay_money.png", "title": "晚发即赔" }, { "code": "support_7days_refund", "content": "符合相应条件时,消费者可申请7天无理由退货", "icon": "http://sf3-ttcdn-tos.pstatp.com/obj/temai/full_return.png", "title": "7天无理由退货" }, { "code": "authentic_guarantee", "content": "若商品鉴定为假货,商家支持假一赔三,且承担商品的鉴定费和退回的运费", "icon": "http://sf1-ttcdn-tos.pstatp.com/obj/temai/detail_certificate_guarantee.png", "title": "正品保障" }, { "code": "quick_refund", "content": "满足相应条件时,待发货状态下,提交退款申请将免审核立即退款", "icon": "https://sf3-cdn-tos.douyinstatic.com/obj/eden-cn/nupfupebo/services/QuickRefund.png", "title": "极速退款" }, { "code": "ondoor_pickup", "content": "寄件方式可选择上门取件服务,等待快递员在预约的时间内完成取件,足不出户,完成退货", "icon": "https://lf3-static.bytednsdoc.com/obj/eden-cn/ulkl_ajbkvyw_tvjl/ljhwZthlaukjlkulzlp/detail/get_home.png", "title": "上门取件" }, { "code": "pay_for_bad", "content": "签收后72小时内发现商品破损、腐烂、变质(食品酒饮、奶粉、生鲜绿植为24小时),申请退款,商家将在24小时内处理", "icon": "https://sf3-cdn-tos.douyinstatic.com/obj/eden-cn/nupfupebo/services/PayForBad.png", "title": "坏损包退" }, { "code": "customer_protection", "content": "如商品有质量问题、描述不符等情况,你有权申请退货退款", "icon": "http://sf3-ttcdn-tos.pstatp.com/obj/temai/comsumer_protect.png", "title": "消费者保障服务" }, { "code": "shop_qualification", "content": "该商家已办理市场主体登记,查看资质信息", "icon": "http://sf3-ttcdn-tos.pstatp.com/obj/temai/shop_certification.png", "title": "商家资质" }, { "code": "platform_announcement", "content": "点击查看平台公示专区", "icon": "", "title": "本商品享受上述商家服务" } ], "product_id": 3571940207794229000, "product_id_str": "3571940207794229115", "sold_out": false, "status": 2 } } }
批量获取商品简略信息
代码示例:
tt.requestEc({ shopId: "7023569", path: "/product/batchGetSimpleInfoForBuyer", body: { product_ids: "[3555443880256250944]", }, success(res) { console.log("调用成功", res); }, fail(res) { console.log("调用失败", res); }, });
调用成功返回结果:
{ "errMsg": "requestEc:ok", "data": { "products": [ { "category_id": 20260, "category_info": { "first_name": "酒类", "fourth_name": "", "second_name": "国产白酒", "third_name": "" }, "images": [ "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/bbBfZeN_m_53090a00ce15724db8deb6204639cac8_sx_62914_www800-800", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/bbBfZeN_m_e07b2d11ae2ca4a2083be55a9d2f8694_sx_49576_www800-800", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/bbBfZeN_m_3df4c1d28d961ce6a8f3ed6570735654_sx_55761_www800-800", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/bbBfZeN_m_a4c36fb3014c27196b30d450e9d5c6df_sx_52810_www800-800", "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/bbBfZeN_m_99ecf99a4166b15f8286272f57881e19_sx_63326_www800-800" ], "main_img": "https://p9-aio.ecombdimg.com/obj/ecom-shop-material/bbBfZeN_m_53090a00ce15724db8deb6204639cac8_sx_62914_www800-800", "name": "五粮液五粮液 52度 普五第八代款 (补贴)52度500ml", "out_product_id": 0, "pre_sell_type": 0, "product_id": 3555443880256251000, "product_id_str": "3555443880256250944", "sale_price": 139900, "sellable": true, "skus": [ { "campaign_price": 139900, "code": "HT-五粮液-八代-500ml", "outer_sku_id": "", "price": 139900, "sale_property_values": [ { "display_value_name": "1瓶", "property_name": "颜色分类", "url": "" } ], "sku_id": "1736056581509181", "status": 0 } ], "status": 0, "store_id": 0, "update_time": 1665303175, "user_limit": false } ] } }
获取商品 SKU 信息
代码示例:
tt.requestEc({ shopId: "52257178", path: "/product/getSkuInfoForBuyer", body: { product_id: "3571940207794229115", }, success(res) { console.log("调用成功", res); }, fail(res) { console.log("调用失败", res); }, });
调用成功返回结果:
{ "errMsg": "requestEc:ok", "data": { "sku_list": [ { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426853940", "now_stock_num": 78, "purchase_status": true, "sku_id": "1744111428103179", "sku_stock_type": 1, "stock_list": [ { "stock_num": 78, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 78, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426854932", "now_stock_num": 31, "purchase_status": true, "sku_id": "1744111428104235", "sku_stock_type": 1, "stock_list": [ { "stock_num": 31, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 31, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426853892", "now_stock_num": 98, "purchase_status": true, "sku_id": "1744111428104203", "sku_stock_type": 1, "stock_list": [ { "stock_num": 98, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 98, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426854916", "now_stock_num": 87, "purchase_status": true, "sku_id": "1744111428103227", "sku_stock_type": 1, "stock_list": [ { "stock_num": 87, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 87, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426853908", "now_stock_num": 45, "purchase_status": true, "sku_id": "1744111428098052", "sku_stock_type": 1, "stock_list": [ { "stock_num": 45, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 45, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426853924", "now_stock_num": 41, "purchase_status": true, "sku_id": "1744111428103211", "sku_stock_type": 1, "stock_list": [ { "stock_num": 41, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 41, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426853908", "now_stock_num": 107, "purchase_status": true, "sku_id": "1744111428099124", "sku_stock_type": 1, "stock_list": [ { "stock_num": 107, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 107, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426854932", "now_stock_num": 21, "purchase_status": true, "sku_id": "1744111428098068", "sku_stock_type": 1, "stock_list": [ { "stock_num": 21, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 21, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426853892", "now_stock_num": 123, "purchase_status": true, "sku_id": "1744111428097076", "sku_stock_type": 1, "stock_list": [ { "stock_num": 123, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 123, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426853892", "now_stock_num": 129, "purchase_status": true, "sku_id": "1744111428099108", "sku_stock_type": 1, "stock_list": [ { "stock_num": 129, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 129, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426854932", "now_stock_num": 47, "purchase_status": true, "sku_id": "1744111428100100", "sku_stock_type": 1, "stock_list": [ { "stock_num": 47, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 47, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426854948", "now_stock_num": 18, "purchase_status": true, "sku_id": "1744111428100132", "sku_stock_type": 1, "stock_list": [ { "stock_num": 18, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 18, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426854916", "now_stock_num": 153, "purchase_status": true, "sku_id": "1744111428102155", "sku_stock_type": 1, "stock_list": [ { "stock_num": 153, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 153, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426853924", "now_stock_num": 87, "purchase_status": true, "sku_id": "1744111428100148", "sku_stock_type": 1, "stock_list": [ { "stock_num": 87, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 87, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426854948", "now_stock_num": 18, "purchase_status": true, "sku_id": "1744111428098100", "sku_stock_type": 1, "stock_list": [ { "stock_num": 18, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 18, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426853940", "now_stock_num": 39, "purchase_status": true, "sku_id": "1744111428100116", "sku_stock_type": 1, "stock_list": [ { "stock_num": 39, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 39, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426853940", "now_stock_num": 42, "purchase_status": true, "sku_id": "1744111428098084", "sku_stock_type": 1, "stock_list": [ { "stock_num": 42, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 42, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426854948", "now_stock_num": 10, "purchase_status": true, "sku_id": "1744111428105227", "sku_stock_type": 1, "stock_list": [ { "stock_num": 10, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 10, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426853908", "now_stock_num": 208, "purchase_status": true, "sku_id": "1744111428102187", "sku_stock_type": 1, "stock_list": [ { "stock_num": 208, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 208, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426853940", "now_stock_num": 26, "purchase_status": true, "sku_id": "1744111428104251", "sku_stock_type": 1, "stock_list": [ { "stock_num": 26, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 26, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426854932", "now_stock_num": 109, "purchase_status": true, "sku_id": "1744111428102203", "sku_stock_type": 1, "stock_list": [ { "stock_num": 109, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 109, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426853892", "now_stock_num": 177, "purchase_status": true, "sku_id": "1744111428102171", "sku_stock_type": 1, "stock_list": [ { "stock_num": 177, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 177, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617364;1744111426854948", "now_stock_num": 32, "purchase_status": true, "sku_id": "1744111428103195", "sku_stock_type": 1, "stock_list": [ { "stock_num": 32, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 32, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426854916", "now_stock_num": 117, "purchase_status": true, "sku_id": "1744111428097060", "sku_stock_type": 1, "stock_list": [ { "stock_num": 117, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 117, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617348;1744111426853908", "now_stock_num": 74, "purchase_status": true, "sku_id": "1744111428104219", "sku_stock_type": 1, "stock_list": [ { "stock_num": 74, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 74, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426853924", "now_stock_num": 59, "purchase_status": true, "sku_id": "1744111428099076", "sku_stock_type": 1, "stock_list": [ { "stock_num": 59, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 59, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426616372;1744111426853924", "now_stock_num": 53, "purchase_status": true, "sku_id": "1744111428097044", "sku_stock_type": 1, "stock_list": [ { "stock_num": 53, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 53, "warehouse_id": 7121894768170238000 }, { "activity_now_stock_num": 0, "activity_stock_num": 0, "effective_price": 19900, "key": "1744111426617380;1744111426854916", "now_stock_num": 102, "purchase_status": true, "sku_id": "1744111428099092", "sku_stock_type": 1, "stock_list": [ { "stock_num": 102, "stock_type": 2, "warehouse_id": 7121894768170238000 } ], "stock_num": 102, "warehouse_id": 7121894768170238000 } ], "spec_infos": [ { "detail_info": [ { "id": "1744111426616372", "name": "01 乳白色", "pic": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/YYhSTfEy_m_bb14784516f20feec4399685e6feac72_sx_101485_www1000-1000" }, { "id": "1744111426617380", "name": "08 深灰色", "pic": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/YYhSTfEy_m_3cb67031e9d9cd2973da023650bfe183_sx_97111_www1000-1000" }, { "id": "1744111426617364", "name": "09 黑色", "pic": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/YYhSTfEy_m_3a60b50e70bd47a2b5c1556a41240bc6_sx_105967_www1000-1000" }, { "id": "1744111426617348", "name": "36 褐色", "pic": "https://p3-aio.ecombdimg.com/obj/ecom-shop-material/YYhSTfEy_m_3707be53ed647a6fee856bf9554e126e_sx_90682_www1000-1000" } ], "name": "颜色" }, { "detail_info": [], "name": "尺码" } ] } }
Bug & Tip
- •Tip:使用该接口时需要用户身份信息,请确保在调用接口前,用户已经登录宿主 App。
- •Tip:目前该接口只支持抖音小店,所以请在抖音 App 中调用。