POST
/goodsInfo/queryGoodsInfoPage管理后台GoodsInfo-分页查询
商品与履约 / 商品·信息
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/goodsInfo/queryGoodsInfoPage - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台（1 个前端）
- 需求上下文
- 维护人 / 最后改动AsiQue 2023-11-24
- 读写数据表
goods_info反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.goods.GoodsInfoController#queryGoodsInfoPage - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/goods/GoodsInfoController.java:62 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无（渠道统一鉴权头见《认证方式》） | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| pageNo | … | 否 | Integer | 当前页面 |
| pageSize | … | 否 | Integer | 每页记录数 |
| orderBy | … | 否 | String | 排序语句 |
| merchantId | … | 否 | Long | 商户id |
| shopId | … | 否 | Long | 商铺id |
| shortName | … | 否 | String | 商品简称 → goods_info.short_name |
| weight | … | 否 | Integer | 商品权重 → goods_info.weight |
| tags | … | 否 | String | 商品标签 → goods_info.tags |
| recommendReason | … | 否 | String | 推荐理由 → goods_info.recommend_reason |
| introduction | … | 否 | String | 简介 → goods_info.introduction |
| propagatePic | … | 否 | String | 宣传图片url地址 → goods_info.propagate_pic |
| video | … | 否 | String | 宣传视频url地址 → goods_info.video |
| notice | … | 否 | String | 购买须知 → goods_info.notice |
| tips | … | 否 | String | 温馨提示 → goods_info.tips |
| idList | … | 否 | List<Long> | id列表 |
| keywords | … | 否 | String | 关键字 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| list | … | 否 | List<T><GoodsInfoResponse> | 分页数据集合（元素结构见下一行） |
| id | … | 否 | Long | 商品id，主键 → goods_info.id |
| shortName | … | 否 | String | 商品简称 → goods_info.short_name |
| weight | … | 否 | Integer | 商品权重 → goods_info.weight |
| tags | … | 否 | String | 商品标签 → goods_info.tags |
| businessTime | … | 否 | String | 营业时间 → goods_info.business_time |
| recommendReason | … | 否 | String | 推荐理由 → goods_info.recommend_reason |
| introduction | … | 否 | String | 简介 → goods_info.introduction |
| propagatePic | … | 否 | String | 宣传图片url地址 → goods_info.propagate_pic |
| video | … | 否 | String | 宣传视频url地址 → goods_info.video |
| notice | … | 否 | String | 购买须知 → goods_info.notice |
| tips | … | 否 | String | 温馨提示 → goods_info.tips |
| expireDate | … | 否 | Date | → goods_info.expire_date |
| isRefund | … | 否 | Boolean | → goods_info.is_refund |
| total | … | 否 | Long | 数据总数 |
响应示例
成功响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"list": "[]",
"id": "1",
"shortName": "\"string\"",
"weight": "1",
"tags": "\"string\"",
"businessTime": "\"string\"",
"recommendReason": "\"string\"",
"introduction": "\"string\"",
"propagatePic": "\"string\"",
"video": "\"string\"",
"notice": "\"string\"",
"tips": "\"string\""
}
}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：goods_info 反查全部引用接口 →
- GoodsInfoController#queryGoodsInfoPage
- GoodsInfoService#queryPage（GoodsInfoServiceImpl）
- GoodsInfoMapper#queryPage
- BeanUtils.mapPage → GoodsInfoQuery
逻辑摘要：分页查询（goodsService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
dscp-html-manage/src/api/goodsinfo/index.ts:10管理后台 · request