POST/cardResourceCalender/queryAppointmentResourceCalenderListH5小程序

可预约卡日历 - 查询

旅游卡 / 资源档期与场次· CardResourceCalenderController#queryAppointmentResourceCalenderList

基本信息

接口状态脚手架生成·未接入前端置信度中
接口URLPOSThttps://dscp-dev.hn12301.net/h5-api/cardResourceCalender/queryAppointmentResourceCalenderList
请求方式POST
Content-Typeapplication/json
暴露渠道H5、小程序　前缀 /h5-api
名称来源源码注释
调用方本次扫描未发现调用　不等于可以下线
需求上下文可预约卡日历列表
维护人 / 最后改动luoli　2024-01-22　最近提交：可预约卡日历列表
读写数据表card_resource_calender、card_appointment、card_resource_rule、goods_relation　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.card.CardResourceCalenderController#queryAppointmentResourceCalenderList
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardResourceCalenderController.java:280
判定依据控制器由代码生成器产出（@author Chaos-Toolkits），整套 CRUD 接口但前端无调用

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 CardResourceCalenderListRequest

参数名	参数值	是否必填	参数类型	描述说明
ruleId	…	否	Long	资源规则ID,关联card_resource_rule表id → card_resource_calender.rule_id
keywords	…	否	String	关键字

认证方式

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

响应参数

data 类型 List<CardResourceCalenderListResponse>

参数名	参数值	是否必填	参数类型	描述说明
enableDate	…	否	Date	可预约日期 → card_resource_calender.enable_date
stock	…	否	Integer	库存 → card_resource_calender.stock
inventory	…	否	Integer	剩余预约数量
isEnabled	…	否	Boolean	是否可用，1可用，2不可用 → card_resource_calender.is_enabled
reason	…	否	String	→ card_resource_calender.reason
slotList	…	否	List<CardResourceCalenderTimeSlot>
id	…	否	Long	ID，主键 → card_resource_calender.id
ruleId	…	否	Long	资源规则ID → card_resource_calender.rule_id
enableDate	…	否	Date	时间段库存日期 → card_resource_calender.enable_date
name	…	否	String	名称 → card_appointment.name
time	…	否	String	时间段
totalStock	…	否	Integer	总库存数量 → card_resource_calender.total_stock
stock	…	否	Integer	库存数量 → card_resource_calender.stock
isEnabled	…	否	Boolean	是否可用，1可用，2不可用 → card_resource_calender.is_enabled
version	…	否	Integer	版本，乐观锁 → card_resource_calender.version
createdTime	…	否	Date	创建时间 → card_resource_calender.created_time
updatedTime	…	否	Date	修改时间 → card_resource_calender.updated_time

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "enableDate": "\"2026-01-01 00:00:00\"",
    "stock": "1",
    "inventory": "1",
    "isEnabled": "false",
    "reason": "\"string\"",
    "slotList": "[]",
    "id": "1",
    "ruleId": "1",
    "name": "\"string\"",
    "time": "\"string\"",
    "totalStock": "1"
  }
}

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

附录 · 实现细节

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

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

CardResourceCalenderController#queryAppointmentResourceCalenderList
CardResourceCalenderService#queryAppointmentResourceCalenderList（CardResourceCalenderServiceImpl）
CardAppointmentService#countActiveAppointments（CardAppointmentServiceImpl）
PftService#getScreeningsList（PftServiceImpl）
CardAppointmentService#countActiveAppointmentsGroupByTimeSlot（CardAppointmentServiceImpl）

其它依赖：RestTemplate.postForObject

逻辑摘要：列表查询（cardResourceCalenderService.queryAppointmentResourceCalenderList）