文章分类: 品牌查询页
本条还可参阅:

品牌查询页集成第三方算法指南

品牌查询页集成第三方算法指南


一、介绍


若您有精细化运营需求且具备一定的开发能力,17TRACK支持您使用自有的推荐算法,实现个性化的商品推荐。我们将调用您提供的API地址,并在跟踪页面的商品推荐区域展示商品信息。以下是具体的集成流程指南。



二、集成步骤


  1. 配置跟踪页面
  2. 提供API地址;您需要根据我们的集成方式实现该API服务,以返回需要推荐的商品信息。


三、API集成


1. 基本信息

项目

内容

备注

API 地址

由您提供,填写在品牌跟踪页面编辑器中

我们将对该地址进行基本的连通性检查

协议

Http


请求格式

JSON

目前仅支持 JSON 传输

响应格式

JSON

目前仅支持 JSON 传输


2. 验证


您需要提供一个支持匿名访问的API。如需安全保障,请开通白名单以支持我们的访问。


3. 接口集成


我们将调用您提供的API。我们已定义好请求参数和期望的响应内容,您需要按照定义好的请求输入和输出进行集成。


  1. 请求方法


POST


  1. 请求参数


请求示例
curl --location 'https://example.com'
--header 'x-shopify-domian: example.myshopify.com'
--header 'Content-Type: application/json'
--data '{
"shop_name": "example.myshopify.com",
"limit": 10,
"currency": "USD",
"ids": ["323000"]
}'
{
"shop_name": "example.myshopify.com",
"limit": 10, // 最多显示10个商品
"currency": "USD",
"ids": ["323000"]}


请求字段说明

字段

名称

类型

是否必填

描述

shop_name

商店名称

String

是

Shopify 商店的完整域名

limit

返回数量

Num

是

最多显示的商品数量,目前为10

currency

货币

String

是

商店当前的货币代码

ids

SKU ID

String Array

否

订单下的所有 SKU ID



  1. 响应参数


响应示例
正常响应
{
"code": "200",
"message": "",
"data": [
{
"product_id": "7635574000000",
"product_title": "17TRACK DEMO PRODUCT",
"price": "120.00",
"url": "https://17TRACK.com/products/a2568?variant=1001",
"image": "https://cdn.shopify.com/s/foo.jpg",
"currency": "USD",
"currency_symbol": "$",
"discount_type": "fixed_amount",
"discount_value": "80",
"discount_price": "96.00"
}
]}
错误响应
{
"code": "500",
"data": null,
"message": "request too fast"}


响应字段说明

字段

名称

类型

是否必填

描述

示例

product_id

商品ID

String

是

Shopify 商店中的唯一商品ID

7635574000000

product_title

商品标题

String

是

商品标题

17TRACK DEMO PRODUCT

price

SKU价格

String

是

商品价格 (Shopify 价格)

120

url

商品链接

String

是

商品链接

https://17TRACK.com/products/a2568?variant=1001

image

主图

String

是

商品变体的主图

https://cdn.shopify.com/s/foo.jpg

currency

货币代码

String

是

货币

USD

currency_symbol

货币符号

String

是

货币符号

$

discount_type

折扣类型

String

否

Shopify 折扣 value_type

fixed_amount / percentage

discount_value

折扣值

String

否

折扣数值。将与 discount_type 拼接显示 (例如,若折扣类型为 percentage 且值为 88,则显示为 88%)

fixed_amount: 80

discount_price

折扣后价格

String

否

折扣后的价格

96


  1. 响应码处理


我们将根据客户 API 的响应码进行相应处理。

响应码

描述

处理方式

200

请求成功

正常展示请求结果

401

未授权

不展示

403

访问受限

不展示,通常因频率限制导致

404

未找到

不展示

500

请求失败

不展示

其他

请求失败

不展示





这篇指南解决您的问题了吗?如果觉得有用,请支持我们一个5星好评吧!点此评价⭐⭐⭐⭐⭐

更新于: 17/06/2026

这篇文章有帮助吗?

分享您的反馈意见

取消

谢谢!