kutesmart-海外运营平台款式目录-platform-style-catalog
正式环境固定服务根地址:https://www.kutetailor.com/api/style
用于查询 style 模块的款式目录和详情。它偏向款式/系列视角,和 platform-product-browse 的商品视角互补。
调用参数要求
tool arguments 统一使用嵌套 params 对象:
{
"params": {
"action": "ready_to_buy",
"accessToken": "<access_token>",
"pageNum": 1,
"pageSize": 20,
"keywords": "suit"
}
}
重要约束:
- 最外层只能放
params。 - 查询内部款式接口建议带
Authorization: Bearer <accessToken>。 - 这是只读 skill,不调用款式导入、上下架、图像搜索重建等维护接口。
- 返回候选时保留
styleId/id、styleNo/code、type、category、seriesId、价格、图片和库存摘要。
动作表
| action | 请求 | URL | 参数 | 返回 | 用途 |
|---|---|---|---|---|---|
| new_arrival | GET | /style-info | Query:ArrivalParamVO | IPage<NewArrivalVO> | new arrival 款式分页。 |
| all_series | GET | /style-info/getAllSeries | Query:可选 isConference | List<SeriesInfoVO> | 查询所有已上架系列。 |
| styles_by_series | GET | /style-info/getStylesBySeriesId | Query:seriesId 和分页/筛选 | IPage<StyleGoodsVO> | 根据系列查询产品。 |
| ready_home | GET | /style-info/readyHome | 无或上下文参数 | List<StyleFinishCategoryVO> | ready to buy 首页数据。 |
| ready_to_buy | GET | /style-info/readyToBuy | Query:ParamToBuyVO | IPage<ReadyToBuyVO> | ready to buy 列表。 |
| ready_to_wear | GET | /style-info/readyToWear | Query:ParamToBuyVO | IPage<ReadyToBuyVO> | 成品 mystyle 列表。 |
| finish_detail | GET | /style-info/getFinishDetail | Query:id、可选 ordenId | StyleFinishVO | 成品详情及编辑订单详情。 |
| design_detail | GET | /style-info/getDesignDetail | Query:id | StyleDesignVO | 简定制详情。 |
| finish_stock | GET | /style-info/finishStock | Query:styleId | List<FinishStockVO> | ready to buy 库存。 |
| style_finish_stock | GET | /style-info/getStyleFinishStock | Query:styleId | RS<List<StyleFinishStock>> | 根据款式查询成品库存。 |
| style_images | POST | /style-info/listProductUrl | Body:idList | RS<List<ProductUrlVO>> | 批量查询款式图片。 |
| style_labels | GET | /style-info/getStyleLable | Query:type、category | RS | 获取款式标签。 |
| simple_category_list | GET | /style-info/public/getSimpleCategoryList | C 站上下文 | List<StyleFinishCategoryVO> | C 简定制品类查询。 |
推荐流程
- 用户按系列找款式时先
all_series,再styles_by_series。 - 用户找成品现货时优先
ready_home或ready_to_buy。 - 用户选中款式后按类型调用
finish_detail或design_detail。 - 成品下单前用
finish_stock或style_finish_stock查库存。 - 需要展示图片时用
style_images批量补齐。
安全边界
- 不调用
/style-import/*、addProductImageSearch、updateProductImageSearch。 - 不修改款式、库存、标签、图片。
- 不把 style id 和 product id 混用;交给后续 skill 前标明字段来源。
来源
| 项目 | 路径 |
|---|---|
| 款式接口 | rcmtm-cloud-style/src/main/java/com/kutesmart/cloud/style/controller/StyleInfoController.java |
| 接口清单 | doc/interface-list.md |
微信扫一扫