门票 tickets

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

TicketsCalendarController 7/7 在用

POST /tickets/addTicketsCalendar 在用管理后台 #

价格日历表-新增 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendartickets_sku

ControllerTicketsCalendarController#addTicketsCalendar

MapperTicketsCalendarService.getMapper#selectOne ⇒ 表 tickets_calendar

ServiceTicketsSkuService#get （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectById ⇒ 表 tickets_sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

TicketsCalendarService.addListTicketsCalendarService.updateList

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

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalendarAddRequest

字段	类型	表 / 列	说明
ticketsId	Long	`tickets_calendar`.`tickets_id`	单票id
skuId	Long	`tickets_calendar`.`sku_id`	单票skuID
enableDate	Date	`tickets_calendar`.`enable_date`	日期
enableDates	Date[]	—
salePrice	Integer	`tickets_calendar`.`sale_price`	卖价(分)
listPrice	Integer	`tickets_calendar`.`list_price`
totalStock	Integer	`tickets_calendar`.`total_stock`	总库存
stock	Integer	`tickets_calendar`.`stock`	可用库存
isEnabled	Boolean	`tickets_calendar`.`is_enabled`	状态
isDeleted	Boolean	`tickets_calendar`.`is_deleted`	是否删除(0否 1是)
reason	String	`tickets_calendar`.`reason`
createdBy	String	`tickets_calendar`.`created_by`	创建人
createdTime	Date	`tickets_calendar`.`created_time`
updatedBy	String	`tickets_calendar`.`updated_by`	修改人
updatedTime	Date	`tickets_calendar`.`updated_time`
version	Integer	`tickets_calendar`.`version`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/addTicketsCalendar

{
  "body": {
    "ticketsId": 1,
    "skuId": 1,
    "enableDate": "2026-01-01 12:00:00",
    "enableDates": "2026-01-01 12:00:00",
    "salePrice": 0,
    "listPrice": 0,
    "totalStock": 0,
    "stock": 0,
    "isEnabled": false,
    "isDeleted": false,
    "reason": "",
    "createdBy": "",
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00",
    "version": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 新增门票日历

逻辑摘要查询详情（ticketsSkuService.get）；查询详情（ticketsCalendarService.getMapper）；调用 isEmpty（CollectionUtils.isEmpty）

内联注释

查询是否日历库存已经存在
不存在则新增
否则修改
新增
修改

前端调用方

dscp-html-manage addTicketsCalendar exact

POST /tickets/deleteTicketsCalendar 在用管理后台 #

价格日历表-删除 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendar

ControllerTicketsCalendarController#deleteTicketsCalendar

ServiceTicketsCalendarService#delete （TicketsCalendarServiceImpl）

MapperTicketsCalendarMapper#deleteById ⇒ 表 tickets_calendar

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_calendar`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/deleteTicketsCalendar

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 删除门票日历

逻辑摘要删除（ticketsCalendarService.delete）

前端调用方

dscp-html-manage deleteTicketsCalendar exact

POST /tickets/getTicketsCalendar 在用管理后台 #

价格日历表-详情 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendar

ControllerTicketsCalendarController#getTicketsCalendar

ServiceTicketsCalendarService#get （TicketsCalendarServiceImpl）

MapperTicketsCalendarMapper#selectById ⇒ 表 tickets_calendar

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_calendar`.`id`	id

响应参数

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

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

data 结构　TicketsCalendarResponse　（object）

字段	类型	表 / 列	说明
id	Long	`tickets_calendar`.`id`
ticketsId	Long	`tickets_calendar`.`tickets_id`	单票id
skuId	Long	`tickets_calendar`.`sku_id`	单票skuID
enableDate	Date	`tickets_calendar`.`enable_date`	日期
salePrice	Integer	`tickets_calendar`.`sale_price`	卖价(分)
listPrice	Integer	`tickets_calendar`.`list_price`
totalStock	Integer	`tickets_calendar`.`total_stock`	总库存
stock	Integer	`tickets_calendar`.`stock`	可用库存
isEnabled	Boolean	`tickets_calendar`.`is_enabled`	状态
isDeleted	Boolean	`tickets_calendar`.`is_deleted`	是否删除(0否 1是)
reason	String	`tickets_calendar`.`reason`
version	Integer	`tickets_calendar`.`version`

示例

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

POST /tickets/getTicketsCalendar

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "ticketsId": 1,
    "skuId": 1,
    "enableDate": "2026-01-01 12:00:00",
    "salePrice": 0,
    "listPrice": 0,
    "totalStock": 0,
    "stock": 0,
    "isEnabled": false,
    "isDeleted": false,
    "reason": "",
    "version": 0
  }
}

处理逻辑

逻辑摘要查询详情（ticketsCalendarService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getTicketsCalendar exact

POST /tickets/queryTicketsCalendarList 在用管理后台 #

价格日历表-列表查询 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendar

ControllerTicketsCalendarController#queryTicketsCalendarList

转换BeanUtils.map → TicketsCalendarQuery

ServiceTicketsCalendarService#queryList （TicketsCalendarServiceImpl）

MapperTicketsCalendarMapper#selectList ⇒ 表 tickets_calendar

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalendarListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
skuId	Long			`tickets_calendar`.`sku_id`	单票skuID

响应参数

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

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

data 结构　List<TicketsCalendarResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`tickets_calendar`.`id`
ticketsId	Long	`tickets_calendar`.`tickets_id`	单票id
skuId	Long	`tickets_calendar`.`sku_id`	单票skuID
enableDate	Date	`tickets_calendar`.`enable_date`	日期
salePrice	Integer	`tickets_calendar`.`sale_price`	卖价(分)
listPrice	Integer	`tickets_calendar`.`list_price`
totalStock	Integer	`tickets_calendar`.`total_stock`	总库存
stock	Integer	`tickets_calendar`.`stock`	可用库存
isEnabled	Boolean	`tickets_calendar`.`is_enabled`	状态
isDeleted	Boolean	`tickets_calendar`.`is_deleted`	是否删除(0否 1是)
reason	String	`tickets_calendar`.`reason`
version	Integer	`tickets_calendar`.`version`

示例

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

POST /tickets/queryTicketsCalendarList

