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

1.介绍

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

2.集成步骤

2.1.配置跟踪页面

2.2.提供API地址；您需要根据我们的集成方式实现该API服务，以返回需要推荐的商品信息。

3.API集成

3.1.基本信息

3.2 验证

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

3.3 接口集成

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

3.3.1 请求方法

POST

3.3.2 请求参数

请求示例

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"]}

请求字段说明

3.3.3 响应参数

响应示例

正常响应

{

"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"}

响应字段说明

3.3.4 响应码处理

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

更新于： 16/04/2026