spu spu

模块 spu：共 6 个接口 —— 0 个被前端调用（在用），6 个未被调用（含 0 个开放/回调/内部）。用下方筛选可只看“在用/未使用”，或在右栏目录按名称过滤。

SpuController 0/6 在用

POST /spu/addSpu 未使用管理后台 #
Spu-新增 · SpuController
基本信息
控制器com.jxxx.dscp.api.controller.spu.SpuController#addSpu
所属模块spu spu
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表spu
ControllerSpuController#addSpu
转换BeanUtils.map → Spu ⇒ 表 spu
ServiceSpuService#add （SpuServiceImpl）
MapperSpuMapper#insert ⇒ 表 spu

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/spu/addSpu
uathttps://dscp-uat.hn12301.net/manage-api/spu/addSpu
prohttps://dscp-uat.hn12301.net/manage-api/spu/addSpu （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SpuAddRequest
字段类型必填取值/校验表 / 列说明
nameString是必填spu.name资源名称
shopIdLong是必填spu.shop_id所属商铺ID，关联商铺表id
resourceTypeSpuType是1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceIntegerspu.cost_price成本价
stockIntegerspu.stock库存
statusSpuStatus是1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionStringspu.description说明
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　SpuResponse　（object）
字段类型必填取值/校验表 / 列说明
idLongspu.id资源ID
nameStringspu.name资源名称
shopIdLongspu.shop_id所属商铺ID，关联商铺表id
shopsNameString—所属商名称
resourceTypeSpuType1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceIntegerspu.cost_price成本价
stockIntegerspu.stock库存
statusSpuStatus1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionStringspu.description说明
示例
请求示例 （自动生成，仅结构参考）
POST /spu/addSpu
{
  "body": {
    "name": "",
    "shopId": 1,
    "resourceType": "1",
    "costPrice": 0,
    "stock": 0,
    "status": "1",
    "description": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "shopId": 1,
    "shopsName": "",
    "resourceType": "1",
    "costPrice": 0,
    "stock": 0,
    "status": "1",
    "description": ""
  }
}
处理逻辑
操作日志spu / 新增商品SPU
逻辑摘要新增（spuService.add）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /spu/deleteSpu 未使用管理后台 #
Spu-删除 · SpuController
基本信息
控制器com.jxxx.dscp.api.controller.spu.SpuController#deleteSpu
所属模块spu spu
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表spu
ControllerSpuController#deleteSpu
ServiceSpuService#delete （SpuServiceImpl）
MapperSpuMapper#deleteById ⇒ 表 spu

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/spu/deleteSpu
uathttps://dscp-uat.hn12301.net/manage-api/spu/deleteSpu
prohttps://dscp-uat.hn12301.net/manage-api/spu/deleteSpu （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest
字段类型必填取值/校验表 / 列说明
idLong是必填spu.idid
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构

void —— 无返回数据

