活动热区 common

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

ActivityHotspotTaskManageController 5/5 在用

POST /activityHotspotTaskManage/queryPage 在用管理后台 #

活动热区配置-分页查询 · ActivityHotspotTaskManageController

基本信息

控制器	com.jxxx.dscp.api.controller.activity.ActivityHotspotTaskManageController#queryPage
所属模块	活动热区 `activity`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerActivityHotspotTaskManageController#queryPage

ServiceactivityHotspotTaskManageService#queryPage

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

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/activityHotspotTaskManage/queryPage
uat	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/queryPage
pro	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/queryPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

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

请求参数 · Body　ActivityHotspotTaskPageRequest

字段	类型	表 / 列	说明
pageNo	Integer	—	页码
pageSize	Integer	—	每页条数
keyword	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ActivityHotspotTask　（object）

字段	类型	表 / 列
id	Long	—
taskName	String	—
imageUrl	String	—
startTime	Date	—
endTime	Date	—
rects	List<HotspotRect>	—
createdTime	Date	—
updatedTime	Date	—

示例

请求示例

{
  "pageNo": 0,
  "pageSize": 0,
  "keyword": ""
}

响应示例

{
  "id": 0,
  "taskName": "",
  "imageUrl": "",
  "startTime": "",
  "endTime": "",
  "rects": [],
  "createdTime": "",
  "updatedTime": ""
}

处理逻辑

逻辑摘要activityHotspotTaskManageService.queryPage；完整实现见源码 ActivityHotspotTaskManageController#queryPage

前端调用方

dscp-html-manage queryPage exact

POST /activityHotspotTaskManage/add 在用管理后台 #

活动热区配置-新增 · ActivityHotspotTaskManageController

基本信息

控制器	com.jxxx.dscp.api.controller.activity.ActivityHotspotTaskManageController#add
所属模块	活动热区 `activity`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerActivityHotspotTaskManageController#add

ServiceactivityHotspotTaskManageService#add

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/activityHotspotTaskManage/add
uat	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/add
pro	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/add	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

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

请求参数 · Body　ActivityHotspotTaskAddRequest

字段	类型	表 / 列
taskName	String	—
imageUrl	String	—
startTime	Date	—
endTime	Date	—
rects	List<HotspotRect>	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "taskName": "",
  "imageUrl": "",
  "startTime": "",
  "endTime": "",
  "rects": []
}

响应示例

（void，无响应体）

处理逻辑

操作日志activity / 新增活动热区配置

逻辑摘要activityHotspotTaskManageService.add；完整实现见源码 ActivityHotspotTaskManageController#add

前端调用方

dscp-html-manage add exact

POST /activityHotspotTaskManage/update 在用管理后台 #

活动热区配置-更新 · ActivityHotspotTaskManageController

基本信息

控制器	com.jxxx.dscp.api.controller.activity.ActivityHotspotTaskManageController#update
所属模块	活动热区 `activity`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerActivityHotspotTaskManageController#update

ServiceactivityHotspotTaskManageService#update

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/activityHotspotTaskManage/update
uat	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/update
pro	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/update	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

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

请求参数 · Body　ActivityHotspotTaskUpdateRequest

字段	类型	表 / 列
taskName	String	—
imageUrl	String	—
startTime	Date	—
endTime	Date	—
rects	List<HotspotRect>	—
id	Long	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "taskName": "",
  "imageUrl": "",
  "startTime": "",
  "endTime": "",
  "rects": [],
  "id": 0
}

响应示例

（void，无响应体）

处理逻辑

操作日志activity / 新增活动热区配置

逻辑摘要activityHotspotTaskManageService.update；完整实现见源码 ActivityHotspotTaskManageController#update

前端调用方

dscp-html-manage update exact

POST /activityHotspotTaskManage/delete 在用管理后台 #

活动热区配置-删除 · ActivityHotspotTaskManageController

基本信息

控制器	com.jxxx.dscp.api.controller.activity.ActivityHotspotTaskManageController#delete
所属模块	活动热区 `activity`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerActivityHotspotTaskManageController#delete

ServiceactivityHotspotTaskManageService#delete

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/activityHotspotTaskManage/delete
uat	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/delete
pro	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/delete	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

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

请求参数 · Body

JSON 对象（Map 透传，键见控制器源码，如 id）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "id": 0
}

响应示例

（void，无响应体）

处理逻辑

操作日志activity / 更新活动热区配置

逻辑摘要activityHotspotTaskManageService.delete；完整实现见源码 ActivityHotspotTaskManageController#delete

前端调用方

dscp-html-manage delete exact

POST /activityHotspotTaskManage/get 在用管理后台 #

活动热区配置-详情 · ActivityHotspotTaskManageController

基本信息

控制器	com.jxxx.dscp.api.controller.activity.ActivityHotspotTaskManageController#get
所属模块	活动热区 `activity`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerActivityHotspotTaskManageController#get

ServiceactivityHotspotTaskManageService#get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/activityHotspotTaskManage/get
uat	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/get
pro	https://dscp-uat.hn12301.net/manage-api/activityHotspotTaskManage/get	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

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

请求参数 · Body

JSON 对象（Map 透传，键见控制器源码，如 id）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ActivityHotspotTask　（object）

字段	类型	表 / 列
id	Long	—
taskName	String	—
imageUrl	String	—
startTime	Date	—
endTime	Date	—
rects	List<HotspotRect>	—
createdTime	Date	—
updatedTime	Date	—

示例

请求示例

{
  "id": 0
}

响应示例

{
  "id": 0,
  "taskName": "",
  "imageUrl": "",
  "startTime": "",
  "endTime": "",
  "rects": [],
  "createdTime": "",
  "updatedTime": ""
}

处理逻辑

操作日志activity / 删除活动热区配置

逻辑摘要activityHotspotTaskManageService.get；完整实现见源码 ActivityHotspotTaskManageController#get

前端调用方

dscp-html-manage get exact

ActivityHotspotTaskController 0/1 在用

POST /activityHotspotTask/get 未使用小程序 #

活动热区配置-C端查询（按id，免登录） · ActivityHotspotTaskController

基本信息

控制器	com.jxxx.dscp.api.controller.activity.ActivityHotspotTaskController#get
所属模块	活动热区 `activity`
暴露渠道	小程序（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerActivityHotspotTaskController#get

ServiceactivityHotspotTaskService#get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/mp-api/activityHotspotTask/get
uat	https://dscp-uat.hn12301.net/mp-api/activityHotspotTask/get
pro	https://dscp-uat.hn12301.net/mp-api/activityHotspotTask/get	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

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

请求参数 · Body

JSON 对象（Map 透传，键见控制器源码，如 id）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ActivityHotspotTaskClientResponse　（object）

字段	类型	表 / 列
id	Long	—
taskName	String	—
imageUrl	String	—
startTime	Date	—
endTime	Date	—
rects	List<HotspotRect>	—

示例

请求示例

{
  "id": 0
}

响应示例

{
  "id": 0,
  "taskName": "",
  "imageUrl": "",
  "startTime": "",
  "endTime": "",
  "rects": []
}

处理逻辑

逻辑摘要activityHotspotTaskService.get；完整实现见源码 ActivityHotspotTaskController#get

前端调用方

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