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 |
