POST
/promotion/queryPromotionActivityShopList管理后台活动商铺表-列表查询
营销与触达 / 活动·店铺
基本信息
- 接口状态脚手架生成·未接入前端
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/promotion/queryPromotionActivityShopList - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方本次扫描未发现调用
- 需求上下文
- 维护人 / 最后改动liuxu 2026-01-13
- 读写数据表
promotion_activity_shop反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.promotion.PromotionActivityShopController#queryPromotionActivityShopList - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/promotion/PromotionActivityShopController.java:101 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无(渠道统一鉴权头见《认证方式》) | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| keywords | … | 否 | String | 关键字 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| id | … | 否 | Long | id → promotion_activity_shop.id |
| activityId | … | 否 | Long | 活动id → promotion_activity_shop.activity_id |
| merchantId | … | 否 | Long | → promotion_activity_shop.merchant_id |
| shopId | … | 否 | Long | 参与方商铺ID → promotion_activity_shop.shop_id |
| joinTime | … | 否 | Date | 商铺加入时间 → promotion_activity_shop.join_time |
| exitTime | … | 否 | Date | 商铺退出时间 → promotion_activity_shop.exit_time |
| status | … | 否 | Integer | 状态 1-已加入 0-已退出 → promotion_activity_shop.status |
| creator | … | 否 | String | 创建者 → promotion_activity_shop.creator |
| createTime | … | 否 | Date | 创建时间 → promotion_activity_shop.create_time |
| updater | … | 否 | String | 更新者 → promotion_activity_shop.updater |
| updateTime | … | 否 | Date | 更新时间 → promotion_activity_shop.update_time |
| deleted | … | 否 | Boolean | 是否删除 → promotion_activity_shop.deleted |
| remark | … | 否 | String | → promotion_activity_shop.remark |
| remark2 | … | 否 | String | → promotion_activity_shop.remark2 |
| shopType | … | 否 | Integer | → promotion_activity_shop.shop_type |
| shopName | … | 否 | String | |
| imgUrl | … | 否 | String | |
| address | … | 否 | String | |
| level | … | 否 | String | |
| city | … | 否 | String | |
| district | … | 否 | String |
响应示例
成功响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"id": "1",
"activityId": "1",
"merchantId": "1",
"shopId": "1",
"joinTime": "\"2026-01-01 00:00:00\"",
"exitTime": "\"2026-01-01 00:00:00\"",
"status": "1",
"creator": "\"string\"",
"createTime": "\"2026-01-01 00:00:00\"",
"updater": "\"string\"",
"updateTime": "\"2026-01-01 00:00:00\"",
"deleted": "false"
}
}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:promotion_activity_shop 反查全部引用接口 →
- PromotionActivityShopController#queryPromotionActivityShopList
- PromotionActivityShopService#queryList(PromotionActivityShopServiceImpl)
- PromotionActivityShopMapper#queryList
- BeanUtils.map → PromotionActivityShopQuery
- BeanUtils.mapList → PromotionActivityShopResponse
逻辑摘要:列表查询(promotionActivityShopService.queryList);入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释(旧站解析结果)
- 设置其他查询条件
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)