目录里有什么

这些数字直接读自数据库并自动刷新，而不是写死在页面上的。

430,386: 个 SKU 总计
59,862: 属于当季在售系列
305: 个品牌
82,796: 个型号
275,253: 个 SKU 配有照片
324,546: 个隐形眼镜 SKU

目录同时保留已停产型号——识别库存与往季系列时需要它们。每个 SKU 都带有自己的状态字段。

如何获取数据

两条路径，面向不同团队：从贵方系统发起调用，或下载任何同事都能打开的文件。

REST API

用于对接官网、库存管理系统或电商平台商品列表。

可按品牌、型号、类型、性别、镜形、材质等数十个字段筛选
游标分页：完整拉取全部目录，不漏项、不重复
增量订阅：只取自上次同步以来发生变化的数据

Excel 导出

面向需要文件而非系统对接的团队，无需开发人员。

选择品牌、筛选条件与列，并将该组合保存为模板
开始前即可看到文件将包含多少个 SKU
大批量导出在后台生成，完成后链接出现在账户中

产品照片

干净背景的产品图，可直接用于官网橱窗与电商平台。

API 中：每个 SKU 均附带图片直链
导出中：单独的压缩包，按品牌与型号分目录存放
压缩包内附索引，标明每个条码对应哪些文件

响应长什么样

来自目录的真实数据，而非文档里的示例。

请求

GET /v1/products?brand=RAY-BAN&has_photo=true&limit=2

响应

{
  "data": [
    {
      "ean": "805289003472",
      "brand": "RAY-BAN",
      "model": "RB3136",
      "name": "RB3136 001 58",
      "color": "GOLD",
      "size": "58",
      "gender": "UNISEX",
      "material": "METAL",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/805289003472.png"
      ]
    },
    {
      "ean": "8056262017838",
      "brand": "RAY-BAN",
      "model": "RX5425D",
      "name": "RX5425D 2012 54",
      "color": "TORTOISE",
      "size": "54",
      "gender": "UNISEX",
      "material": "ACETATE",
      "rrp": 169,
      "currency": "EUR",
      "status": "ACTIVE",
      "images": [
        "https://s3.twcstorage.ru/acbf9e7f-efdb1b36-1938-485f-b86a-dc6b003ee974/catalog/RAY-BAN/8056262017838.jpg"
      ]
    }
  ],
  "meta": {
    "returned": 2,
    "cursor": null
  }
}

字段范围由您自己决定：若只需要条码、价格和图片链接，返回的就正是这些。完整字段清单由 /v1/meta 提供，以它为起点搭建对接最为方便。

常见问题

目录里包含库存数量吗？

不包含。目录属于基础数据：属性、照片、条码与建议售价。库存可用量在另一套系统中，不属于这批数据。我们事先说明，以免预期出现偏差。

你们提供哪种价格？

建议零售价，即品牌方建议的销售价格。采购价不会提供，无论通过 API 还是导出文件。

照片可以用在我自己的网站上吗？

可以，这正是多数客户采用目录的首要原因。API 返回图片直链；导出文件则附带含索引的图片压缩包。

数据多久更新一次？

随着品牌方数据的到达，目录持续扩充。API 提供只返回指定日期之后变更内容的方法，无需每次重新全量下载。

如何付款？

目前采用开具账单的方式，网站尚不支持刷卡支付。待其上线后，现有客户无需做任何调整。

是否也包含隐形眼镜？

包含，位于独立板块：基弧、度数、散光度、轴位、加光、包装规格与价格。数据库中没有隐形眼镜的照片——对该品类意义不大。