/catalogues

Lengow API 的此端点可让您管理产品目录，而无需依赖手动导入或基于界面的更新。您可以：

• 获取现有目录和其他数据源

• 读取目录结构和属性

• 列出、获取、创建、更新和删除单个产品或产品组

• 持续从您的系统（PIM、ERP、自定义工具）同步产品数据

API 更新与目录同步

通过目录 API 更新产品时，更改会在 Lengow 中立即应用。根据您的数据架构，您可以选择 API 与标准目录导入的交互方式：

选项 1：API 更新 + 计划目录导入

如果您的目录也通过计划文件导入进行同步，则下一次文件刷新仍将作为权威数据源，并使用最新文件中的值覆盖产品信息。

实际上，只要源文件中的产品数据保持最新，这就是一种非常理想的工作流程。这种混合机制允许您在白天通过 API 推送紧急数据（例如库存下降），同时每晚进行计划更新，确保目录始终与主数据源完全一致，并保证所有产品之间的数据一致性。

选项 2：仅使用 API 更新

• ✓ 实时产品更新
• ✓ 无需计划对账

如果您不需要定期进行基于文件的对账，并希望 API 成为目录管理的唯一机制，则可以完全移除计划更新。要使用此模式，只需在 Lengow 界面中将目录同步计划留空即可。

Lengow 中的目录更新报告

计划更新和 API 更新可在 Lengow 中查看，路径为“目录” > 选择您的目录 > “查看之前的目录报告”。 

您可以按更新类型筛选：计划、手动或 API。 
每次更新都会列出新增、更新和删除的产品。

支持的 API 功能

关键概念

- catalogue_id

API 请求必须使用“catalogue_id”指向特定目录。

• 列出目录通常是第一个调用的端点，因为它会返回账户中所有可用的主目录和其他数据源。其中包括每个目录对应的 “catalogue_id”，该 ID 用于后续所有请求。 
• 获取目录使用“catalogue_id”返回主目录或其他数据源的元数据（例如名称、状态、product_id_key 等）。如果是主目录，还会列出其其他数据源。

GET /catalogues/{catalogue_id} 的响应示例：

{
    "catalogue_id": 95000,
    "name": "FR Catalogue",
    "status": "enabled",
    "product_id_key": "id_product",
    "products_count": 2500,
    "role": "main_source",
    "created_at": "2024-09-11T10:42:28.661555Z",
    "updated_at": "2026-10-06T13:57:48.078126Z",
    "indexed_at": "2026-10-06T13:57:49.571801Z",
    "source": "link",
    "additional_sources": [
                124,
                125
            ]
}

- product_id_key

所有与产品相关的 API 操作都依赖于“product_id_key”（显示在上方的响应中）。

“product_id_key”在 Lengow 的目录设置中定义，用于标识包含唯一产品 ID 的字段。 
如需了解更多信息，请参阅初始产品属性映射

调用产品端点时（例如获取产品），您必须提供存储在目录字段中的产品 ID 值，该字段由 product_id_key 定义。
 

API 端点概览