海外运营平台面料目录

要解决的问题

海外运营平台的商品素材分散在面料接口、价格接口、库存接口和标签接口里，运营和开发在排查或整理面料时，经常需要手工拼凑多段返回，缺少一条能直接给出候选面料的查询路径。结果就是：同一个面料编码可能在多处重复出现，价格与库存却各查各的，最终拿到的信息不完整，也难以复用。

这个技能把面料目录相关的读取动作收拢到一个可调用清单里，让你不必再逐个端点试错。

核心能力

技能固定指向正式环境根地址 https://www.kutetailor.com/api/fabric，提供一组 GET 动作，覆盖面料与辅料目录查询：

• 按编码取详情：fabric_by_code 查询面料编码对应信息；fabric_info_by_code 还支持 category、storeCode，便于限定品类或门店。
• 关键词与标签检索：fabric_list 用 keywords 搜面料列表；fabric_labels 按 labelList 取标签；fabric_by_label 按 labelId 反查面料。
• 商业属性查询：fabric_price 按 fabricCode 和价格模式查面料价格；fabric_aided_price 查辅料价格；fabric_aided_price_list 批量查辅料价格。
• 库存与展示素材：fabric_stock 用路径参数 code 查库存；fabric_path 按编码取面料图片路径。

推荐调用顺序：拿到面料编码时，先跑 fabric_info_by_code，再按需补 fabric_price 与 fabric_stock；只有关键词时直接用 fabric_list；按风格或标签筛选时走 fabric_by_label。返回候选时应保留 fabricCode/code、名称、价格、库存、标签和图片路径，避免下游再猜。

边界与注意点

• 只做查询，不新增、删除、导入或同步面料。
• 库存或价格缺失时，不要直接跳到提交订单，需要先补齐数据或换用其他筛选条件。
• fabric_stock 使用路径参数，其余动作多为 Query 参数，接入时注意请求拼装方式。
• 批量辅料价格建议用 fabric_aided_price_list，逐个调用 fabric_aided_price 会增加往返次数。