示例
请求示例 （自动生成，仅结构参考）
POST /spu/deleteSpu
{
  "body": {
    "id": 1
  }
}
响应示例
（void，无响应体）
处理逻辑
操作日志spu / 删除商品SPU
逻辑摘要删除（spuService.delete）
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /spu/getSpu 未使用管理后台 #
Spu-详情 · SpuController
基本信息
控制器com.jxxx.dscp.api.controller.spu.SpuController#getSpu
所属模块spu spu
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表spu
ControllerSpuController#getSpu
ServiceSpuService#get （SpuServiceImpl）
MapperSpuMapper#selectById ⇒ 表 spu

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/spu/getSpu
uathttps://dscp-uat.hn12301.net/manage-api/spu/getSpu
prohttps://dscp-uat.hn12301.net/manage-api/spu/getSpu （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest
字段类型必填取值/校验表 / 列说明
idLong是必填spu.idid
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　SpuResponse　（object）
字段类型必填取值/校验表 / 列说明
idLongspu.id资源ID
nameStringspu.name资源名称
shopIdLongspu.shop_id所属商铺ID，关联商铺表id
shopsNameString—所属商名称
resourceTypeSpuType1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceIntegerspu.cost_price成本价
stockIntegerspu.stock库存
statusSpuStatus1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionStringspu.description说明
示例
请求示例 （自动生成，仅结构参考）
POST /spu/getSpu
{
  "body": {
    "id": 1
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "name": "",
    "shopId": 1,
    "shopsName": "",
    "resourceType": "1",
    "costPrice": 0,
    "stock": 0,
    "status": "1",
    "description": ""
  }
}
处理逻辑
逻辑摘要查询详情（spuService.get）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /spu/querySpuList 未使用管理后台 #
Spu-列表查询 · SpuController
基本信息
控制器com.jxxx.dscp.api.controller.spu.SpuController#querySpuList
所属模块spu spu
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表spu
ControllerSpuController#querySpuList
转换BeanUtils.map → SpuQuery
ServiceSpuService#queryList （SpuServiceImpl）
MapperSpuMapper#selectList ⇒ 表 spu
其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1
ShopCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/spu/querySpuList
uathttps://dscp-uat.hn12301.net/manage-api/spu/querySpuList
prohttps://dscp-uat.hn12301.net/manage-api/spu/querySpuList （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SpuListRequest
字段类型必填取值/校验表 / 列说明
nameString否可选(@MvcOptional)spu.name资源名称
shopIdLong否可选(@MvcOptional)spu.shop_id所属商铺ID，关联商铺表id
resourceTypeSpuType否1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceInteger否可选(@MvcOptional)spu.cost_price成本价
stockInteger否可选(@MvcOptional)spu.stock库存
statusSpuStatus否1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionString否可选(@MvcOptional)spu.description说明
idListList<Long>否可选(@MvcOptional)—id列表
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　List<SpuResponse>　（list）
字段类型必填取值/校验表 / 列说明
[ ]array—列表，元素结构见下
idLongspu.id资源ID
nameStringspu.name资源名称
shopIdLongspu.shop_id所属商铺ID，关联商铺表id
shopsNameString—所属商名称
resourceTypeSpuType1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceIntegerspu.cost_price成本价
stockIntegerspu.stock库存
statusSpuStatus1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionStringspu.description说明
示例
请求示例 （自动生成，仅结构参考）
POST /spu/querySpuList
{
  "body": {
    "name": "",
    "shopId": 1,
    "resourceType": "1",
    "costPrice": 0,
    "stock": 0,
    "status": "1",
    "description": "",
    "idList": "",
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "shopId": 1,
      "shopsName": "",
      "resourceType": "1",
      "costPrice": 0,
      "stock": 0,
      "status": "1",
      "description": ""
    }
  ]
}
处理逻辑
逻辑摘要列表查询（spuService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /spu/querySpuPage 未使用管理后台 #
Spu-分页查询 · SpuController
基本信息
控制器com.jxxx.dscp.api.controller.spu.SpuController#querySpuPage
所属模块spu spu
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表spu
ControllerSpuController#querySpuPage
转换BeanUtils.map → SpuQuery
ServiceSpuService#queryPage （SpuServiceImpl）
MapperSpuMapper#selectPage ⇒ 表 spu
其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1
ShopCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/spu/querySpuPage
uathttps://dscp-uat.hn12301.net/manage-api/spu/querySpuPage
prohttps://dscp-uat.hn12301.net/manage-api/spu/querySpuPage （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SpuPageRequest
字段类型必填取值/校验表 / 列说明
pageNumInteger否—页码（继承自框架分页基类 AbstractPageRequest）
pageSizeInteger否—每页条数（继承自框架分页基类 AbstractPageRequest）
nameString否可选(@MvcOptional)spu.name资源名称
shopIdLong否可选(@MvcOptional)spu.shop_id所属商铺ID，关联商铺表id
resourceTypeSpuType否1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceInteger否可选(@MvcOptional)spu.cost_price成本价
stockInteger否可选(@MvcOptional)spu.stock库存
statusSpuStatus否1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionString否可选(@MvcOptional)spu.description说明
idListList<Long>否可选(@MvcOptional)—id列表
keywordsString否可选(@MvcOptional)—关键字
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构　PageInfo<SpuResponse>　（page）
字段类型必填取值/校验表 / 列说明
list / recordsarray—分页列表，元素结构见下
totallong—总条数（PageInfo）
idLongspu.id资源ID
nameStringspu.name资源名称
shopIdLongspu.shop_id所属商铺ID，关联商铺表id
shopsNameString—所属商名称
resourceTypeSpuType1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceIntegerspu.cost_price成本价
stockIntegerspu.stock库存
statusSpuStatus1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionStringspu.description说明
示例
请求示例 （自动生成，仅结构参考）
POST /spu/querySpuPage
{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "name": "",
    "shopId": 1,
    "resourceType": "1",
    "costPrice": 0,
    "stock": 0,
    "status": "1",
    "description": "",
    "idList": "",
    "keywords": ""
  }
}
响应示例
{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "name": "",
        "shopId": 1,
        "shopsName": "",
        "resourceType": "1",
        "costPrice": 0,
        "stock": 0,
        "status": "1",
        "description": ""
      }
    ],
    "total": 0
  }
}
处理逻辑
逻辑摘要分页查询（spuService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /spu/updateSpu 未使用管理后台 #
Spu-更新 · SpuController
基本信息
控制器com.jxxx.dscp.api.controller.spu.SpuController#updateSpu
所属模块spu spu
暴露渠道管理后台 （@Route 注解；决定 URL 前缀与可访问端）
请求方法POST
调用链路 & 涉及数据表
涉及数据表spu
ControllerSpuController#updateSpu
转换BeanUtils.map → Spu ⇒ 表 spu
ServiceSpuService#update （SpuServiceImpl）
MapperSpuMapper#updateById ⇒ 表 spu

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL
环境完整 URL（主机 + 渠道前缀 + 路径）备注
devhttps://dscp-dev.hn12301.net/manage-api/spu/updateSpu
uathttps://dscp-uat.hn12301.net/manage-api/spu/updateSpu
prohttps://dscp-uat.hn12301.net/manage-api/spu/updateSpu （仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SpuUpdateRequest
字段类型必填取值/校验表 / 列说明
idLong是必填spu.id资源ID
nameString是必填spu.name资源名称
shopIdLong是必填spu.shop_id所属商铺ID，关联商铺表id
resourceTypeSpuType是1旅游卡2景区门票3酒店房间4餐饮美食5特产商品6旅行线路7非遗商品8场馆门票spu.resource_type资源类型(枚举:SpuType)
costPriceIntegerspu.cost_price成本价
stockIntegerspu.stock库存
statusSpuStatus是1正常2已下架spu.status资源状态(枚举:SpuStatus)
descriptionStringspu.description说明
响应参数
外层包装（chaos 框架自动；前端同时兼容 code/msg）
errcodeint业务码，0=成功
errmsgstring提示信息
dataT下方“data 结构”
data 结构

void —— 无返回数据

示例
请求示例 （自动生成，仅结构参考）
POST /spu/updateSpu
{
  "body": {
    "id": 1,
    "name": "",
    "shopId": 1,
    "resourceType": "1",
    "costPrice": 0,
    "stock": 0,
    "status": "1",
    "description": ""
  }
}
响应示例
（void，无响应体）
处理逻辑
操作日志spu / 更新商品SPU
逻辑摘要更新（spuService.update）；入参与返回值经 BeanUtils 做对象/分页映射
前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）