{
  "body": {
    "keywords": "",
    "skuId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "ticketsId": 1,
      "skuId": 1,
      "enableDate": "2026-01-01 12:00:00",
      "salePrice": 0,
      "listPrice": 0,
      "totalStock": 0,
      "stock": 0,
      "isEnabled": false,
      "isDeleted": false,
      "reason": "",
      "version": 0
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryTicketsCalendarList exact

POST /tickets/queryTicketsCalendarPage 在用管理后台 #

价格日历表-分页查询 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendar

ControllerTicketsCalendarController#queryTicketsCalendarPage

转换BeanUtils.map → TicketsCalendarQuery

ServiceTicketsCalendarService#queryPage （TicketsCalendarServiceImpl）

MapperTicketsCalendarMapper#selectPage ⇒ 表 tickets_calendar

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalendarPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
ticketsId	Long			`tickets_calendar`.`tickets_id`	单票id
skuId	Long			`tickets_calendar`.`sku_id`	单票skuID

响应参数

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

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

data 结构　PageInfo<TicketsCalendarResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`tickets_calendar`.`id`
ticketsId	Long	`tickets_calendar`.`tickets_id`	单票id
skuId	Long	`tickets_calendar`.`sku_id`	单票skuID
enableDate	Date	`tickets_calendar`.`enable_date`	日期
salePrice	Integer	`tickets_calendar`.`sale_price`	卖价(分)
listPrice	Integer	`tickets_calendar`.`list_price`
totalStock	Integer	`tickets_calendar`.`total_stock`	总库存
stock	Integer	`tickets_calendar`.`stock`	可用库存
isEnabled	Boolean	`tickets_calendar`.`is_enabled`	状态
isDeleted	Boolean	`tickets_calendar`.`is_deleted`	是否删除(0否 1是)
reason	String	`tickets_calendar`.`reason`
version	Integer	`tickets_calendar`.`version`

示例

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

POST /tickets/queryTicketsCalendarPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "ticketsId": 1,
    "skuId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "ticketsId": 1,
        "skuId": 1,
        "enableDate": "2026-01-01 12:00:00",
        "salePrice": 0,
        "listPrice": 0,
        "totalStock": 0,
        "stock": 0,
        "isEnabled": false,
        "isDeleted": false,
        "reason": "",
        "version": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（ticketsCalendarService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryTicketsCalendarPage exact

POST /tickets/setTicketsEnabled 在用管理后台 #

卡日历库存-设置 - 不可用日期 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendar

ControllerTicketsCalendarController#setTicketsEnabled

MapperTicketsCalendarService.getMapper#selectOne ⇒ 表 tickets_calendar

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

ChaosTransactionTemplate.executeTicketsCalendarService.addListTicketsCalendarService.updateList

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalenderEnabledRequest

字段	类型	必填	取值/校验	表 / 列	说明
skuId	Long	是	必填	`tickets_calendar`.`sku_id`	资源规则ID,关联card_resource_rule表id
unavailableDateStart	Date	是	必填	—	不可用开始日期
unavailableDateEnd	Date	是	必填	—	不可用结束日期
reason	String			`tickets_calendar`.`reason`	不可用原因

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/setTicketsEnabled

{
  "body": {
    "skuId": 1,
    "unavailableDateStart": "2026-01-01 12:00:00",
    "unavailableDateEnd": "2026-01-01 12:00:00",
    "reason": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 设置门票启用

逻辑摘要列表查询（DateUtil.rangeToList）；查询详情（ticketsCalendarService.getMapper）；调用 execute（newTransactionTemplate.execute）

内联注释

获取起始日期时间和结束日期时间的时间区间集合
查询是否日历库存已经存在
存在则新增
否则修改
新增
修改
回滚事务
处理异常

前端调用方

dscp-html-manage setTicketsEnabled exact

POST /tickets/updateTicketsCalendar 在用管理后台 #

价格日历表-更新 · TicketsCalendarController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calendar

ControllerTicketsCalendarController#updateTicketsCalendar

转换BeanUtils.map → TicketsCalendar ⇒ 表 tickets_calendar

ServiceTicketsCalendarService#update （TicketsCalendarServiceImpl）

MapperTicketsCalendarMapper#updateById ⇒ 表 tickets_calendar

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalendarUpdateRequest

字段	类型	表 / 列	说明
id	Long	`tickets_calendar`.`id`
ticketsId	Long	`tickets_calendar`.`tickets_id`	单票id
skuId	Long	`tickets_calendar`.`sku_id`	单票skuID
enableDate	Date	`tickets_calendar`.`enable_date`	日期
salePrice	Integer	`tickets_calendar`.`sale_price`	卖价(分)
listPrice	Integer	`tickets_calendar`.`list_price`
totalStock	Integer	`tickets_calendar`.`total_stock`	总库存
stock	Integer	`tickets_calendar`.`stock`	可用库存
isEnabled	Boolean	`tickets_calendar`.`is_enabled`	状态
isDeleted	Boolean	`tickets_calendar`.`is_deleted`	是否删除(0否 1是)
reason	String	`tickets_calendar`.`reason`
createdBy	String	`tickets_calendar`.`created_by`	创建人
createdTime	Date	`tickets_calendar`.`created_time`
updatedBy	String	`tickets_calendar`.`updated_by`	修改人
updatedTime	Date	`tickets_calendar`.`updated_time`
version	Integer	`tickets_calendar`.`version`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/updateTicketsCalendar

{
  "body": {
    "id": 1,
    "ticketsId": 1,
    "skuId": 1,
    "enableDate": "2026-01-01 12:00:00",
    "salePrice": 0,
    "listPrice": 0,
    "totalStock": 0,
    "stock": 0,
    "isEnabled": false,
    "isDeleted": false,
    "reason": "",
    "createdBy": "",
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00",
    "version": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 更新门票日历

逻辑摘要更新（ticketsCalendarService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateTicketsCalendar exact

TicketsCalenderTimeSlotController 3/6 在用

POST /tickets/addTicketsCalenderTimeSlot 在用管理后台 #

时间段日历库存-新增/更新 · TicketsCalenderTimeSlotController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calender_time_slottickets_sku

ControllerTicketsCalenderTimeSlotController#addTicketsCalenderTimeSlot

MapperTicketsCalenderTimeSlotService.getMapper#selectList ⇒ 表 tickets_calender_time_slot

MapperTicketsCalenderTimeSlotService.getMapper#deleteBatchIds ⇒ 表 tickets_calender_time_slot

ServiceTicketsSkuService#get （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectById ⇒ 表 tickets_sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

TicketsCalenderTimeSlotService.addList

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalenderTimeSlotAddListRequest

字段	类型	必填	取值/校验	表 / 列	说明
skuId	Long	是	必填	`tickets_calender_time_slot`.`sku_id`
enableDates	Date[]			—	选择日期
timeSlotList	List<TicketsCalenderTimeSlotAddRequest>			—	设置
timeSlotList[].skuId	Long			`tickets_calender_time_slot`.`sku_id`	单票skuID
timeSlotList[].enableDate	Date			`tickets_calender_time_slot`.`enable_date`	时间段库存日期
timeSlotList[].name	String			`tickets_calender_time_slot`.`name`	名称
timeSlotList[].time	String			`tickets_calender_time_slot`.`time`	时间段
timeSlotList[].totalStock	Integer			`tickets_calender_time_slot`.`total_stock`	总库存数量
timeSlotList[].stock	Integer			`tickets_calender_time_slot`.`stock`	库存数量
timeSlotList[].salePrice	Integer			`tickets_calender_time_slot`.`sale_price`	卖价(分)
timeSlotList[].isEnabled	Boolean			`tickets_calender_time_slot`.`is_enabled`	是否可用，1可用，2不可用

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/addTicketsCalenderTimeSlot

{
  "body": {
    "skuId": 1,
    "enableDates": "2026-01-01 12:00:00",
    "timeSlotList": [
      {
        "skuId": 1,
        "enableDate": "2026-01-01 12:00:00",
        "name": "",
        "time": "2026-01-01 12:00:00",
        "totalStock": 0,
        "stock": 0,
        "salePrice": 0,
        "isEnabled": false
      }
    ]
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 新增门票日历时段

逻辑摘要查询详情（ticketsSkuService.get）；查询详情（ticketsCalenderTimeSlotService.getMapper）；调用 isEmpty（CollectionUtils.isEmpty）

内联注释

查询是否日历库存已经存在
存在则删除
新增

前端调用方

dscp-html-manage addTicketsCalenderTimeSlot exact

POST /tickets/deleteTicketsCalenderTimeSlot 在用管理后台 #

时间段日历库存-删除 · TicketsCalenderTimeSlotController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calender_time_slot

ControllerTicketsCalenderTimeSlotController#deleteTicketsCalenderTimeSlot

ServiceTicketsCalenderTimeSlotService#delete （TicketsCalenderTimeSlotServiceImpl）

MapperTicketsCalenderTimeSlotMapper#deleteById ⇒ 表 tickets_calender_time_slot

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_calender_time_slot`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/deleteTicketsCalenderTimeSlot

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 删除门票日历时段

逻辑摘要删除（ticketsCalenderTimeSlotService.delete）

前端调用方

dscp-html-manage deleteTicketsCalenderTimeSlot exact

POST /tickets/getTicketsCalenderTimeSlot 未使用管理后台 #

时间段日历库存-详情 · TicketsCalenderTimeSlotController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calender_time_slot

ControllerTicketsCalenderTimeSlotController#getTicketsCalenderTimeSlot

ServiceTicketsCalenderTimeSlotService#get （TicketsCalenderTimeSlotServiceImpl）

MapperTicketsCalenderTimeSlotMapper#selectById ⇒ 表 tickets_calender_time_slot

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_calender_time_slot`.`id`	id

响应参数

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

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

data 结构　TicketsCalenderTimeSlotResponse　（object）

字段	类型	表 / 列	说明
enableDate	Date	`tickets_calender_time_slot`.`enable_date`	日期
timeSlotList	List<TicketsCalenderTimeSlot>	—	设置
timeSlotList[].id	Long	`tickets_calender_time_slot`.`id`	ID，主键
timeSlotList[].ticketsId	Long	`tickets_calender_time_slot`.`tickets_id`	单票id
timeSlotList[].skuId	Long	`tickets_calender_time_slot`.`sku_id`	单票skuID
timeSlotList[].enableDate	Date	`tickets_calender_time_slot`.`enable_date`	时间段库存日期
timeSlotList[].name	String	`tickets_calender_time_slot`.`name`	名称
timeSlotList[].time	String	`tickets_calender_time_slot`.`time`	时间段
timeSlotList[].totalStock	Integer	`tickets_calender_time_slot`.`total_stock`	总库存数量
timeSlotList[].stock	Integer	`tickets_calender_time_slot`.`stock`	库存数量
timeSlotList[].salePrice	Integer	`tickets_calender_time_slot`.`sale_price`	卖价(分)
timeSlotList[].isEnabled	Boolean	`tickets_calender_time_slot`.`is_enabled`	是否可用，1可用，2不可用
timeSlotList[].version	Integer	`tickets_calender_time_slot`.`version`	版本，乐观锁
timeSlotList[].createdTime	Date	`tickets_calender_time_slot`.`created_time`	创建时间
timeSlotList[].updatedTime	Date	`tickets_calender_time_slot`.`updated_time`	修改时间

示例

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

POST /tickets/getTicketsCalenderTimeSlot

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "enableDate": "2026-01-01 12:00:00",
    "timeSlotList": [
      {
        "id": 1,
        "ticketsId": 1,
        "skuId": 1,
        "enableDate": "2026-01-01 12:00:00",
        "name": "",
        "time": "2026-01-01 12:00:00",
        "totalStock": 0,
        "stock": 0,
        "salePrice": 0,
        "isEnabled": false,
        "version": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ]
  }
}

处理逻辑

逻辑摘要查询详情（ticketsCalenderTimeSlotService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

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

POST /tickets/queryTicketsCalenderTimeSlotList 在用管理后台 #

时间段日历库存-列表查询 · TicketsCalenderTimeSlotController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calender_time_slot

ControllerTicketsCalenderTimeSlotController#queryTicketsCalenderTimeSlotList

转换BeanUtils.map → TicketsCalenderTimeSlotQuery

ServiceTicketsCalenderTimeSlotService#queryList （TicketsCalenderTimeSlotServiceImpl）

MapperTicketsCalenderTimeSlotMapper#selectList ⇒ 表 tickets_calender_time_slot

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalenderTimeSlotListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
skuId	Long			`tickets_calender_time_slot`.`sku_id`
date	String			—

响应参数

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

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

data 结构　List<TicketsCalenderTimeSlotResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
enableDate	Date	`tickets_calender_time_slot`.`enable_date`	日期
timeSlotList	List<TicketsCalenderTimeSlot>	—	设置
timeSlotList[].id	Long	`tickets_calender_time_slot`.`id`	ID，主键
timeSlotList[].ticketsId	Long	`tickets_calender_time_slot`.`tickets_id`	单票id
timeSlotList[].skuId	Long	`tickets_calender_time_slot`.`sku_id`	单票skuID
timeSlotList[].enableDate	Date	`tickets_calender_time_slot`.`enable_date`	时间段库存日期
timeSlotList[].name	String	`tickets_calender_time_slot`.`name`	名称
timeSlotList[].time	String	`tickets_calender_time_slot`.`time`	时间段
timeSlotList[].totalStock	Integer	`tickets_calender_time_slot`.`total_stock`	总库存数量
timeSlotList[].stock	Integer	`tickets_calender_time_slot`.`stock`	库存数量
timeSlotList[].salePrice	Integer	`tickets_calender_time_slot`.`sale_price`	卖价(分)
timeSlotList[].isEnabled	Boolean	`tickets_calender_time_slot`.`is_enabled`	是否可用，1可用，2不可用
timeSlotList[].version	Integer	`tickets_calender_time_slot`.`version`	版本，乐观锁
timeSlotList[].createdTime	Date	`tickets_calender_time_slot`.`created_time`	创建时间
timeSlotList[].updatedTime	Date	`tickets_calender_time_slot`.`updated_time`	修改时间

示例

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

POST /tickets/queryTicketsCalenderTimeSlotList

{
  "body": {
    "keywords": "",
    "skuId": 1,
    "date": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "enableDate": "2026-01-01 12:00:00",
      "timeSlotList": [
        {
          "id": 1,
          "ticketsId": 1,
          "skuId": 1,
          "enableDate": "2026-01-01 12:00:00",
          "name": "",
          "time": "2026-01-01 12:00:00",
          "totalStock": 0,
          "stock": 0,
          "salePrice": 0,
          "isEnabled": false,
          "version": 0,
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ]
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryTicketsCalenderTimeSlotList exact

POST /tickets/queryTicketsCalenderTimeSlotPage 未使用管理后台 #

时间段日历库存-分页查询 · TicketsCalenderTimeSlotController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calender_time_slot

ControllerTicketsCalenderTimeSlotController#queryTicketsCalenderTimeSlotPage

转换BeanUtils.map → TicketsCalenderTimeSlotQuery

ServiceTicketsCalenderTimeSlotService#queryPage （TicketsCalenderTimeSlotServiceImpl）

MapperTicketsCalenderTimeSlotMapper#selectPage ⇒ 表 tickets_calender_time_slot

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalenderTimeSlotPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　PageInfo<TicketsCalenderTimeSlotResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
enableDate	Date	`tickets_calender_time_slot`.`enable_date`	日期
timeSlotList	List<TicketsCalenderTimeSlot>	—	设置
timeSlotList[].id	Long	`tickets_calender_time_slot`.`id`	ID，主键
timeSlotList[].ticketsId	Long	`tickets_calender_time_slot`.`tickets_id`	单票id
timeSlotList[].skuId	Long	`tickets_calender_time_slot`.`sku_id`	单票skuID
timeSlotList[].enableDate	Date	`tickets_calender_time_slot`.`enable_date`	时间段库存日期
timeSlotList[].name	String	`tickets_calender_time_slot`.`name`	名称
timeSlotList[].time	String	`tickets_calender_time_slot`.`time`	时间段
timeSlotList[].totalStock	Integer	`tickets_calender_time_slot`.`total_stock`	总库存数量
timeSlotList[].stock	Integer	`tickets_calender_time_slot`.`stock`	库存数量
timeSlotList[].salePrice	Integer	`tickets_calender_time_slot`.`sale_price`	卖价(分)
timeSlotList[].isEnabled	Boolean	`tickets_calender_time_slot`.`is_enabled`	是否可用，1可用，2不可用
timeSlotList[].version	Integer	`tickets_calender_time_slot`.`version`	版本，乐观锁
timeSlotList[].createdTime	Date	`tickets_calender_time_slot`.`created_time`	创建时间
timeSlotList[].updatedTime	Date	`tickets_calender_time_slot`.`updated_time`	修改时间

示例

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

POST /tickets/queryTicketsCalenderTimeSlotPage

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "enableDate": "2026-01-01 12:00:00",
        "timeSlotList": [
          {
            "id": 1,
            "ticketsId": 1,
            "skuId": 1,
            "enableDate": "2026-01-01 12:00:00",
            "name": "",
            "time": "2026-01-01 12:00:00",
            "totalStock": 0,
            "stock": 0,
            "salePrice": 0,
            "isEnabled": false,
            "version": 0,
            "createdTime": "2026-01-01 12:00:00",
            "updatedTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（ticketsCalenderTimeSlotService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

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

POST /tickets/updateTicketsCalenderTimeSlot 未使用管理后台 #

时间段日历库存-更新 · TicketsCalenderTimeSlotController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_calender_time_slot

ControllerTicketsCalenderTimeSlotController#updateTicketsCalenderTimeSlot

转换BeanUtils.map → TicketsCalenderTimeSlot ⇒ 表 tickets_calender_time_slot

ServiceTicketsCalenderTimeSlotService#update （TicketsCalenderTimeSlotServiceImpl）

MapperTicketsCalenderTimeSlotMapper#updateById ⇒ 表 tickets_calender_time_slot

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCalenderTimeSlotUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`tickets_calender_time_slot`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/updateTicketsCalenderTimeSlot

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 更新门票日历时段

逻辑摘要更新（ticketsCalenderTimeSlotService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

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

TicketsCheckController 5/10 在用

POST /tickets/addTicketsCheck 在用开放/回调 #

核销员核销接口单票核销表-新增 · TicketsCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsCheckController#addTicketsCheck
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表checkertickets_order_touristchecker_tickets_relationtickets_ordertickets_order_goodsticketsmembertickets_skutickets_checkorder

ControllerTicketsCheckController#addTicketsCheck

ServiceCheckerService#get （CheckerServiceImpl）

MapperCheckerMapper#selectById ⇒ 表 checker

ServiceTicketsOrderTouristService#get （TicketsOrderTouristServiceImpl）

MapperTicketsOrderTouristMapper#selectById ⇒ 表 tickets_order_tourist

ServiceCheckerTicketsRelationService#queryList （CheckerTicketsRelationServiceImpl）

MapperCheckerTicketsRelationMapper#selectList ⇒ 表 checker_tickets_relation

ServiceTicketsOrderService#get （TicketsOrderServiceImpl）

MapperTicketsOrderMapper#selectById ⇒ 表 tickets_order

ServiceTicketsOrderGoodsService#get （TicketsOrderGoodsServiceImpl）

MapperTicketsOrderGoodsMapper#selectById ⇒ 表 tickets_order_goods

ServiceTicketsService#get （TicketsServiceImpl）

MapperTicketsMapper#selectById ⇒ 表 tickets

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceTicketsSkuService#get （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectById ⇒ 表 tickets_sku

ServiceTicketsOrderTouristService#update （TicketsOrderTouristServiceImpl）

MapperTicketsOrderTouristMapper#updateById ⇒ 表 tickets_order_tourist

ServiceTicketsOrderTouristService#queryList （TicketsOrderTouristServiceImpl）

MapperTicketsOrderTouristMapper#selectList ⇒ 表 tickets_order_tourist

ServiceTicketsOrderService#update （TicketsOrderServiceImpl）

MapperTicketsOrderMapper#updateById ⇒ 表 tickets_order

ServiceTicketsCheckService#add （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#insert ⇒ 表 tickets_check

ServiceXghService#syncOrder （XghServiceImpl）

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ShopCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCheckAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
userId	Long	是	必填	—
skuId	String			`checker_tickets_relation`.`sku_id`	@NotEmpty(message = "skuId不能为空")
checkCode	String	是	必填	—

响应参数

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

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

data 结构　TicketsAddCheckResponse　（object）

字段	类型	表 / 列	说明
skuName	String	`tickets_sku`.`sku_name`
typeId	String	`tickets`.`type_id`
useDate	String	—	使用日期
enterDemand	String	`tickets_sku`.`enter_demand`
name	String	`tickets_order_tourist`.`name`
idNo	String	—
mobile	String	`checker`.`mobile`
contactName	String	—
contactMobile	String	—
status	String	`checker`.`status`
checkerName	String	`tickets_check`.`checker_name`
checkTime	Date	`tickets_check`.`check_time`
timeSlot	String	`tickets_order_goods`.`time_slot`
checkMsg	String	—	核销信息
checkCode	String	—	0 成功的 500 失败的

示例

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

POST /tickets/addTicketsCheck

{
  "body": {
    "userId": 1,
    "skuId": "",
    "checkCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "skuName": "",
    "typeId": "",
    "useDate": "2026-01-01 12:00:00",
    "enterDemand": "",
    "name": "",
    "idNo": "",
    "mobile": "13800000000",
    "contactName": "",
    "contactMobile": "13800000000",
    "status": "",
    "checkerName": "",
    "checkTime": "2026-01-01 12:00:00",
    "timeSlot": "2026-01-01 12:00:00",
    "checkMsg": "",
    "checkCode": ""
  }
}

处理逻辑

操作日志tickets / 新增门票核销

逻辑摘要查询详情（checkerService.get）；查询详情（ticketsOrderTouristService.get）；列表查询（ticketsRelationService.queryList）

内联注释

throw ChaosRes.SYS_FAIL.toException("核销码已核销或已退款");
查询商品信息
throw ChaosRes.SYS_FAIL.toException("核销日期错误");
判断订单是否已完成
同步订单信息到湘工惠

前端调用方

writeoff addTicketsCheck exact

POST /tickets/countTicketsCheckToday 在用开放/回调 #

（无摘要） · TicketsCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsCheckController#countTicketsCheckToday
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerTicketsCheckController#countTicketsCheckToday

MapperTicketsCheckService.getMapper#queryList ⇒ 表 tickets_check

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

TicketsCheckService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCheckListRequest

字段	类型	表 / 列	说明
keywords	String	—	关键字
checkerId	Long	`tickets_check`.`checker_id`
name	String	`tickets_check`.`name`	持卡人姓名
phone	String	`tickets_check`.`phone`	手机号码
orderNo	String	—
checkTimeRange	Date[]	—
ticketsSkuId	Long	`tickets_check`.`tickets_sku_id`
ticketsId	Long	`tickets_check`.`tickets_id`
ticketsName	String	`tickets_check`.`tickets_name`
shopId	Long	`tickets_check`.`shop_id`
shopName	String	`tickets_check`.`shop_name`

响应参数

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

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

data 结构　Integer　（scalar）

标量/Map/外部类型：Integer

示例

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

POST /tickets/countTicketsCheckToday

{
  "body": {
    "keywords": "",
    "checkerId": 1,
    "name": "",
    "phone": "13800000000",
    "orderNo": "",
    "checkTimeRange": "2026-01-01 12:00:00",
    "ticketsSkuId": 1,
    "ticketsId": 1,
    "ticketsName": "",
    "shopId": 1,
    "shopName": ""
  }
}

响应示例

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

处理逻辑

逻辑摘要调用 applyWrapper（ticketsCheckService.applyWrapper）；调用 beginOfDay（DateUtil.beginOfDay）；调用 endOfDay（DateUtil.endOfDay）

前端调用方

writeoff countTicketsCheckToday exact

POST /tickets/deleteTicketsCheck 未使用管理后台 #

单票核销表-删除 · TicketsCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerTicketsCheckController#deleteTicketsCheck

ServiceTicketsCheckService#delete （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#deleteById ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_check`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/deleteTicketsCheck

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 删除门票核销

逻辑摘要删除（ticketsCheckService.delete）

前端调用方

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

POST /tickets/exportTicketsCheckPage 未使用管理后台 #

（无摘要） · TicketsCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerTicketsCheckController#exportTicketsCheckPage

转换BeanUtils.mapList → TicketsCheckQuery

ServiceTicketsCheckService#queryList （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#selectList ⇒ 表 tickets_check

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ShopCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　HttpServletResponse

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

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/exportTicketsCheckPage

响应示例

（void，无响应体）

处理逻辑

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

前端调用方

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

POST /tickets/getTicketsCheck 未使用管理后台 #

单票核销表-详情 · TicketsCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerTicketsCheckController#getTicketsCheck

ServiceTicketsCheckService#get （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#selectById ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_check`.`id`	id

响应参数

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

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

data 结构　TicketsCheckResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`tickets_check`.`id`	id
orderId	Long		`tickets_check`.`order_id`	订单号，order表id
orderTouristId	Long		`tickets_check`.`order_tourist_id`	订单号，order表id
ticketsId	Long		`tickets_check`.`tickets_id`
ticketsName	String		`tickets_check`.`tickets_name`
ticketsSkuId	Long		`tickets_check`.`tickets_sku_id`	产品SKU id，sku表id
ticketsSkuIdType	String		—
useDate	String		—
ticketsSkuName	String		`tickets_check`.`tickets_sku_name`	产品SKU
checkerId	Long		`tickets_check`.`checker_id`	核销人
checkerName	String		`tickets_check`.`checker_name`	核销人姓名
checkTime	Date		`tickets_check`.`check_time`	核销时间
name	String		`tickets_check`.`name`	持卡人姓名
phone	String		`tickets_check`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_check`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_check`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_check`.`is_deleted`	是否删除
status	Integer		`tickets_check`.`status`	状态
updatedBy	String		`tickets_check`.`updated_by`
updatedTime	Date		`tickets_check`.`updated_time`
createdBy	String		`tickets_check`.`created_by`
createdTime	Date		`tickets_check`.`created_time`
qrcode	String		`tickets_check`.`qrcode`
shopId	Long		`tickets_check`.`shop_id`
shopName	String		`tickets_check`.`shop_name`

示例

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

POST /tickets/getTicketsCheck

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orderId": 1,
    "orderTouristId": 1,
    "ticketsId": 1,
    "ticketsName": "",
    "ticketsSkuId": 1,
    "ticketsSkuIdType": "",
    "useDate": "2026-01-01 12:00:00",
    "ticketsSkuName": "",
    "checkerId": 1,
    "checkerName": "",
    "checkTime": "2026-01-01 12:00:00",
    "name": "",
    "phone": "13800000000",
    "idType": "1",
    "identityNo": "",
    "isDeleted": false,
    "status": 0,
    "updatedBy": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00",
    "createdBy": "",
    "createdTime": "2026-01-01 12:00:00",
    "qrcode": "",
    "shopId": 1,
    "shopName": ""
  }
}

处理逻辑

逻辑摘要查询详情（ticketsCheckService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

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

POST /tickets/queryTicketsCheck 在用开放/回调 #

（无摘要） · TicketsCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsCheckController#queryTicketsCheck
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_checktickets_sku

ControllerTicketsCheckController#queryTicketsCheck

转换BeanUtils.mapList → TicketsCheckResponse

MapperTicketsCheckService.getMapper#queryList ⇒ 表 tickets_check

ServiceTicketsSkuService#get （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectById ⇒ 表 tickets_sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

TicketsCheckService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCheckListRequest

字段	类型	表 / 列	说明
keywords	String	—	关键字
checkerId	Long	`tickets_check`.`checker_id`
name	String	`tickets_check`.`name`	持卡人姓名
phone	String	`tickets_check`.`phone`	手机号码
orderNo	String	—
checkTimeRange	Date[]	—
ticketsSkuId	Long	`tickets_check`.`tickets_sku_id`
ticketsId	Long	`tickets_check`.`tickets_id`
ticketsName	String	`tickets_check`.`tickets_name`
shopId	Long	`tickets_check`.`shop_id`
shopName	String	`tickets_check`.`shop_name`

响应参数

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

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

data 结构　List<TicketsCheckResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets_check`.`id`	id
orderId	Long		`tickets_check`.`order_id`	订单号，order表id
orderTouristId	Long		`tickets_check`.`order_tourist_id`	订单号，order表id
ticketsId	Long		`tickets_check`.`tickets_id`
ticketsName	String		`tickets_check`.`tickets_name`
ticketsSkuId	Long		`tickets_check`.`tickets_sku_id`	产品SKU id，sku表id
ticketsSkuIdType	String		—
useDate	String		—
ticketsSkuName	String		`tickets_check`.`tickets_sku_name`	产品SKU
checkerId	Long		`tickets_check`.`checker_id`	核销人
checkerName	String		`tickets_check`.`checker_name`	核销人姓名
checkTime	Date		`tickets_check`.`check_time`	核销时间
name	String		`tickets_check`.`name`	持卡人姓名
phone	String		`tickets_check`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_check`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_check`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_check`.`is_deleted`	是否删除
status	Integer		`tickets_check`.`status`	状态
updatedBy	String		`tickets_check`.`updated_by`
updatedTime	Date		`tickets_check`.`updated_time`
createdBy	String		`tickets_check`.`created_by`
createdTime	Date		`tickets_check`.`created_time`
qrcode	String		`tickets_check`.`qrcode`
shopId	Long		`tickets_check`.`shop_id`
shopName	String		`tickets_check`.`shop_name`

示例

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

POST /tickets/queryTicketsCheck

{
  "body": {
    "keywords": "",
    "checkerId": 1,
    "name": "",
    "phone": "13800000000",
    "orderNo": "",
    "checkTimeRange": "2026-01-01 12:00:00",
    "ticketsSkuId": 1,
    "ticketsId": 1,
    "ticketsName": "",
    "shopId": 1,
    "shopName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orderId": 1,
      "orderTouristId": 1,
      "ticketsId": 1,
      "ticketsName": "",
      "ticketsSkuId": 1,
      "ticketsSkuIdType": "",
      "useDate": "2026-01-01 12:00:00",
      "ticketsSkuName": "",
      "checkerId": 1,
      "checkerName": "",
      "checkTime": "2026-01-01 12:00:00",
      "name": "",
      "phone": "13800000000",
      "idType": "1",
      "identityNo": "",
      "isDeleted": false,
      "status": 0,
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "qrcode": "",
      "shopId": 1,
      "shopName": ""
    }
  ]
}

处理逻辑

逻辑摘要调用 applyWrapper（ticketsCheckService.applyWrapper）；调用 isNotEmpty（StrUtil.isNotEmpty）；查询详情（ticketsCheckService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

writeoff queryTicketsCheck exact

POST /tickets/queryTicketsCheckList 未使用管理后台 #

单票核销表-列表查询 · TicketsCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerTicketsCheckController#queryTicketsCheckList

转换BeanUtils.map → TicketsCheckQuery

ServiceTicketsCheckService#queryList （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#selectList ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCheckListRequest

字段	类型	表 / 列	说明
keywords	String	—	关键字
checkerId	Long	`tickets_check`.`checker_id`
name	String	`tickets_check`.`name`	持卡人姓名
phone	String	`tickets_check`.`phone`	手机号码
orderNo	String	—
checkTimeRange	Date[]	—
ticketsSkuId	Long	`tickets_check`.`tickets_sku_id`
ticketsId	Long	`tickets_check`.`tickets_id`
ticketsName	String	`tickets_check`.`tickets_name`
shopId	Long	`tickets_check`.`shop_id`
shopName	String	`tickets_check`.`shop_name`

响应参数

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

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

data 结构　List<TicketsCheckResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets_check`.`id`	id
orderId	Long		`tickets_check`.`order_id`	订单号，order表id
orderTouristId	Long		`tickets_check`.`order_tourist_id`	订单号，order表id
ticketsId	Long		`tickets_check`.`tickets_id`
ticketsName	String		`tickets_check`.`tickets_name`
ticketsSkuId	Long		`tickets_check`.`tickets_sku_id`	产品SKU id，sku表id
ticketsSkuIdType	String		—
useDate	String		—
ticketsSkuName	String		`tickets_check`.`tickets_sku_name`	产品SKU
checkerId	Long		`tickets_check`.`checker_id`	核销人
checkerName	String		`tickets_check`.`checker_name`	核销人姓名
checkTime	Date		`tickets_check`.`check_time`	核销时间
name	String		`tickets_check`.`name`	持卡人姓名
phone	String		`tickets_check`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_check`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_check`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_check`.`is_deleted`	是否删除
status	Integer		`tickets_check`.`status`	状态
updatedBy	String		`tickets_check`.`updated_by`
updatedTime	Date		`tickets_check`.`updated_time`
createdBy	String		`tickets_check`.`created_by`
createdTime	Date		`tickets_check`.`created_time`
qrcode	String		`tickets_check`.`qrcode`
shopId	Long		`tickets_check`.`shop_id`
shopName	String		`tickets_check`.`shop_name`

示例

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

POST /tickets/queryTicketsCheckList

{
  "body": {
    "keywords": "",
    "checkerId": 1,
    "name": "",
    "phone": "13800000000",
    "orderNo": "",
    "checkTimeRange": "2026-01-01 12:00:00",
    "ticketsSkuId": 1,
    "ticketsId": 1,
    "ticketsName": "",
    "shopId": 1,
    "shopName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orderId": 1,
      "orderTouristId": 1,
      "ticketsId": 1,
      "ticketsName": "",
      "ticketsSkuId": 1,
      "ticketsSkuIdType": "",
      "useDate": "2026-01-01 12:00:00",
      "ticketsSkuName": "",
      "checkerId": 1,
      "checkerName": "",
      "checkTime": "2026-01-01 12:00:00",
      "name": "",
      "phone": "13800000000",
      "idType": "1",
      "identityNo": "",
      "isDeleted": false,
      "status": 0,
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "qrcode": "",
      "shopId": 1,
      "shopName": ""
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /tickets/queryTicketsCheckPage 在用开放/回调 #

单票核销表-分页查询 · TicketsCheckController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsCheckController#queryTicketsCheckPage
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_ordertickets_check

ControllerTicketsCheckController#queryTicketsCheckPage

转换BeanUtils.map → TicketsCheckQuery

ServiceTicketsOrderService#get （TicketsOrderServiceImpl）

MapperTicketsOrderMapper#selectById ⇒ 表 tickets_order

ServiceTicketsCheckService#queryPage （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#selectPage ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCheckPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
checkerId	Long			`tickets_check`.`checker_id`
name	String			`tickets_check`.`name`	持卡人姓名
phone	String			`tickets_check`.`phone`	手机号码
orderNo	String			`tickets_order`.`order_no`
checkTimeRange	Date[]			—
ticketsSkuId	Long			`tickets_check`.`tickets_sku_id`
ticketsId	Long			`tickets_check`.`tickets_id`
ticketsName	String			`tickets_check`.`tickets_name`
shopId	Long			`tickets_order`.`shop_id`
shopName	String			`tickets_check`.`shop_name`

响应参数

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

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

data 结构　PageInfo<TicketsCheckResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`tickets_order`.`id`	id
orderId	Long		`tickets_check`.`order_id`	订单号，order表id
orderTouristId	Long		`tickets_check`.`order_tourist_id`	订单号，order表id
ticketsId	Long		`tickets_check`.`tickets_id`
ticketsName	String		`tickets_check`.`tickets_name`
ticketsSkuId	Long		`tickets_check`.`tickets_sku_id`	产品SKU id，sku表id
ticketsSkuIdType	String		—
useDate	String		—
ticketsSkuName	String		`tickets_check`.`tickets_sku_name`	产品SKU
checkerId	Long		`tickets_check`.`checker_id`	核销人
checkerName	String		`tickets_check`.`checker_name`	核销人姓名
checkTime	Date		`tickets_check`.`check_time`	核销时间
name	String		`tickets_check`.`name`	持卡人姓名
phone	String		`tickets_check`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_check`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_check`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_check`.`is_deleted`	是否删除
status	Integer		`tickets_check`.`status`	状态
updatedBy	String		`tickets_order`.`updated_by`
updatedTime	Date		`tickets_order`.`updated_time`
createdBy	String		`tickets_order`.`created_by`
createdTime	Date		`tickets_order`.`created_time`
qrcode	String		`tickets_check`.`qrcode`
shopId	Long		`tickets_order`.`shop_id`
shopName	String		`tickets_check`.`shop_name`

示例

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

POST /tickets/queryTicketsCheckPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "checkerId": 1,
    "name": "",
    "phone": "13800000000",
    "orderNo": "",
    "checkTimeRange": "2026-01-01 12:00:00",
    "ticketsSkuId": 1,
    "ticketsId": 1,
    "ticketsName": "",
    "shopId": 1,
    "shopName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderId": 1,
        "orderTouristId": 1,
        "ticketsId": 1,
        "ticketsName": "",
        "ticketsSkuId": 1,
        "ticketsSkuIdType": "",
        "useDate": "2026-01-01 12:00:00",
        "ticketsSkuName": "",
        "checkerId": 1,
        "checkerName": "",
        "checkTime": "2026-01-01 12:00:00",
        "name": "",
        "phone": "13800000000",
        "idType": "1",
        "identityNo": "",
        "isDeleted": false,
        "status": 0,
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "qrcode": "",
        "shopId": 1,
        "shopName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 isNotEmpty（StrUtil.isNotEmpty）；查询详情（ticketsOrderService.get）；分页查询（ticketsCheckService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryTicketsCheckPage exact

POST /tickets/queryTicketsShopList 在用管理后台 #

（无摘要） · TicketsCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsCheckController#queryTicketsShopList

转换BeanUtils.mapList → ShopResponse

ServiceTicketsService#queryList （TicketsServiceImpl）

MapperTicketsMapper#selectList ⇒ 表 tickets

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ShopCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/tickets/queryTicketsShopList
uat	https://dscp-uat.hn12301.net/manage-api/tickets/queryTicketsShopList
pro	https://dscp-uat.hn12301.net/manage-api/tickets/queryTicketsShopList	（仓库 .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<ShopResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets`.`id`	商铺id，主键
merchantId	Long		`tickets`.`merchant_id`	所属商户id，关联merchant表id
merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
name	String		`tickets`.`name`	商铺名称
logo	String		—	商铺LOGO图片url地址
typeId	Long		`tickets`.`type_id`	商铺大类
subTypeId	Long		`tickets`.`sub_type_id`	商铺小类ID
status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`tickets`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
provinceId	Long		`tickets`.`province_id`	省id
cityId	Long		`tickets`.`city_id`	市id
districtId	Long		`tickets`.`district_id`	区县id
address	String		`tickets`.`address`	商铺地址
mobile	String		—	客服电话
linkman	String		—	商户联系人
linkphone	String		—	商户联系人手机
manager	String		—	专属客户经理
level	String		—	等级
lng	String		—	经度
lat	String		—	纬度
introduction	String		`tickets`.`introduction`	简介
businessTime	String		—	营业时间
tags	String		`tickets`.`tags`	商铺标签
mainPic	String		`tickets`.`main_pic`	景区主图url地址
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
video	String		—	景区视频url地址
poster	String		—	分享海报url地址
propagateContent	String		—	宣传语
description	String		—	图文详情
ticketInfo	String		—	门票信息
trafficInfo	String		—	交通信息
tips	String		—	温馨提示
merchantName	String		—	所属商户名称
createdTime	Date		`tickets`.`created_time`	创建时间
thirdId	String		—
thirdName	String		—
relationList	List<ShopRelationResponse>		—
relationList[].id	Long		`tickets`.`id`	id
relationList[].shopId	Long		`tickets`.`shop_id`	shopId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	—	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		—	第三方id
relationList[].thirdName	String		—	第三方名称
relationList[].remark	String		—	xuchao: 第三方备注
relationList[].createdTime	Date		`tickets`.`created_time`	创建时间
relationList[].updatedTime	Date		`tickets`.`updated_time`	修改时间

示例

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

POST /tickets/queryTicketsShopList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "merchantType": "1",
      "name": "",
      "logo": "",
      "typeId": 1,
      "subTypeId": 1,
      "status": "1",
      "provinceId": 1,
      "cityId": 1,
      "districtId": 1,
      "address": "",
      "mobile": "13800000000",
      "linkman": "",
      "linkphone": "13800000000",
      "manager": "",
      "level": "",
      "lng": "",
      "lat": "",
      "introduction": "",
      "businessTime": "2026-01-01 12:00:00",
      "tags": "",
      "mainPic": "https://example.com/x.png",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "poster": "",
      "propagateContent": "",
      "description": "",
      "ticketInfo": "",
      "trafficInfo": "",
      "tips": "",
      "merchantName": "",
      "createdTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": "",
      "relationList": [
        {
          "id": 1,
          "shopId": 1,
          "channelType": "1",
          "thirdId": "",
          "thirdName": "",
          "remark": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ]
    }
  ]
}

处理逻辑

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

前端调用方

dscp-html-manage queryTicketsShopList exact

POST /tickets/updateTicketsCheck 未使用管理后台 #

单票核销表-更新 · TicketsCheckController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_check

ControllerTicketsCheckController#updateTicketsCheck

转换BeanUtils.map → TicketsCheck ⇒ 表 tickets_check

ServiceTicketsCheckService#update （TicketsCheckServiceImpl）

MapperTicketsCheckMapper#updateById ⇒ 表 tickets_check

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsCheckUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`tickets_check`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/updateTicketsCheck

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 更新门票核销

逻辑摘要更新（ticketsCheckService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

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

TicketsController 12/12 在用

POST /tickets/addTickets 在用管理后台 #

单票-新增 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsController#addTickets

转换BeanUtils.map → Tickets ⇒ 表 tickets

ServiceTicketsService#add （TicketsServiceImpl）

MapperTicketsMapper#insert ⇒ 表 tickets

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

RegionCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsAddRequest

字段	类型	取值/校验	表 / 列	说明
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets`.`is_deleted`	是否删除
createdBy	Long		`tickets`.`created_by`	创建人
createdTime	Date		`tickets`.`created_time`	创建时间
updatedBy	Long		`tickets`.`updated_by`	修改人
updatedTime	Date		`tickets`.`updated_time`	修改时间
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
areaIds	String[]		—
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/addTickets

{
  "body": {
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "tags": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "status": "1",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "provinceId": "",
    "cityId": "",
    "districtId": "",
    "address": "",
    "areaIds": "",
    "price": 0,
    "unitPrice": 0,
    "openDate": "2026-01-01 12:00:00",
    "remark1": "",
    "remark2": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 新增门票

逻辑摘要新增（ticketsService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage addTickets exact

POST /tickets/deleteTickets 在用管理后台 #

单票-删除 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsController#deleteTickets

ServiceTicketsService#delete （TicketsServiceImpl）

MapperTicketsMapper#deleteById ⇒ 表 tickets

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/deleteTickets

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 删除门票

逻辑摘要删除（ticketsService.delete）

前端调用方

dscp-html-manage deleteTickets exact

POST /tickets/getTickets 在用管理后台 #

单票-详情 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsController#getTickets

ServiceTicketsService#get （TicketsServiceImpl）

MapperTicketsMapper#selectById ⇒ 表 tickets

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets`.`id`	id

响应参数

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

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

data 结构　TicketsResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`tickets`.`id`	id
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets`.`is_deleted`	是否删除
createdBy	Long		`tickets`.`created_by`	创建人
createdTime	Date		`tickets`.`created_time`	创建时间
updatedBy	Long		`tickets`.`updated_by`	修改人
updatedTime	Date		`tickets`.`updated_time`	修改时间
shopsName	String		—
skuNum	Integer		—
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
cityName	String		—
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

示例

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

POST /tickets/getTickets

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "tags": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "status": "1",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "shopsName": "",
    "skuNum": 0,
    "provinceId": "",
    "cityId": "",
    "districtId": "",
    "address": "",
    "price": 0,
    "unitPrice": 0,
    "cityName": "",
    "openDate": "2026-01-01 12:00:00",
    "remark1": "",
    "remark2": ""
  }
}

处理逻辑

逻辑摘要查询详情（ticketsService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getTickets exact

POST /tickets/getTicketsCities 在用开放/回调 #

（无摘要） · TicketsController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsController#getTicketsCities
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表regiontickets

ControllerTicketsController#getTicketsCities

ServiceTicketsService#queryList （TicketsServiceImpl）

MapperTicketsMapper#selectList ⇒ 表 tickets

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

RegionCache.get

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/tickets/getTicketsCities
uat	https://dscp-uat.hn12301.net/open-api/tickets/getTicketsCities
pro	https://dscp-uat.hn12301.net/open-api/tickets/getTicketsCities	（仓库 .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<Region>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`region`.`id`	主键
name	String	`region`.`name`	地名
parentId	Long	`region`.`parent_id`	父Id
shortName	String	`region`.`short_name`	简称
levelType	Integer	`region`.`level_type`	级别
cityCode	String	`region`.`city_code`	城市编码
zipCode	String	`region`.`zip_code`	邮政编码
mergerName	String	`region`.`merger_name`	合并名称
lng	BigDecimal	`region`.`lng`	经度
lat	BigDecimal	`region`.`lat`	纬度
pinYin	String	`region`.`pin_yin`	拼音
isDeleted	Boolean	`region`.`is_deleted`	是否删除
createdBy	String	`region`.`created_by`	创建人id
createdTime	LocalDateTime	`region`.`created_time`	创建时间
updatedBy	String	`region`.`updated_by`	更新人id
updatedTime	LocalDateTime	`region`.`updated_time`	更新时间

示例

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

POST /tickets/getTicketsCities

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "name": "",
      "parentId": 1,
      "shortName": "",
      "levelType": 0,
      "cityCode": "",
      "zipCode": "",
      "mergerName": "",
      "lng": 0,
      "lat": 0,
      "pinYin": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（ticketsService.queryList）

前端调用方

xghmall getTicketsCities exact zhy-h5 getTicketsCities exact

POST /tickets/getTicketsDetail 在用开放/回调 #

（无摘要） · TicketsController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsController#getTicketsDetail
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_calendartickets_calender_time_slotticketstickets_sku

ControllerTicketsController#getTicketsDetail

转换BeanUtils.map → TicketsSkuResponse

MapperTicketsCalendarService.getMapper#queryList ⇒ 表 tickets_calendar

MapperTicketsCalenderTimeSlotService.getMapper#queryList ⇒ 表 tickets_calender_time_slot

ServiceTicketsService#get （TicketsServiceImpl）

MapperTicketsMapper#selectById ⇒ 表 tickets

ServiceTicketsSkuService#queryList （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectList ⇒ 表 tickets_sku

ServiceTicketsCalendarService#get （TicketsCalendarServiceImpl）

MapperTicketsCalendarMapper#selectById ⇒ 表 tickets_calendar

ServiceTicketsCalenderTimeSlotService#queryList （TicketsCalenderTimeSlotServiceImpl）

MapperTicketsCalenderTimeSlotMapper#selectList ⇒ 表 tickets_calender_time_slot

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

TicketsCalendarService.applyWrapperTicketsCalenderTimeSlotService.applyWrapperShopCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_calendar`.`id`	id

响应参数

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

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

data 结构　TicketsDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
tickets	Tickets		—
tickets.id	Long		`tickets_calendar`.`id`	商品id，主键
tickets.merchantId	Long		`tickets`.`merchant_id`	所属商户id
tickets.shopId	Long		`tickets`.`shop_id`	所属商铺id
tickets.name	String		`tickets_calender_time_slot`.`name`	单票名称
tickets.mainPic	String		`tickets`.`main_pic`	单票主图
tickets.typeId	String		`tickets`.`type_id`	单票大类
tickets.subTypeId	String		`tickets`.`sub_type_id`	单票小类
tickets.tags	String		`tickets`.`tags`	商品标签
tickets.introduction	String		`tickets`.`introduction`	简介
tickets.propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
tickets.status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
tickets.isDeleted	Boolean		`tickets_calendar`.`is_deleted`	是否删除
tickets.createdBy	Long		`tickets_calendar`.`created_by`	创建人
tickets.createdTime	Date		`tickets_calendar`.`created_time`	创建时间
tickets.updatedBy	Long		`tickets_calendar`.`updated_by`	修改人
tickets.updatedTime	Date		`tickets_calendar`.`updated_time`	修改时间
tickets.provinceId	String		`tickets`.`province_id`	省id
tickets.cityId	String		`tickets`.`city_id`	市id
tickets.districtId	String		`tickets`.`district_id`	县id
tickets.address	String		`tickets`.`address`	地址
tickets.price	Integer		`tickets`.`price`
tickets.unitPrice	Integer		`tickets`.`unit_price`
tickets.openDate	String		`tickets`.`open_date`
tickets.remark1	String		`tickets`.`remark1`
tickets.remark2	String		`tickets`.`remark2`
skuList	List<TicketsSkuResponse>		—
skuList[].id	Long		`tickets_calendar`.`id`
skuList[].merchantId	Long		`tickets`.`merchant_id`	所属商户id
skuList[].shopId	Long		`tickets`.`shop_id`	所属商铺id
skuList[].ticketsId	Long		`tickets_calendar`.`tickets_id`	单票ID，关联单票表id
skuList[].ticketsName	String		—
skuList[].skuName	String		`tickets_sku`.`sku_name`	sku名称
skuList[].typeId	String		`tickets`.`type_id`	sku类型
skuList[].typeInfo	String		`tickets_sku`.`type_info`	适用人群说明
skuList[].stockNumType	Boolean		`tickets_sku`.`stock_num_type`	是否无限库存
skuList[].stockDateType	Boolean		`tickets_sku`.`stock_date_type`	库存形式:日历库存、时间段库存
skuList[].bookType	Integer		`tickets_sku`.`book_type`	预定时间:可订当天,可订明日
skuList[].bookTimeLimit	LocalTime		`tickets_sku`.`book_time_limit`	预订限制时间：订当天时，表示xx时间之前可订当天；订明日时，表示xx时间之前可订明日
skuList[].idLimitFlag	Boolean		`tickets_sku`.`id_limit_flag`	身份证是否限购
skuList[].idLimitDays	Integer		`tickets_sku`.`id_limit_days`	身份证限制天数
skuList[].idLimitNum	Integer		`tickets_sku`.`id_limit_num`	身份证限制张数
skuList[].speedInfo	String		`tickets_sku`.`speed_info`	出票速度
skuList[].basePrice	Integer		`tickets_sku`.`base_price`	默认价(分)
skuList[].stock	Integer		`tickets_calendar`.`stock`
skuList[].contentWith	String		`tickets_sku`.`content_with`	费用包含
skuList[].contentWithout	String		`tickets_sku`.`content_without`	费用不包含
skuList[].enterDemand	String		`tickets_sku`.`enter_demand`	入园要求
skuList[].enterChangeFlag	Boolean		`tickets_sku`.`enter_change_flag`
skuList[].enterType	String		`tickets_sku`.`enter_type`	入园方式
skuList[].changePostion	String		`tickets_sku`.`change_postion`	换票地点
skuList[].changeTimeRange	LocalTime[]		—	换票起始
skuList[].enterPostion	String		`tickets_sku`.`enter_postion`	入园地点
skuList[].enterTimeRange	LocalTime[]		—	入园起始
skuList[].refundType	Integer		`tickets_sku`.`refund_type`	退款规则
skuList[].refundDays	Integer		`tickets_sku`.`refund_days`	可退款时间：选择天数和时间，在这之前的可退款。之后的不能退款。0天为使用当天。
skuList[].refundTime	LocalTime		`tickets_sku`.`refund_time`	可退款时间
skuList[].refundPolicy	String		`tickets_sku`.`refund_policy`	退款政策
skuList[].remark	String		`tickets_sku`.`remark`	补充说明
skuList[].receiptPolicy	String		`tickets_sku`.`receipt_policy`	发票说明
skuList[].isDeleted	Boolean		`tickets_calendar`.`is_deleted`	是否删除
skuList[].status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`
skuList[].createdBy	String		`tickets_calendar`.`created_by`	创建人
skuList[].createdTime	Date		`tickets_calendar`.`created_time`	创建时间
skuList[].updatedBy	String		`tickets_calendar`.`updated_by`	修改人
skuList[].updatedTime	Date		`tickets_calendar`.`updated_time`	修改时间
skuList[].calendar	TicketsCalendar		—
calendar.id	Long		`tickets_calendar`.`id`
calendar.ticketsId	Long		`tickets_calendar`.`tickets_id`	单票id
calendar.skuId	Long		`tickets_calendar`.`sku_id`	单票skuID
calendar.enableDate	Date		`tickets_calendar`.`enable_date`	日期
calendar.salePrice	Integer		`tickets_calendar`.`sale_price`	卖价(分)
calendar.listPrice	Integer		`tickets_calendar`.`list_price`	划线价(分)
calendar.totalStock	Integer		`tickets_calendar`.`total_stock`	总库存
calendar.stock	Integer		`tickets_calendar`.`stock`	可用库存
calendar.isEnabled	Boolean		`tickets_calendar`.`is_enabled`	状态
calendar.reason	String		`tickets_calendar`.`reason`
calendar.isDeleted	Boolean		`tickets_calendar`.`is_deleted`	是否删除(0否 1是)
calendar.createdBy	String		`tickets_calendar`.`created_by`	创建人
calendar.createdTime	Date		`tickets_calendar`.`created_time`
calendar.updatedBy	String		`tickets_calendar`.`updated_by`	修改人
calendar.updatedTime	Date		`tickets_calendar`.`updated_time`
calendar.version	Integer		`tickets_calendar`.`version`	版本
skuList[].timeSlot	TicketsCalenderTimeSlot		—
timeSlot.id	Long		`tickets_calendar`.`id`	ID，主键
timeSlot.ticketsId	Long		`tickets_calendar`.`tickets_id`	单票id
timeSlot.skuId	Long		`tickets_calendar`.`sku_id`	单票skuID
timeSlot.enableDate	Date		`tickets_calendar`.`enable_date`	时间段库存日期
timeSlot.name	String		`tickets_calender_time_slot`.`name`	名称
timeSlot.time	String		`tickets_calender_time_slot`.`time`	时间段
timeSlot.totalStock	Integer		`tickets_calendar`.`total_stock`	总库存数量
timeSlot.stock	Integer		`tickets_calendar`.`stock`	库存数量
timeSlot.salePrice	Integer		`tickets_calendar`.`sale_price`	卖价(分)
timeSlot.isEnabled	Boolean		`tickets_calendar`.`is_enabled`	是否可用，1可用，2不可用
timeSlot.version	Integer		`tickets_calendar`.`version`	版本，乐观锁
timeSlot.createdTime	Date		`tickets_calendar`.`created_time`	创建时间
timeSlot.updatedTime	Date		`tickets_calendar`.`updated_time`	修改时间
minPrice	Integer		—
maxPrice	Integer		—
shop	Shop		—
shop.id	Long		`tickets_calendar`.`id`	商铺id，主键
shop.merchantId	Long		`tickets`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		`tickets_calender_time_slot`.`name`	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		`tickets`.`type_id`	商铺大类
shop.subTypeId	Long		`tickets`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`tickets`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		`tickets`.`province_id`	省id
shop.cityId	String		`tickets`.`city_id`	市id
shop.districtId	String		`tickets`.`district_id`	区县id
shop.address	String		`tickets`.`address`	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		`tickets`.`introduction`	简介
shop.businessTime	String		—	营业时间
shop.tags	String		`tickets`.`tags`	商铺标签
shop.mainPic	String		`tickets`.`main_pic`	景区主图url地址
shop.propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
shop.video	String		—	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		—	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		—	温馨提示
shop.isDeleted	Boolean		`tickets_calendar`.`is_deleted`	是否删除
shop.createdBy	String		`tickets_calendar`.`created_by`	创建人id
shop.createdTime	Date		`tickets_calendar`.`created_time`	创建时间
shop.updatedBy	String		`tickets_calendar`.`updated_by`	更新人id
shop.updatedTime	Date		`tickets_calendar`.`updated_time`	修改时间
shop.thirdId	String		—
shop.thirdName	String		—

示例

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

POST /tickets/getTicketsDetail

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "tickets": {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "subTypeId": "",
      "tags": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "status": "1",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "price": 0,
      "unitPrice": 0,
      "openDate": "2026-01-01 12:00:00",
      "remark1": "",
      "remark2": ""
    },
    "skuList": [
      {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "ticketsId": 1,
        "ticketsName": "",
        "skuName": "",
        "typeId": "",
        "typeInfo": "",
        "stockNumType": false,
        "stockDateType": false,
        "bookType": 0,
        "bookTimeLimit": "2026-01-01 12:00:00",
        "idLimitFlag": false,
        "idLimitDays": 1,
        "idLimitNum": 1,
        "speedInfo": "",
        "basePrice": 0,
        "stock": 0,
        "contentWith": "",
        "contentWithout": "",
        "enterDemand": "",
        "enterChangeFlag": false,
        "enterType": "",
        "changePostion": "",
        "changeTimeRange": "2026-01-01 12:00:00",
        "enterPostion": "",
        "enterTimeRange": "2026-01-01 12:00:00",
        "refundType": 0,
        "refundDays": 0,
        "refundTime": "2026-01-01 12:00:00",
        "refundPolicy": "",
        "remark": "",
        "receiptPolicy": "",
        "isDeleted": false,
        "status": "1",
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "calendar": {
          "id": 1,
          "ticketsId": 1,
          "skuId": 1,
          "enableDate": "2026-01-01 12:00:00",
          "salePrice": 0,
          "listPrice": 0,
          "totalStock": 0,
          "stock": 0,
          "isEnabled": false,
          "reason": "",
          "isDeleted": false,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00",
          "version": 0
        },
        "timeSlot": {
          "id": 1,
          "ticketsId": 1,
          "skuId": 1,
          "enableDate": "2026-01-01 12:00:00",
          "name": "",
          "time": "2026-01-01 12:00:00",
          "totalStock": 0,
          "stock": 0,
          "salePrice": 0,
          "isEnabled": false,
          "version": 0,
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      }
    ],
    "minPrice": 0,
    "maxPrice": 0,
    "shop": {
      "id": 1,
      "merchantId": 1,
      "merchantType": "1",
      "name": "",
      "logo": "",
      "typeId": 1,
      "subTypeId": 1,
      "status": "1",
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "mobile": "13800000000",
      "linkman": "",
      "linkphone": "13800000000",
      "manager": "",
      "level": "",
      "lng": "",
      "lat": "",
      "introduction": "",
      "businessTime": "2026-01-01 12:00:00",
      "tags": "",
      "mainPic": "https://example.com/x.png",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "poster": "",
      "propagateContent": "",
      "description": "",
      "ticketInfo": "",
      "trafficInfo": "",
      "tips": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    }
  }
}

处理逻辑

逻辑摘要查询详情（ticketsService.get）；列表查询（ticketsSkuService.queryList）；查询详情（ticketsCalendarService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

xghmall getTicketsDetail exact zhy-h5 getTicketsDetail exact

POST /tickets/getTicketsTypes 在用开放/回调 #

（无摘要） · TicketsController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsController#getTicketsTypes
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_dict_data

ControllerTicketsController#getTicketsTypes

ServiceDictDataService#queryList （DictDataServiceImpl）

MapperDictDataMapper#selectList ⇒ 表 system_dict_data

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/tickets/getTicketsTypes
uat	https://dscp-uat.hn12301.net/open-api/tickets/getTicketsTypes
pro	https://dscp-uat.hn12301.net/open-api/tickets/getTicketsTypes	（仓库 .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<DictData>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`system_dict_data`.`id`	字典编码
parentId	Long	`system_dict_data`.`parent_id`	父字典id
sort	Integer	`system_dict_data`.`sort`	字典排序
label	String	`system_dict_data`.`label`	字典标签
value	String	`system_dict_data`.`value`	字典键值
dictType	String	`system_dict_data`.`dict_type`	字典类型
parentDictType	String	`system_dict_data`.`parent_dict_type`	父类型id
status	Integer	`system_dict_data`.`status`	状态（0正常 1停用）
colorType	String	`system_dict_data`.`color_type`	颜色类型
cssClass	String	`system_dict_data`.`css_class`	css 样式
remark	String	`system_dict_data`.`remark`	备注
isDeleted	Boolean	`system_dict_data`.`is_deleted`	是否删除
createdBy	String	`system_dict_data`.`created_by`	创建人id
createdTime	LocalDateTime	`system_dict_data`.`created_time`	创建时间
updatedBy	String	`system_dict_data`.`updated_by`	更新人id
updatedTime	LocalDateTime	`system_dict_data`.`updated_time`	更新时间

示例

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

POST /tickets/getTicketsTypes

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "parentId": 1,
      "sort": 0,
      "label": "",
      "value": "",
      "dictType": "",
      "parentDictType": "",
      "status": 0,
      "colorType": "",
      "cssClass": "",
      "remark": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（dictDataService.queryList）

前端调用方

xghmall getTicketsTypes exact zhy-h5 getTicketsTypes exact

POST /tickets/queryTicketsList 在用管理后台 #

单票-列表查询 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表ticketstickets_sku

ControllerTicketsController#queryTicketsList

转换BeanUtils.map → TicketsQuery

ServiceTicketsService#queryList （TicketsServiceImpl）

MapperTicketsMapper#selectList ⇒ 表 tickets

ServiceTicketsSkuService#queryList （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectList ⇒ 表 tickets_sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ShopCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
name	String			`tickets`.`name`

响应参数

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

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

data 结构　List<TicketsResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets`.`id`	id
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets`.`is_deleted`	是否删除
createdBy	Long		`tickets`.`created_by`	创建人
createdTime	Date		`tickets`.`created_time`	创建时间
updatedBy	Long		`tickets`.`updated_by`	修改人
updatedTime	Date		`tickets`.`updated_time`	修改时间
shopsName	String		—
skuNum	Integer		—
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
cityName	String		—
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

示例

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

POST /tickets/queryTicketsList

{
  "body": {
    "keywords": "",
    "name": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "subTypeId": "",
      "tags": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "status": "1",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "shopsName": "",
      "skuNum": 0,
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "price": 0,
      "unitPrice": 0,
      "cityName": "",
      "openDate": "2026-01-01 12:00:00",
      "remark1": "",
      "remark2": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（ticketsService.queryList）；列表查询（ticketsSkuService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryTicketsList exact

POST /tickets/queryTicketsPage 在用开放/回调 #

单票-分页查询 · TicketsController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsController#queryTicketsPage
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_calendartickets_calender_time_slotticketstickets_sku

ControllerTicketsController#queryTicketsPage

转换BeanUtils.map → TicketsQuery

MapperTicketsCalendarService.getMapper#queryList ⇒ 表 tickets_calendar

MapperTicketsCalenderTimeSlotService.getMapper#queryList ⇒ 表 tickets_calender_time_slot

ServiceTicketsService#queryPage （TicketsServiceImpl）

MapperTicketsMapper#selectPage ⇒ 表 tickets

ServiceTicketsSkuService#queryList （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectList ⇒ 表 tickets_sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

ShopCache.getRegionCache.getTicketsCalenderTimeSlotService.applyWrapper

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
merchantId	Long			`tickets`.`merchant_id`	所属商户id
shopId	Long			`tickets`.`shop_id`	所属商铺id
name	String			`tickets_calender_time_slot`.`name`	单票名称
typeId	String			`tickets`.`type_id`	单票大类
subTypeId	String			`tickets`.`sub_type_id`	单票小类
status	TicketsStatus		1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
createdTime	Date			`tickets_calendar`.`created_time`	创建时间
cityId	String			`tickets`.`city_id`
todayAvailable	boolean			—

响应参数

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

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

data 结构　PageInfo<TicketsResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`tickets_calendar`.`id`	id
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets_calender_time_slot`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets_calendar`.`is_deleted`	是否删除
createdBy	Long		`tickets_calendar`.`created_by`	创建人
createdTime	Date		`tickets_calendar`.`created_time`	创建时间
updatedBy	Long		`tickets_calendar`.`updated_by`	修改人
updatedTime	Date		`tickets_calendar`.`updated_time`	修改时间
shopsName	String		—
skuNum	Integer		—
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
cityName	String		—
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

示例

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

POST /tickets/queryTicketsPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "typeId": "",
    "subTypeId": "",
    "status": "1",
    "createdTime": "2026-01-01 12:00:00",
    "cityId": "",
    "todayAvailable": false
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "name": "",
        "mainPic": "https://example.com/x.png",
        "typeId": "",
        "subTypeId": "",
        "tags": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "status": "1",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "shopsName": "",
        "skuNum": 0,
        "provinceId": "",
        "cityId": "",
        "districtId": "",
        "address": "",
        "price": 0,
        "unitPrice": 0,
        "cityName": "",
        "openDate": "2026-01-01 12:00:00",
        "remark1": "",
        "remark2": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（ticketsService.queryPage）；列表查询（ticketsSkuService.queryList）；查询详情（ticketsCalendarService.getMapper）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件
query.setStatus(TicketsStatus.UPDATES);
tickets.setPrice(skuList.get(0).getBasePrice());
try {
calendarQueryWrapperX.gt("enable_date", new Date());
calendarQueryWrapperX.last("limit 90");
if (calendarList == null || calendarList.size() < 1) {
slotQueryWrapperX.gt("enable_date", DateUtil.format(new Date(), "yyyy-MM-dd"));

前端调用方

xghmall queryTicketsPage exact zhy-h5 queryTicketsPage exact

POST /tickets/queryTicketsPageBack 在用开放/回调 #

（无摘要） · TicketsController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsController#queryTicketsPageBack
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表ticketstickets_sku

ControllerTicketsController#queryTicketsPageBack

转换BeanUtils.map → TicketsQuery

ServiceTicketsService#queryPage （TicketsServiceImpl）

MapperTicketsMapper#selectPage ⇒ 表 tickets

ServiceTicketsSkuService#queryList （TicketsSkuServiceImpl）

MapperTicketsSkuMapper#selectList ⇒ 表 tickets_sku

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

ShopCache.getRegionCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
merchantId	Long			`tickets`.`merchant_id`	所属商户id
shopId	Long			`tickets`.`shop_id`	所属商铺id
name	String			`tickets`.`name`	单票名称
typeId	String			`tickets`.`type_id`	单票大类
subTypeId	String			`tickets`.`sub_type_id`	单票小类
status	TicketsStatus		1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
createdTime	Date			`tickets`.`created_time`	创建时间
cityId	String			`tickets`.`city_id`
todayAvailable	boolean			—

响应参数

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

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

data 结构　PageInfo<TicketsResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`tickets`.`id`	id
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets`.`is_deleted`	是否删除
createdBy	Long		`tickets`.`created_by`	创建人
createdTime	Date		`tickets`.`created_time`	创建时间
updatedBy	Long		`tickets`.`updated_by`	修改人
updatedTime	Date		`tickets`.`updated_time`	修改时间
shopsName	String		—
skuNum	Integer		—
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
cityName	String		—
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

示例

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

POST /tickets/queryTicketsPageBack

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "typeId": "",
    "subTypeId": "",
    "status": "1",
    "createdTime": "2026-01-01 12:00:00",
    "cityId": "",
    "todayAvailable": false
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "name": "",
        "mainPic": "https://example.com/x.png",
        "typeId": "",
        "subTypeId": "",
        "tags": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "status": "1",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "shopsName": "",
        "skuNum": 0,
        "provinceId": "",
        "cityId": "",
        "districtId": "",
        "address": "",
        "price": 0,
        "unitPrice": 0,
        "cityName": "",
        "openDate": "2026-01-01 12:00:00",
        "remark1": "",
        "remark2": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（ticketsService.queryPage）；列表查询（ticketsSkuService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

else {
query.setStatus(TicketsStatus.UPDATES);
}
设置其他查询条件

前端调用方

dscp-html-manage queryTicketsPage exact

POST /tickets/ticketsOffline 在用管理后台 #

商品-下架 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsController#goodsOffline

ServiceTicketsService#update （TicketsServiceImpl）

MapperTicketsMapper#updateById ⇒ 表 tickets

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/ticketsOffline

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 门票下架

逻辑摘要更新（ticketsService.update）

前端调用方

dscp-html-manage ticketsOffline exact

POST /tickets/ticketsOnline 在用管理后台 #

商品-上架 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsController#ticketsOnline

ServiceTicketsService#update （TicketsServiceImpl）

MapperTicketsMapper#updateById ⇒ 表 tickets

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets`.`id`	id

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/ticketsOnline

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 门票上架

逻辑摘要更新（ticketsService.update）

前端调用方

dscp-html-manage ticketsOnline exact

POST /tickets/updateTickets 在用管理后台 #

单票-更新 · TicketsController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets

ControllerTicketsController#updateTickets

转换BeanUtils.map → Tickets ⇒ 表 tickets

ServiceTicketsService#update （TicketsServiceImpl）

MapperTicketsMapper#updateById ⇒ 表 tickets

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

RegionCache.get

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsUpdateRequest

字段	类型	取值/校验	表 / 列	说明
id	Long		`tickets`.`id`
merchantId	Long		`tickets`.`merchant_id`	所属商户id
shopId	Long		`tickets`.`shop_id`	所属商铺id
name	String		`tickets`.`name`	单票名称
mainPic	String		`tickets`.`main_pic`	单票主图
typeId	String		`tickets`.`type_id`	单票大类
subTypeId	String		`tickets`.`sub_type_id`	单票小类
tags	String		`tickets`.`tags`	商品标签
introduction	String		`tickets`.`introduction`	简介
propagatePic	String		`tickets`.`propagate_pic`	宣传图片url地址
status	TicketsStatus	1已上架2编辑中3已下架	`tickets`.`status`	单票状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
isDeleted	Boolean		`tickets`.`is_deleted`	是否删除
createdBy	Long		`tickets`.`created_by`	创建人
createdTime	Date		`tickets`.`created_time`	创建时间
updatedBy	Long		`tickets`.`updated_by`	修改人
updatedTime	Date		`tickets`.`updated_time`	修改时间
provinceId	String		`tickets`.`province_id`	省id
cityId	String		`tickets`.`city_id`	市id
districtId	String		`tickets`.`district_id`	县id
address	String		`tickets`.`address`	地址
areaIds	String[]		—
price	Integer		`tickets`.`price`
unitPrice	Integer		`tickets`.`unit_price`
openDate	String		`tickets`.`open_date`
remark1	String		`tickets`.`remark1`
remark2	String		`tickets`.`remark2`

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/updateTickets

{
  "body": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "subTypeId": "",
    "tags": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "status": "1",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "provinceId": "",
    "cityId": "",
    "districtId": "",
    "address": "",
    "areaIds": "",
    "price": 0,
    "unitPrice": 0,
    "openDate": "2026-01-01 12:00:00",
    "remark1": "",
    "remark2": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 更新门票

逻辑摘要更新（ticketsService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateTickets exact

TicketsMemberTouristController 3/6 在用

POST /tickets/addTicketsMemberTourist 在用开放/回调 #

单票会员游客表-新增 · TicketsMemberTouristController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsMemberTouristController#addTicketsMemberTourist
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_member_touristmember

ControllerTicketsMemberTouristController#addTicketsMemberTourist

转换BeanUtils.map → TicketsMemberTourist ⇒ 表 tickets_member_tourist

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceTicketsMemberTouristService#add （TicketsMemberTouristServiceImpl）

MapperTicketsMemberTouristMapper#insert ⇒ 表 tickets_member_tourist

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

MemberService.getMember

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsMemberTouristAddRequest

字段	类型	取值/校验	表 / 列	说明
mobile	String		`member`.`mobile`
name	String		`tickets_member_tourist`.`name`	持卡人姓名
phone	String		`tickets_member_tourist`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_member_tourist`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_member_tourist`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_member_tourist`.`is_deleted`	是否删除
isDefault	Boolean		`tickets_member_tourist`.`is_default`	是否默认

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/addTicketsMemberTourist

{
  "body": {
    "mobile": "13800000000",
    "name": "",
    "phone": "13800000000",
    "idType": "1",
    "identityNo": "",
    "isDeleted": false,
    "isDefault": false
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 新增游客

逻辑摘要查询详情（memberService.get）；查询详情（memberService.getMember）；新增（ticketsMemberTouristService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

xghmall addTicketsMemberTourist exact zhy-h5 addTicketsMemberTourist exact

POST /tickets/getMemberTourist 在用开放/回调 #

（无摘要） · TicketsMemberTouristController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsMemberTouristController#getMemberTourist
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_member_touristmember

ControllerTicketsMemberTouristController#getMemberTourist

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceTicketsMemberTouristService#queryList （TicketsMemberTouristServiceImpl）

MapperTicketsMemberTouristMapper#selectList ⇒ 表 tickets_member_tourist

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

MemberService.getMember

环境 URL

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

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	mobile	String	是		`member`.`mobile`

请求参数 · Body

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

响应参数

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

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

data 结构　List<TicketsMemberTourist>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets_member_tourist`.`id`
memberId	Long		`tickets_member_tourist`.`member_id`	订单号，order表id
name	String		`tickets_member_tourist`.`name`	持卡人姓名
phone	String		`tickets_member_tourist`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_member_tourist`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_member_tourist`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_member_tourist`.`is_deleted`	是否删除
isDefault	Boolean		`tickets_member_tourist`.`is_default`	是否默认
updatedBy	String		`tickets_member_tourist`.`updated_by`
updatedTime	Date		`tickets_member_tourist`.`updated_time`
createdBy	String		`tickets_member_tourist`.`created_by`
createdTime	Date		`tickets_member_tourist`.`created_time`

示例

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

POST /tickets/getMemberTourist?mobile=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "memberId": 1,
      "name": "",
      "phone": "13800000000",
      "idType": "1",
      "identityNo": "",
      "isDeleted": false,
      "isDefault": false,
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要查询详情（memberService.get）；查询详情（memberService.getMember）；新增（memberService.add）

内联注释

不存在时创建用户

前端调用方

xghmall getMemberTourist exact zhy-h5 getMemberTourist exact

POST /tickets/getTicketsMemberTourist 未使用管理后台 #

单票会员游客表-详情 · TicketsMemberTouristController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_member_tourist

ControllerTicketsMemberTouristController#getTicketsMemberTourist

ServiceTicketsMemberTouristService#get （TicketsMemberTouristServiceImpl）

MapperTicketsMemberTouristMapper#selectById ⇒ 表 tickets_member_tourist

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`tickets_member_tourist`.`id`	id

响应参数

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

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

data 结构　TicketsMemberTouristResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`tickets_member_tourist`.`id`	id
memberId	Long		`tickets_member_tourist`.`member_id`	订单号，order表id
name	String		`tickets_member_tourist`.`name`	持卡人姓名
phone	String		`tickets_member_tourist`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_member_tourist`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_member_tourist`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_member_tourist`.`is_deleted`	是否删除
isDefault	Boolean		`tickets_member_tourist`.`is_default`	是否默认
updatedBy	String		`tickets_member_tourist`.`updated_by`
updatedTime	Date		`tickets_member_tourist`.`updated_time`
createdBy	String		`tickets_member_tourist`.`created_by`
createdTime	Date		`tickets_member_tourist`.`created_time`

示例

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

POST /tickets/getTicketsMemberTourist

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "memberId": 1,
    "name": "",
    "phone": "13800000000",
    "idType": "1",
    "identityNo": "",
    "isDeleted": false,
    "isDefault": false,
    "updatedBy": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00",
    "createdBy": "",
    "createdTime": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（ticketsMemberTouristService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

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

POST /tickets/queryTicketsMemberTouristList 未使用管理后台 #

单票会员游客表-列表查询 · TicketsMemberTouristController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_member_tourist

ControllerTicketsMemberTouristController#queryTicketsMemberTouristList

转换BeanUtils.map → TicketsMemberTouristQuery

ServiceTicketsMemberTouristService#queryList （TicketsMemberTouristServiceImpl）

MapperTicketsMemberTouristMapper#selectList ⇒ 表 tickets_member_tourist

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsMemberTouristListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　List<TicketsMemberTouristResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`tickets_member_tourist`.`id`	id
memberId	Long		`tickets_member_tourist`.`member_id`	订单号，order表id
name	String		`tickets_member_tourist`.`name`	持卡人姓名
phone	String		`tickets_member_tourist`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_member_tourist`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_member_tourist`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_member_tourist`.`is_deleted`	是否删除
isDefault	Boolean		`tickets_member_tourist`.`is_default`	是否默认
updatedBy	String		`tickets_member_tourist`.`updated_by`
updatedTime	Date		`tickets_member_tourist`.`updated_time`
createdBy	String		`tickets_member_tourist`.`created_by`
createdTime	Date		`tickets_member_tourist`.`created_time`

示例

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

POST /tickets/queryTicketsMemberTouristList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "memberId": 1,
      "name": "",
      "phone": "13800000000",
      "idType": "1",
      "identityNo": "",
      "isDeleted": false,
      "isDefault": false,
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

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

内联注释

设置其他查询条件

前端调用方

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

POST /tickets/queryTicketsMemberTouristPage 未使用管理后台 #

单票会员游客表-分页查询 · TicketsMemberTouristController

基本信息

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

调用链路 & 涉及数据表

涉及数据表tickets_member_tourist

ControllerTicketsMemberTouristController#queryTicketsMemberTouristPage

转换BeanUtils.map → TicketsMemberTouristQuery

ServiceTicketsMemberTouristService#queryPage （TicketsMemberTouristServiceImpl）

MapperTicketsMemberTouristMapper#selectPage ⇒ 表 tickets_member_tourist

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsMemberTouristPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

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

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

data 结构　PageInfo<TicketsMemberTouristResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`tickets_member_tourist`.`id`	id
memberId	Long		`tickets_member_tourist`.`member_id`	订单号，order表id
name	String		`tickets_member_tourist`.`name`	持卡人姓名
phone	String		`tickets_member_tourist`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_member_tourist`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_member_tourist`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_member_tourist`.`is_deleted`	是否删除
isDefault	Boolean		`tickets_member_tourist`.`is_default`	是否默认
updatedBy	String		`tickets_member_tourist`.`updated_by`
updatedTime	Date		`tickets_member_tourist`.`updated_time`
createdBy	String		`tickets_member_tourist`.`created_by`
createdTime	Date		`tickets_member_tourist`.`created_time`

示例

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

POST /tickets/queryTicketsMemberTouristPage

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

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "memberId": 1,
        "name": "",
        "phone": "13800000000",
        "idType": "1",
        "identityNo": "",
        "isDeleted": false,
        "isDefault": false,
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（ticketsMemberTouristService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

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

POST /tickets/updateTicketsMemberTourist 在用开放/回调 #

单票会员游客表-更新 · TicketsMemberTouristController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsMemberTouristController#updateTicketsMemberTourist
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_member_tourist

ControllerTicketsMemberTouristController#updateTicketsMemberTourist

转换BeanUtils.map → TicketsMemberTourist ⇒ 表 tickets_member_tourist

ServiceTicketsMemberTouristService#update （TicketsMemberTouristServiceImpl）

MapperTicketsMemberTouristMapper#updateById ⇒ 表 tickets_member_tourist

环境 URL

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

请求参数 · Header / Query / Path

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

请求参数 · Body　TicketsMemberTouristUpdateRequest

字段	类型	取值/校验	表 / 列	说明
id	Long		`tickets_member_tourist`.`id`	id
mobile	String		—
name	String		`tickets_member_tourist`.`name`	持卡人姓名
phone	String		`tickets_member_tourist`.`phone`	手机号码
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`tickets_member_tourist`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`tickets_member_tourist`.`identity_no`	身份证号码
isDeleted	Boolean		`tickets_member_tourist`.`is_deleted`	是否删除
isDefault	Boolean		`tickets_member_tourist`.`is_default`	是否默认

响应参数

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

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

data 结构

void —— 无返回数据

示例

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

POST /tickets/updateTicketsMemberTourist

{
  "body": {
    "id": 1,
    "mobile": "13800000000",
    "name": "",
    "phone": "13800000000",
    "idType": "1",
    "identityNo": "",
    "isDeleted": false,
    "isDefault": false
  }
}

响应示例

（void，无响应体）

处理逻辑

操作日志tickets / 更新游客

逻辑摘要更新（ticketsMemberTouristService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

xghmall updateTicketsMemberTourist exact zhy-h5 updateTicketsMemberTourist exact

TicketsOrderController 8/14 在用

POST /tickets/order/cancelTicketsOrder 在用开放/回调 #

取消门票订单 · TicketsOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.tickets.TicketsOrderController#cancelTicketsOrder
所属模块	门票 `tickets`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表tickets_order_goodstickets_skutickets_calendartickets_calender_time_slottickets_order

ControllerTicketsOrderController#cancelTicketsOrder

ServiceTicketsOrderService#cancelOrder （TicketsOrderServiceImpl）