> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help-shopify.17track.net/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

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

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

### 一、介绍

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

![](https://storage.crisp.chat/users/helpdesk/website/-/1/c/c/3/1cc3f89e3566e700/image_19tvx80.png)

### 二、集成步骤

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

### 三、API集成

###### 1. 基本信息
| **项目** | **内容** | **备注** |
| API 地址 | 由您提供，填写在品牌跟踪页面编辑器中 | 我们将对该地址进行基本的连通性检查 |
| 协议 | Http |  |
| 请求格式 | JSON | 目前仅支持 JSON 传输 |
| 响应格式 | JSON | 目前仅支持 JSON 传输 |

###### 2. 验证

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

###### 3. 接口集成

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

1. **请求方法**

POST

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

**请求字段说明**
| **字段** | **名称** | **类型** | **是否必填** | **描述** |
| shop_name | 商店名称 | String | 是 | Shopify 商店的完整域名 |
| limit | 返回数量 | Num | 是 | 最多显示的商品数量，目前为10 |
| currency | 货币 | String | 是 | 商店当前的货币代码 |
| ids | SKU ID | String Array | 否 | 订单下的所有 SKU ID |


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

**响应字段说明**
| **字段** | **名称** | **类型** | **是否必填** | **描述** | **示例** |
| 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](https://17TRACK.com/products/a2568?variant=1001) |
| image | 主图 | String | 是 | 商品变体的主图 | [https://cdn.shopify.com/s/foo.jpg](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 |

4. **响应码处理**

我们将根据客户 API 的响应码进行相应处理。
| **响应码** | **描述** | **处理方式** |
| 200 | 请求成功 | 正常展示请求结果 |
| 401 | 未授权 | 不展示 |
| 403 | 访问受限 | 不展示，通常因频率限制导致 |
| 404 | 未找到 | 不展示 |
| 500 | 请求失败 | 不展示 |
| 其他 | 请求失败 | 不展示 |



---

这篇指南解决您的问题了吗？如果觉得有用，请支持我们一个5星好评吧！[点此评价⭐⭐⭐⭐⭐](https://apps.shopify.com/17track#modal-show=WriteReviewModal)