POST/tickets/getTicketsDetail开放/回调

门票（主表）-获取Tickets详情 · getTicketsDetail 推断名·方法名推断

门票与景区 / 门票（主表）· TicketsController#getTicketsDetail

基本信息

  • 接口状态前端在用 置信度 高 免鉴权
  • 接口URLPOSThttps://dscp-dev.hn12301.net/open-api/tickets/getTicketsDetail
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道开放/回调　前缀 /open-api
  • 名称来源方法名推断　补 javadoc 后自动转正
  • 调用方已确认在用 · 质惠游 公众号 H5、湘工惠商城（2 个前端）
  • 需求上下文单票会员游客信息表等
  • 维护人 / 最后改动liuxu　2025-06-20　最近提交：单票会员游客信息表等
  • 读写数据表tickets_sku、tickets_calender_time_slot、tickets、tickets_calendar　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.tickets.TicketsController#getTicketsDetail
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsController.java:307
  • 判定依据2 个调用点：h5-meike/common/http.api.js、xghmall/common/http.api.js

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 IdRequest
参数名参数值是否必填参数类型描述说明
id…是Longid → tickets_sku.id

认证方式

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

响应参数

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

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "tickets": "…",
    "id": "1",
    "merchantId": "1",
    "shopId": "1",
    "name": "\"string\"",
    "mainPic": "\"string\"",
    "typeId": "\"string\"",
    "subTypeId": "\"string\"",
    "tags": "\"string\"",
    "introduction": "\"string\"",
    "propagatePic": "\"string\"",
    "status": "1"
  }
}
示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：tickets_sku、tickets_calender_time_slot、tickets、tickets_calendar　反查全部引用接口 →
  • TicketsController#getTicketsDetail
  • TicketsSkuService#queryList（TicketsSkuServiceImpl）
  • TicketsSkuMapper#queryList
  • TicketsCalenderTimeSlotService#queryList（TicketsCalenderTimeSlotServiceImpl）
  • TicketsCalenderTimeSlotMapper#queryList
  • BeanUtils.map → TicketsSkuResponse
其它依赖：ShopCache.getQuietly
逻辑摘要：查询详情（ticketsService.get）；列表查询（ticketsSkuService.queryList）；查询详情（ticketsCalendarService.get）；入参与返回值经 BeanUtils 做对象/分页映射
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • xghmall/common/http.api.js:42　湘工惠商城 · getTicketsDetailUrl
  • h5-meike/common/http.api.js:5　质惠游 公众号 H5 · getTicketsDetailUrl
← 门票（主表）-获取TicketsCities · g门票（主表）-获取TicketsTypes · ge →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据