← 返回
未分类 Key

kutesmart-海外运营平台商品浏览搜索

调用海外运营平台商品浏览、商品搜索、品类和 C 端分类树接口。用于商城首页商品列表、按名称或编码搜索商品、查询已上架品类、查询 C 端分类树,并为商品详情、加购和下单 skill 提供商品候选;当用户要浏览商品、搜索款式、筛选品类或找可下单商品时触发。
调用海外运营平台商品浏览、商品搜索、品类和 C 端分类树接口。用于商城首页商品列表、按名称或编码搜索商品、查询已上架品类、查询 C 端分类树,并为商品详情、加购和下单 skill 提供商品候选;当用户要浏览商品、搜索款式、筛选品类或找可下单商品时触发。
Kutesmart
未分类 community v1.0.3 3 版本 100000 Key: 需要
★ 0
Stars
📥 9
下载
💾 0
安装
3
版本
#latest

概述

kutesmart-海外运营平台商品浏览搜索-商城首页商品列表、按名称或编码搜索商品、查询已上架品类、查询 C 端分类树

正式环境固定服务根地址:https://www.kutetailor.com/api/product

用于只读查询商城商品候选。这个 skill 不查看深度详情、不查库存、不写购物车,适合作为后续 platform-product-detail 和购物车下单链路的前置检索能力。

调用参数要求

调用本技能时,tool arguments 统一使用嵌套 params 对象:

{
  "params": {
    "action": "product_home",
    "accessToken": "<access_token>",
    "source": "C",
    "originSign": "<site-sign>",
    "type": 2,
    "pageNum": 1,
    "pageSize": 20
  }
}

重要约束:

  • 最外层只能放 params
  • 正式环境地址固定在 frontmatter 的 base_url;执行器按 base_url + endpoint/动作表 URL 调用。
  • 登录态接口带 Authorization: Bearer
  • C 站公共浏览通常需要 Header/Query 上下文:source: CoriginSign;部分列表场景可用 ctoken,但不能替代详情接口的 originSign
  • 这是只读 skill,不调用购物车、下单、后台维护、导入导出接口。
  • 列表结果较大时可以本地截断展示,但后端 pageSize 建议保持 10-20。

触发场景

  • “看看商城商品”
  • “搜索衬衫/西服/某个商品编码”
  • “有哪些已上架品类”
  • “按分类找商品”
  • “给我一些可下单商品候选”

输入参数

参数类型必填说明
---------:---
frontmatter.base_urlstring固定正式环境服务根地址,调用时不由用户传入。
params.actionstring见下方动作表。
params.accessTokenstring条件登录态搜索建议传;发送为 Bearer token。
params.sourcestringC站建议通常为 C
params.originSignstringC站条件C 站站点标识;品类和详情链路常用。
params.ctokenstring部分 C 站列表上下文可用。
params.pageNumnumber分页必填页码,默认建议 1
params.pageSizenumber分页必填每页数量,默认建议 20
params.typenumberproduct_home 必填1 简定制,2 成品。首轮闭环优先 2
params.sortnumber排序方式,源码注释:1 升序,2 降序。
params.categorynumber产品品类。
params.labelsstring标签,按后端口径传。
params.productCategorynumber产品分类。
params.labelnumber单个标签。
params.codestring搜索条件商品编码。
params.namestring搜索条件商品名称。
params.currencynumber币种 id。
params.userIdnumber/string分类树必填网站所属用户。

动作表

action请求URL参数返回用途
------------------
product_homeGET/product/product/public/selectProductHomeQuery:pageNumpageSizetype,可选 sortcategorylabelsproductCategorylabeluserIdIPage商城首页、分类页和轻量过滤。
product_searchGET/product/product/cProductPageQuery:pageNumpageSize,可选 codenameuserIdcurrencyIPage登录态下按商品名称或编码搜索。
all_categoriesGET/product/product/selectAllCategoryHeader/Query:C 站需 sourceoriginSignList获取已上架简定制/成品品类。
product_category_treeGET/product_category/public/{userId}/{type}Path:userIdtypeRS>查询 C 端分类树。

推荐流程

  1. 没有 token 时先调用 platform-session-auth;如果是公开 C 站浏览,至少准备 sourceoriginSign
  2. 用户没有明确关键词时,优先 product_hometype=2 先找成品商品候选。
  3. 用户给出商品名、款式名、编码时,登录态优先 product_search;无登录上下文时用 product_home 配合分类/标签过滤。
  4. 用户说“有哪些分类/品类”时,先 all_categories,需要 C 端树形导航再 product_category_tree
  5. 返回候选时,必须保留后续链路需要的 idstyleIdtypenamecode、价格和币种字段。

返回字段重点

字段说明
------
id商品 id,传给商品详情、库存、价格接口。
styleId款式 id,保存购物车时要用。
type1 简定制,2 成品。
name / code商品名称和编码。
price / retailPrice价格字段,以实际接口返回为准。
currencySymbol / currencyCode币种展示。
stock列表库存摘要;下单前仍需详情/库存接口确认。
records / total / current / sizeIPage 分页字段。

安全边界

  • 不提交订单、不保存购物车、不删除购物车项。
  • 不调用后台 /admin/*、报表、同步、导入导出接口。
  • 不把商品 id 当作 styleId 使用;只把两者作为候选字段交给详情 skill 核验。
  • 没有查询到商品时,说明条件和后端返回,不编造商品。

来源

项目路径
------
商品接口rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/controller/ProductController.java
分类接口rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/controller/ProductCategoryController.java
请求对象rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/request/ProductHomeRequest.java
请求对象rcmtm-cloud-product/src/main/java/com/kutesmart/cloud/product/request/CProductListRequest.java
接口清单doc/interface-list.md

版本历史

共 3 个版本

  • v1.0.3 统一优化展示名称并设置 Kutesmart 图标。 当前
    2026-06-11 20:13 安全 安全
  • v1.0.2 统一优化展示名称并设置 Kutesmart 图标。
    2026-06-11 17:35 安全 安全
  • v1.0.0 Initial release
    2026-06-10 12:44 安全 安全

安全检测

腾讯云安全 (Keen)

安全,无风险
查看报告

腾讯云安全 (Sanbu)

安全,无风险
查看报告

🔗 相关推荐

business-ops

Calendar

ndcccccc
日历管理与日程安排。创建事件、管理会议,并实现多日历平台同步。
★ 7 📥 23,256
business-ops

Trello

steipete
使用 Trello REST API 管理看板、列表和卡片
★ 162 📥 41,354
business-ops

Stripe

byungkyu
Stripe API 集成,支持托管 OAuth,实现对客户、订阅、发票、产品、价格和支付的可写金融集成。
★ 27 📥 26,135