POST/cardResourceRule/queryCardResourceRuleList管理后台开放/回调

旅游卡资源-列表查询

旅游卡 / 资源规则· CardResourceRuleController#queryCardResourceRuleList

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/cardResourceRule/queryCardResourceRuleList
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台、开放/回调　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 怀化社保卡活动 H5、管理后台（2 个前端）
需求上下文feat:新增旅游卡基础服务
维护人 / 最后改动AsiQue　2023-12-05　最近提交：feat:新增旅游卡基础服务
读写数据表card_resource_rule　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.card.CardResourceRuleController#queryCardResourceRuleList
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardResourceRuleController.java:136
判定依据2 个调用点：activity_h5/src/api/index.js、dscp-html-manage/src/api/card/index.ts

请求参数

Header 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无（渠道统一鉴权头见《认证方式》）

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
无

路径参数及说明

参数名	参数值	是否必填	参数类型	描述说明
无

Body 请求参数

Body 类型 CardResourceRuleListRequest

参数名	参数值	是否必填	参数类型	描述说明
cardModelId	…	否	Long	旅游卡ID，关联旅游卡表id → card_resource_rule.card_model_id
type	…	否	String	资源类型 → card_resource_rule.type
resourceName	…	否	String	资源名称 → card_resource_rule.resource_name
status	…	否	Boolean	资源状态 → card_resource_rule.status
preferential	…	否	Preferential	优惠方式，1免费，2折扣，3优惠 → card_resource_rule.preferential 1＝免费 2＝折扣 3＝优惠
isAppointment	…	否	Boolean	是否需要预约 → card_resource_rule.is_appointment
createdTimeRange	…	否	Date[]	预约时间范围
idList	…	否	List<Long>	id列表
keywords	…	否	String	关键字

认证方式

免鉴权：@Route(auth = false) —— 该接口不校验登录态，改动前确认调用方与签名校验。

响应参数

data 类型 List<CardResourceRuleListResponse>

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	ID，主键 → card_resource_rule.id
cardModelId	…	否	Long	旅游卡ID，关联旅游卡表id → card_resource_rule.card_model_id
shopId	…	否	Long	商铺id → card_resource_rule.shop_id
goodsId	…	否	Long	资源ID，关联商品表id → card_resource_rule.goods_id
skuId	…	否	Long	skuid，关联sku表id → card_resource_rule.sku_id
resourceName	…	否	String	资源名称 → card_resource_rule.resource_name
type	…	否	String	资源类型 → card_resource_rule.type
shopName	…	否	String	所属商铺
status	…	否	Boolean	资源状态 → card_resource_rule.status
resourceStatus	…	否	ResourceStatus	→ card_resource_rule.resource_status 1＝已上架 2＝编辑中 3＝已下架
signEndTime	…	否	Date	签约到期日期 → card_resource_rule.sign_end_time
preferential	…	否	Preferential	优惠方式，1免费，2折扣，3优惠 → card_resource_rule.preferential 1＝免费 2＝折扣 3＝优惠
isAppointment	…	否	Boolean	是否需要预约 → card_resource_rule.is_appointment
advanceDays	…	否	Integer	预约提前天数 → card_resource_rule.advance_days
advanceHour	…	否	Integer	预约提前小时 → card_resource_rule.advance_hour
totalTimes	…	否	Integer	总共可使用次数（FREE 时有效，0 表示不限次） → card_resource_rule.total_times
createdTime	…	否	Date	创建时间 → card_resource_rule.created_time
ticketPriceModel	…	否	TicketPriceModel	签约门票定价方式 → card_resource_rule.ticket_price_model 1＝统一定价 2＝周期定价
ticketUniformPrice	…	否	Long	签约门票价 → card_resource_rule.ticket_uniform_price
ticketPeriodPrice	…	否	List<TicketPeriodPrice>	签约门票周期价 → card_resource_rule.ticket_period_price
price	…	否	Long	门票价
startDate	…	否	Date	开始时间
endDate	…	否	Date	结束时间
ticketPeriodBasePrice	…	否	Long	签约门票周期基础定价 → card_resource_rule.ticket_period_base_price
settlementWay	…	否	SettlementWay	结算方式 → card_resource_rule.settlement_way 1＝按刷卡次数 2＝买断 3＝分成 4＝按分配金额统一计算 5＝月度均衡分配计算
cardInstruction	…	否	String	持卡使用说明 → card_resource_rule.card_instruction
isAppointmentPay	…	否	Integer	预约是否需要付费 1是 → card_resource_rule.is_appointment_pay
appointmentPayAmount	…	否	Integer	付费金额（元） → card_resource_rule.appointment_pay_amount
isCheckRefund	…	否	Integer	入园后是否退款 1是 → card_resource_rule.is_check_refund

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "cardModelId": "1",
    "shopId": "1",
    "goodsId": "1",
    "skuId": "1",
    "resourceName": "\"string\"",
    "type": "\"string\"",
    "shopName": "\"string\"",
    "status": "false",
    "resourceStatus": "1",
    "signEndTime": "\"2026-01-01 00:00:00\"",
    "preferential": "1"
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：card_resource_rule　反查全部引用接口 →

CardResourceRuleController#queryCardResourceRuleList
CardResourceRuleService#queryList（CardResourceRuleServiceImpl）
CardResourceRuleMapper#queryList
BeanUtils.map → CardResourceRuleQuery
BeanUtils.mapList → CardResourceRuleListResponse

其它依赖：ShopCache.getQuietly

逻辑摘要：列表查询（cardResourceRuleService.queryList）；调用 isNotEmpty（StrUtil.isNotEmpty）；入参与返回值经 BeanUtils 做对象/分页映射

源码内联注释（旧站解析结果）

cardResourceRule.setResourceName(sku.getSkuName()); //资源名称
所属商铺
资源类型

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/card/index.ts:165　管理后台 · request
activity_h5/src/api/index.js:20　怀化社保卡活动 H5 · getCardListApi