mp · 12301-dscp 接口速查

HhrsRightsController 0/5 在用

POST /hhrsRights/appointment/list 未使用小程序 #

（无摘要） · HhrsRightsController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsRightsController#appointmentList
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointment

ControllerHhrsRightsController#appointmentList

ServiceHhrsRightsService#queryAppointmentList （HhrsRightsServiceImpl）

MapperCardAppointmentService.getMapper#queryPage ⇒ 表 card_appointment

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsAppointmentListRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 PageParam）
cardNumber	String	是	必填	`card_appointment`.`card_number`

响应参数

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

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

data 结构　PageInfo<HhrsAppointmentResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`card_appointment`.`id`
resourceName	String	`card_appointment`.`resource_name`
shopName	String	—
appTime	String	`card_appointment`.`app_time`
timeName	String	`card_appointment`.`time_name`
status	Integer	`card_appointment`.`status`
statusText	String	—

示例

请求示例（自动生成，仅结构参考）

POST /hhrsRights/appointment/list

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "resourceName": "",
        "shopName": "",
        "appTime": "2026-01-01 12:00:00",
        "timeName": "2026-01-01 12:00:00",
        "status": 0,
        "statusText": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（hhrsRightsService.queryAppointmentList）

前端调用方

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

POST /hhrsRights/check/list 未使用小程序 #

（无摘要） · HhrsRightsController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsRightsController#checkList
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_check

ControllerHhrsRightsController#checkList

ServiceHhrsRightsService#queryCheckList （HhrsRightsServiceImpl）

MapperCardCheckService.getMapper#queryPage ⇒ 表 card_check

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsCheckListRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 PageParam）
cardNumber	String	是	必填	`card_check`.`card_number`

响应参数

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

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

data 结构　PageInfo<HhrsCheckResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`card_check`.`id`
resourceName	String	`card_check`.`resource_name`
shopName	String	—
checkTime	String	`card_check`.`check_time`

示例

请求示例（自动生成，仅结构参考）

POST /hhrsRights/check/list

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "resourceName": "",
        "shopName": "",
        "checkTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（hhrsRightsService.queryCheckList）

前端调用方

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

POST /hhrsRights/detail 未使用小程序 #

（无摘要） · HhrsRightsController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsRightsController#detail
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_resource_ruleshopcard_bind

ControllerHhrsRightsController#detail

ServiceHhrsRightsService#queryRightsDetail （HhrsRightsServiceImpl）

MapperCardResourceRuleService.getMapper#selectById ⇒ 表 card_resource_rule

MapperShopService.getMapper#selectById ⇒ 表 shop

MapperCardBindService.getMapper#queryList ⇒ 表 card_bind

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsRightsDetailRequest

字段	类型	必填	取值/校验	表 / 列	说明
ruleId	Long	是	必填	—
cardNumber	String			`card_bind`.`card_number`	xuchao: 卡号，用于查询 card_bind 表获取持卡人信息
lng	Double			`shop`.`lng`	xuchao: 用户经度，用于距离计算
lat	Double			`shop`.`lat`	xuchao: 用户纬度，用于距离计算

响应参数

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

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

data 结构　HhrsRightsDetailResponse　（object）

字段	类型	表 / 列	说明
ruleId	Long	—
cardInstruction	String	`card_resource_rule`.`card_instruction`
isAppointment	Boolean	`card_resource_rule`.`is_appointment`
advanceDays	Integer	`card_resource_rule`.`advance_days`
advanceHour	Integer	`card_resource_rule`.`advance_hour`
appointmentDays	Integer	`card_resource_rule`.`appointment_days`
name	String	`shop`.`name`	xuchao: 持卡人信息，从 card_bind 表查询
cardModelName	String	`card_bind`.`card_model_name`
cardModelId	Long	`card_resource_rule`.`card_model_id`
identityNo	String	`card_bind`.`identity_no`
phone	String	`card_bind`.`phone`
shopId	Long	`card_resource_rule`.`shop_id`	门店信息
shopName	String	—
category	String	—	xuchao: 分类标签，取 system_dict_data.label（shop.typeId + shop.subTypeId 对应）
shopImage	String	—
businessTime	String	`shop`.`business_time`
address	String	`shop`.`address`
distance	Double	—	xuchao: 用户与门店距离（km），未传经纬度时为 null
dates	List<AvailableDate>	—	可预约日期列表
dates[].date	String	—
dates[].weekday	String	—
dates[].day	String	—
dates[].stock	String	—
dates[].disabled	Boolean	—	xuchao: 是否禁用（日历配置中 isEnabled=false 的日期）
dates[].reason	String	—	xuchao: 禁用原因
dates[].timeSlots	List<TimeSlot>	—
timeSlots[].id	Long	`card_resource_rule`.`id`
timeSlots[].name	String	`shop`.`name`
timeSlots[].time	String	—
timeSlots[].stock	String	—

