# 查询橱窗商品

- API 版本：1.10.0
- 最后更新：2026-09-29
- 服务地址：`https://api.ailingtu.com`
- 网页文档：[查询橱窗商品](/openapi/showcase-products)
- 完整接口约束：[JSON Schema](/openapi/operations/listTikTokShowcaseProducts.json)
- 接口发现：[接口索引](/openapi/operations/index.json)

## GET /v1/creator/tiktokshop/product/listByShowcase

接口标识：`listTikTokShowcaseProducts`

查询达人橱窗商品。创建发布任务时，商品来源 source 应传 SHOWCASE。

鉴权：请求头 `x-api-key: <YOUR_API_KEY>`；密钥仅保存在服务端。

成功判断：HTTP 2xx 且响应 code=0；异步任务还需查询最终状态。

### 请求参数

| 字段 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
| `id` | query | integer | 是 | 达人账号表 id |
| `origin` | query | LIVE \| SHOWCASE | 是 | 来源类型：LIVE 或 SHOWCASE |
| `pageSize` | query | integer | 是 | 每页数量 |
| `pageToken` | query | string | 否 | 上一页返回的分页 Token |

### 成功响应

```json
{
  "code": 0,
  "data": {
    "products": [
      {
        "id": "1732280564607717841",
        "title": "Summer Vibes Cord",
        "price": {
          "amount": "19.99",
          "currency": "USD"
        },
        "images": [
          {
            "url": "https://cdn.example.com/product.jpg",
            "width": 800,
            "height": 800
          }
        ]
      }
    ],
    "nextPageToken": "",
    "totalCount": 1
  },
  "message": "success"
}
```

### 响应字段

以下列出主要层级；完整结构、联合类型及校验规则以接口 JSON Schema 为准。必填指字段所在对象中的约束。

| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
| `code` | integer | 是 | 固定值：0 |
| `message` | string | 否 | — |
| `data` | object | 是 | — |
| `data.products` | object[] | 是 | — |
| `data.products[].id` | string | 是 | — |
| `data.products[].title` | string | 是 | — |
| `data.products[].price` | union | 否 | — |
| `data.products[].images` | object[] | 否 | — |
| `data.products[].images[].url` | string | 是 | — |
| `data.products[].images[].width` | integer | 否 | — |
| `data.products[].images[].height` | integer | 否 | — |
| `data.products[].shop` | object | 否 | — |
| `data.products[].shop.name` | string | 是 | — |
| `data.products[].addition` | null | 否 | — |
| `data.products[].mainImages` | object[] | 否 | — |
| `data.products[].mainImages[].width` | integer \| null | 是 | — |
| `data.products[].mainImages[].height` | integer \| null | 是 | — |
| `data.products[].mainImages[].url` | string | 是 | — |
| `data.products[].status` | object | 否 | — |
| `data.products[].status.inventoryStatus` | string | 是 | — |
| `data.products[].status.reviewStatus` | string | 是 | — |
| `data.products[].status.isHidden` | boolean | 是 | — |
| `data.products[].status.addedStatus` | string | 是 | — |
| `data.products[].source` | string | 否 | — |
| `data.products[].detailLink` | null | 否 | — |
| `data.products[].thirdPartyLink` | null | 否 | — |
| `data.products[].saleRegions` | array \| null | 否 | — |
| `data.products[].commission` | object | 否 | — |
| `data.products[].commission.rate` | integer | 是 | — |
| `data.products[].commission.rewardRate` | null | 是 | — |
| `data.products[].collaboration` | object | 否 | — |
| `data.products[].collaboration.id` | string | 是 | — |
| `data.products[].collaboration.type` | string | 是 | — |
| `data.products[].collaboration.partner` | null | 是 | — |
| `data.nextPageToken` | string | 是 | — |
| `data.totalCount` | integer | 是 | — |

### 接入说明与限制

- 该接口不接收 titleKeyword；如需搜索，请在客户端按 title 过滤。

### 错误处理

| HTTP | 说明 |
|---|---|
| 400 | 请求参数或请求体无效，请修正后重试。 |
| 401 | API 密钥缺失或无效，请检查 x-api-key。 |
| 403 | API 密钥没有此接口的调用权限。 |
| 429 | 请求过于频繁，请采用指数退避重试。 |
| 500 | 服务端发生错误；对于暂时性故障采用指数退避重试。 |

业务 code 非零时也应按失败处理。不要对参数、权限或授权错误盲目重试。创建发布或生成任务超时后先查询原任务，避免重复创建。