返回 Skill 列表
extension
分类: 其它需要 API Key

kutesmart-海外运营平台款式目录-platform-style-catalog

查询海外运营平台款式、系列、ready to buy、order by style、成品详情、简定制详情、款式图片、标签、尺码展示和款式库存等只读接口。用于按系列/品类/关键词找款式、查看成品或简定制款式详情、查询 ready to buy 列表,并为商品详情、完整下单、面料工艺配置提供 style 侧数据;当用户要查款式、系列、ready to buy、style 详情或款式库存时触发。

person作者: user_ac9585d3hubcommunity

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/idstyleNo/codetypecategoryseriesId、价格、图片和库存摘要。

动作表

| 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:typecategory | RS | 获取款式标签。 | | simple_category_list | GET | /style-info/public/getSimpleCategoryList | C 站上下文 | List<StyleFinishCategoryVO> | C 简定制品类查询。 |

推荐流程

  1. 用户按系列找款式时先 all_series,再 styles_by_series
  2. 用户找成品现货时优先 ready_homeready_to_buy
  3. 用户选中款式后按类型调用 finish_detaildesign_detail
  4. 成品下单前用 finish_stockstyle_finish_stock 查库存。
  5. 需要展示图片时用 style_images 批量补齐。

安全边界

  • 不调用 /style-import/*addProductImageSearchupdateProductImageSearch
  • 不修改款式、库存、标签、图片。
  • 不把 style id 和 product id 混用;交给后续 skill 前标明字段来源。

来源

| 项目 | 路径 | |---|---| | 款式接口 | rcmtm-cloud-style/src/main/java/com/kutesmart/cloud/style/controller/StyleInfoController.java | | 接口清单 | doc/interface-list.md |