示例

请求示例（自动生成，仅结构参考）

POST /hhrsRights/detail

{
  "body": {
    "ruleId": 1,
    "cardNumber": "",
    "lng": 0,
    "lat": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "ruleId": 1,
    "cardInstruction": "",
    "isAppointment": false,
    "advanceDays": 0,
    "advanceHour": 0,
    "appointmentDays": 0,
    "name": "",
    "cardModelName": "",
    "cardModelId": 1,
    "identityNo": "",
    "phone": "13800000000",
    "shopId": 1,
    "shopName": "",
    "category": "",
    "shopImage": "",
    "businessTime": "2026-01-01 12:00:00",
    "address": "",
    "distance": 0,
    "dates": [
      {
        "date": "2026-01-01 12:00:00",
        "weekday": "",
        "day": "",
        "stock": "",
        "disabled": false,
        "reason": "",
        "timeSlots": [
          {
            "id": 1,
            "name": "",
            "time": "2026-01-01 12:00:00",
            "stock": ""
          }
        ]
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 queryRightsDetail（hhrsRightsService.queryRightsDetail）

前端调用方

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

POST /hhrsRights/eligibility 未使用小程序 #

（无摘要） · HhrsRightsController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsRightsController#eligibility
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表membercard_bind

ControllerHhrsRightsController#eligibility

ServiceHhrsRightsService#checkEligibility （HhrsRightsServiceImpl）

MapperMemberService.getMapper#queryList ⇒ 表 member

MapperCardBindService.getMapper#queryList ⇒ 表 card_bind

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceCardBindService#update （CardBindServiceImpl）

MapperCardBindMapper#updateById ⇒ 表 card_bind

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsEligibilityRequest

字段	类型	必填	取值/校验	表 / 列	说明
phone	String	是	必填	`card_bind`.`phone`
identityNo	String			`card_bind`.`identity_no`	xuchao: 证件号码，未认证时必填
name	String			`member`.`name`	xuchao: 姓名，用于回写 card_bind.name

响应参数

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

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

data 结构　HhrsEligibilityResponse　（object）

字段	类型	表 / 列
isAuth	Boolean	—
hasWin	Boolean	—
cardId	Long	`card_bind`.`card_id`
cardNumber	String	`card_bind`.`card_number`
expiresTime	String	`card_bind`.`expires_time`

示例

请求示例（自动生成，仅结构参考）

POST /hhrsRights/eligibility

{
  "body": {
    "phone": "13800000000",
    "identityNo": "",
    "name": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "isAuth": false,
    "hasWin": false,
    "cardId": 1,
    "cardNumber": "",
    "expiresTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要调用 checkEligibility（hhrsRightsService.checkEligibility）

前端调用方

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

POST /hhrsRights/list 未使用小程序 #

（无摘要） · HhrsRightsController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsRightsController#list
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_resource_ruleshopcard_check

ControllerHhrsRightsController#list

ServiceHhrsRightsService#queryRightsList （HhrsRightsServiceImpl）

MapperCardResourceRuleService.getMapper#queryPage ⇒ 表 card_resource_rule

MapperShopService.getMapper#selectById ⇒ 表 shop

MapperCardCheckService.getMapper#queryList ⇒ 表 card_check

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsRightsListRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 PageParam）
keyword	String		—
lng	Double		`shop`.`lng`	xuchao: 用户经度，用于距离计算
lat	Double		`shop`.`lat`	xuchao: 用户纬度，用于距离计算
cardNumber	String		`card_check`.`card_number`	xuchao: 卡号，用于判断是否可用

响应参数

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

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

data 结构　PageInfo<HhrsRightsResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
ruleId	Long	—
name	String	`shop`.`name`
category	String	—	xuchao: 分类标签，取 system_dict_data.label（shop.typeId + shop.subTypeId 对应）
distance	Double	—	xuchao: 用户与门店距离（km），未传经纬度时为 null
businessTime	String	`shop`.`business_time`	xuchao: 营业时间，取 shop.business_time
address	String	`shop`.`address`
image	String	—
usable	Boolean	—	xuchao: 是否可用（card_check 使用次数 < card_resource_rule.total_times）

示例

请求示例（自动生成，仅结构参考）

POST /hhrsRights/list

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keyword": "",
    "lng": 0,
    "lat": 0,
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "ruleId": 1,
        "name": "",
        "category": "",
        "distance": 0,
        "businessTime": "2026-01-01 12:00:00",
        "address": "",
        "image": "",
        "usable": false
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（hhrsRightsService.queryRightsList）

前端调用方

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

HhrsStoreController 0/2 在用

POST /hhrsStore/detail 未使用小程序 #

（无摘要） · HhrsStoreController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsStoreController#detail
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表shopshop_relation

ControllerHhrsStoreController#detail

ServiceHhrsStoreService#queryStoreDetail （HhrsStoreServiceImpl）

MapperShopService.getMapper#selectById ⇒ 表 shop

MapperShopRelationService.getMapper#selectOne ⇒ 表 shop_relation

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsStoreDetailRequest

字段	类型	必填	取值/校验	表 / 列	说明
shopId	Long	是	必填	`shop_relation`.`shop_id`
lng	Double			`shop`.`lng`	xuchao: 用户经度，用于距离计算
lat	Double			`shop`.`lat`	xuchao: 用户纬度，用于距离计算

响应参数

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

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

data 结构　HhrsStoreResponse　（object）

字段	类型	表 / 列	说明
shopId	Long	`shop_relation`.`shop_id`
name	String	`shop`.`name`
category	String	—	xuchao: 分类标签，取 system_dict_data.label（sub_type_id 对应）
typeId	Integer	`shop`.`type_id`	xuchao: 门店类型，1=文旅场馆 2-5=商户折扣
image	String	—
address	String	`shop`.`address`
distance	Double	—	xuchao: 用户与门店距离（km），未传经纬度时为 null
businessTime	String	`shop`.`business_time`	xuchao: 营业时间，取 shop.business_time
merchantDiscount	String	—	xuchao: 商户优惠，取 shop_relation.remark

示例

请求示例（自动生成，仅结构参考）

POST /hhrsStore/detail

{
  "body": {
    "shopId": 1,
    "lng": 0,
    "lat": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "shopId": 1,
    "name": "",
    "category": "",
    "typeId": 1,
    "image": "",
    "address": "",
    "distance": 0,
    "businessTime": "2026-01-01 12:00:00",
    "merchantDiscount": ""
  }
}

处理逻辑

逻辑摘要调用 queryStoreDetail（hhrsStoreService.queryStoreDetail）

前端调用方

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

POST /hhrsStore/list 未使用小程序 #

（无摘要） · HhrsStoreController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsStoreController#list
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表shop_relationshop

ControllerHhrsStoreController#list

ServiceHhrsStoreService#queryStoreList （HhrsStoreServiceImpl）

MapperShopRelationService.getMapper#queryList ⇒ 表 shop_relation

MapperShopService.getMapper#queryList ⇒ 表 shop

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsStoreListRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 PageParam）
keyword	String		—
lng	Double		`shop`.`lng`	xuchao: 用户经度，用于距离排序
lat	Double		`shop`.`lat`	xuchao: 用户纬度，用于距离排序
typeId	Integer		`shop`.`type_id`	xuchao: 门店类型筛选，1=文旅场馆，2=商户折扣（含typeId 2-5）

响应参数

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

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

data 结构　PageInfo<HhrsStoreResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
shopId	Long	`shop_relation`.`shop_id`
name	String	`shop`.`name`
category	String	—	xuchao: 分类标签，取 system_dict_data.label（sub_type_id 对应）
typeId	Integer	`shop`.`type_id`	xuchao: 门店类型，1=文旅场馆 2-5=商户折扣
image	String	—
address	String	`shop`.`address`
distance	Double	—	xuchao: 用户与门店距离（km），未传经纬度时为 null
businessTime	String	`shop`.`business_time`	xuchao: 营业时间，取 shop.business_time
merchantDiscount	String	—	xuchao: 商户优惠，取 shop_relation.remark

示例

请求示例（自动生成，仅结构参考）

POST /hhrsStore/list

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keyword": "",
    "lng": 0,
    "lat": 0,
    "typeId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "shopId": 1,
        "name": "",
        "category": "",
        "typeId": 1,
        "image": "",
        "address": "",
        "distance": 0,
        "businessTime": "2026-01-01 12:00:00",
        "merchantDiscount": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（hhrsStoreService.queryStoreList）

前端调用方

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

HhrsWinnerController 0/2 在用

GET /hhrsWinner/dates 未使用小程序 #

（无摘要） · HhrsWinnerController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsWinnerController#dates
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	GET

调用链路 & 涉及数据表

涉及数据表hhrs_winner

ControllerHhrsWinnerController#dates

ServiceHhrsWinnerService#queryDrawDates （HhrsWinnerServiceImpl）

MapperHhrsWinnerMapper#selectDistinctDrawDates ⇒ 表 hhrs_winner

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

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

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

data 结构　List<String>　（list）

标量/Map/外部类型：List<String>

示例

请求示例（自动生成，仅结构参考）

GET /hhrsWinner/dates

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": []
}

处理逻辑

逻辑摘要调用 queryDrawDates（hhrsWinnerService.queryDrawDates）

前端调用方

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

POST /hhrsWinner/list 未使用小程序 #

（无摘要） · HhrsWinnerController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.HhrsWinnerController#list
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hhrs_winner

ControllerHhrsWinnerController#list

ServiceHhrsWinnerService#queryWinnerList （HhrsWinnerServiceImpl）

MapperHhrsWinnerMapper#queryPage ⇒ 表 hhrs_winner

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HhrsWinnerListRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 PageParam）
drawDate	String		`hhrs_winner`.`draw_date`

响应参数

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

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

data 结构　PageInfo<HhrsWinnerResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
memberName	String	`hhrs_winner`.`member_name`
memberPhone	String	`hhrs_winner`.`member_phone`
memberIdentityNo	String	`hhrs_winner`.`member_identity_no`
prizeName	String	`hhrs_winner`.`prize_name`
prizeType	String	`hhrs_winner`.`prize_type`
prizeAmount	String	`hhrs_winner`.`prize_amount`
drawDate	String	`hhrs_winner`.`draw_date`

示例

请求示例（自动生成，仅结构参考）

POST /hhrsWinner/list

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "drawDate": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "memberName": "",
        "memberPhone": "13800000000",
        "memberIdentityNo": "",
        "prizeName": "",
        "prizeType": "",
        "prizeAmount": "",
        "drawDate": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（hhrsWinnerService.queryWinnerList）

前端调用方

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

MpCardController 0/1 在用

POST /mpCard/checkFaceBind 未使用小程序 #

（无摘要） · MpCardController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.MpCardController#checkFaceBind
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_modelcard_bindmember_face

ControllerMpCardController#checkFaceBind

ServiceMpCardService#checkFaceBind （MpCardServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

MapperCardBindMapper#selectOne ⇒ 表 card_bind

MapperMemberFaceMapper#selectOne ⇒ 表 member_face

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　MpCheckFaceBindRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModelId	Long	是	必填	`card_bind`.`card_model_id`
cardNumber	String	是	必填	`card_bind`.`card_number`

响应参数

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

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

data 结构　MpCheckFaceBindResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
needBindFace	Boolean			—	xuchao: 是否需要绑定人脸
reason	String			—	xuchao: 原因说明

示例

请求示例（自动生成，仅结构参考）

POST /mpCard/checkFaceBind

{
  "body": {
    "cardModelId": 1,
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "needBindFace": false,
    "reason": ""
  }
}

处理逻辑

逻辑摘要调用 checkFaceBind（mpCardService.checkFaceBind）

前端调用方

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

MpContentManageController 5/5 在用

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

新增宣传配置 · MpContentManageController

基本信息

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

调用链路 & 涉及数据表

涉及数据表mp_content

ControllerMpContentManageController#add

ServiceMpContentManageService#add （MpContentManageServiceImpl）

MapperMpContentMapper#add ⇒ 表 mp_content

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　MpContentAddRequest

字段	类型	表 / 列
channel	String	`mp_content`.`channel`
type	String	`mp_content`.`type`
title	String	`mp_content`.`title`
content	String	`mp_content`.`content`
imageUrl	String	`mp_content`.`image_url`
linkUrl	String	`mp_content`.`link_url`
sortOrder	Integer	`mp_content`.`sort_order`
category	String	`mp_content`.`category`
status	Integer	`mp_content`.`status`
cardModelId	Long	`mp_content`.`card_model_id`

响应参数

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

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

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /mpContentManage/add

{
  "body": {
    "channel": "",
    "type": "",
    "title": "",
    "content": "",
    "imageUrl": "https://example.com/x.png",
    "linkUrl": "https://example.com/x.png",
    "sortOrder": 0,
    "category": "",
    "status": 0,
    "cardModelId": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志mp / 新增宣传配置

逻辑摘要新增（mpContentManageService.add）

前端调用方

dscp-html-manage addMpContent exact

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

删除宣传配置 · MpContentManageController

基本信息

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

调用链路 & 涉及数据表

涉及数据表mp_content

ControllerMpContentManageController#delete

ServiceMpContentManageService#delete （MpContentManageServiceImpl）

MapperMpContentMapper#deleteById ⇒ 表 mp_content

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

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	id	Long	是		`mp_content`.`id`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

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

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

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /mpContentManage/delete?id=…

响应示例

（void，无响应体）

处理逻辑

操作日志mp / 删除宣传配置

逻辑摘要删除（mpContentManageService.delete）

前端调用方

dscp-html-manage deleteMpContent exact

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

（无摘要） · MpContentManageController

基本信息

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

调用链路 & 涉及数据表

涉及数据表mp_content

ControllerMpContentManageController#get

ServiceMpContentManageService#get （MpContentManageServiceImpl）

MapperMpContentMapper#selectById ⇒ 表 mp_content

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

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	id	Long	是		`mp_content`.`id`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

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

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

data 结构　MpContent　（object）

字段	类型	表 / 列	说明
id	Long	`mp_content`.`id`
channel	String	`mp_content`.`channel`	xuchao: 渠道标识，支持多小程序渠道
type	String	`mp_content`.`type`
title	String	`mp_content`.`title`
content	String	`mp_content`.`content`
imageUrl	String	`mp_content`.`image_url`
linkUrl	String	`mp_content`.`link_url`
sortOrder	Integer	`mp_content`.`sort_order`
category	String	`mp_content`.`category`
status	Integer	`mp_content`.`status`
cardModelId	Long	`mp_content`.`card_model_id`
createdTime	Date	`mp_content`.`created_time`
updatedTime	Date	`mp_content`.`updated_time`

示例

请求示例（自动生成，仅结构参考）

POST /mpContentManage/get?id=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "channel": "",
    "type": "",
    "title": "",
    "content": "",
    "imageUrl": "https://example.com/x.png",
    "linkUrl": "https://example.com/x.png",
    "sortOrder": 0,
    "category": "",
    "status": 0,
    "cardModelId": 1,
    "createdTime": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（mpContentManageService.get）

前端调用方

dscp-html-manage getMpContent exact

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

（无摘要） · MpContentManageController

基本信息

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

调用链路 & 涉及数据表

涉及数据表mp_content

ControllerMpContentManageController#queryPage

ServiceMpContentManageService#queryPage （MpContentManageServiceImpl）

MapperMpContentMapper#queryPage ⇒ 表 mp_content

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　MpContentPageRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 PageParam）
channel	String		`mp_content`.`channel`
type	String		`mp_content`.`type`
status	Integer		`mp_content`.`status`
keyword	String		—

响应参数

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

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

data 结构　PageInfo<MpContent>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`mp_content`.`id`
channel	String	`mp_content`.`channel`	xuchao: 渠道标识，支持多小程序渠道
type	String	`mp_content`.`type`
title	String	`mp_content`.`title`
content	String	`mp_content`.`content`
imageUrl	String	`mp_content`.`image_url`
linkUrl	String	`mp_content`.`link_url`
sortOrder	Integer	`mp_content`.`sort_order`
category	String	`mp_content`.`category`
status	Integer	`mp_content`.`status`
cardModelId	Long	`mp_content`.`card_model_id`
createdTime	Date	`mp_content`.`created_time`
updatedTime	Date	`mp_content`.`updated_time`

示例

请求示例（自动生成，仅结构参考）

POST /mpContentManage/queryPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "channel": "",
    "type": "",
    "status": 0,
    "keyword": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "channel": "",
        "type": "",
        "title": "",
        "content": "",
        "imageUrl": "https://example.com/x.png",
        "linkUrl": "https://example.com/x.png",
        "sortOrder": 0,
        "category": "",
        "status": 0,
        "cardModelId": 1,
        "createdTime": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（mpContentManageService.queryPage）

前端调用方

dscp-html-manage queryMpContentPage exact

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

更新宣传配置 · MpContentManageController

基本信息

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

调用链路 & 涉及数据表

涉及数据表mp_content

ControllerMpContentManageController#update

ServiceMpContentManageService#update （MpContentManageServiceImpl）

MapperMpContentMapper#updateById ⇒ 表 mp_content

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　MpContentUpdateRequest

字段	类型	表 / 列
id	Long	`mp_content`.`id`
channel	String	`mp_content`.`channel`
type	String	`mp_content`.`type`
title	String	`mp_content`.`title`
content	String	`mp_content`.`content`
imageUrl	String	`mp_content`.`image_url`
linkUrl	String	`mp_content`.`link_url`
sortOrder	Integer	`mp_content`.`sort_order`
category	String	`mp_content`.`category`
status	Integer	`mp_content`.`status`
cardModelId	Long	`mp_content`.`card_model_id`

响应参数

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

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

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /mpContentManage/update

{
  "body": {
    "id": 1,
    "channel": "",
    "type": "",
    "title": "",
    "content": "",
    "imageUrl": "https://example.com/x.png",
    "linkUrl": "https://example.com/x.png",
    "sortOrder": 0,
    "category": "",
    "status": 0,
    "cardModelId": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志mp / 更新宣传配置

逻辑摘要更新（mpContentManageService.update）

前端调用方

dscp-html-manage updateMpContent exact

MpShopNoticeController 0/1 在用

POST /mpShopNotice/queryShopNoticePage 未使用小程序 #

（无摘要） · MpShopNoticeController

基本信息

控制器	com.jxxx.dscp.api.controller.mp.MpShopNoticeController#queryShopNoticePage
所属模块	mp `mp`
暴露渠道	小程序（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表shop_notice

ControllerMpShopNoticeController#queryShopNoticePage

ServiceMpShopNoticeService#queryShopNoticePage （MpShopNoticeServiceImpl）

转换BeanUtils.map → MpShopNoticeResponse

MapperShopNoticeMapper#queryPage ⇒ 表 shop_notice

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　MpShopNoticePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 PageParam）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 PageParam）
shopId	Long	是	必填	`shop_notice`.`shop_id`

响应参数

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

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

data 结构　PageInfo<MpShopNoticeResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`shop_notice`.`id`
shopId	Long	`shop_notice`.`shop_id`	xuchao: 商铺id
title	String	`shop_notice`.`title`	xuchao: 公告标题
content	String	`shop_notice`.`content`	xuchao: 公告内容（富文本全量）
createdTime	Date	`shop_notice`.`created_time`	xuchao: 创建时间

示例

请求示例（自动生成，仅结构参考）

POST /mpShopNotice/queryShopNoticePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "shopId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "shopId": 1,
        "title": "",
        "content": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（mpShopNoticeService.queryShopNoticePage）

前端调用方

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

mp mp

HhrsRightsController 0/5 在用

HhrsStoreController 0/2 在用

HhrsWinnerController 0/2 在用

MpCardController 0/1 在用

MpContentManageController 5/5 在用

MpShopNoticeController 0/1 在用