POST/tickets/getSkuDetail开放/回调

获取Sku详情 · getSkuDetail 推断名·方法名推断

门票与景区 / Sku· TicketsSkuController#getSkuDetail

基本信息

  • 接口状态前端在用 置信度 高 免鉴权
  • 接口URLPOSThttps://dscp-dev.hn12301.net/open-api/tickets/getSkuDetail
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道开放/回调　前缀 /open-api
  • 名称来源方法名推断　补 javadoc 后自动转正
  • 调用方已确认在用 · 质惠游 公众号 H5、湘工惠商城（2 个前端）
  • 需求上下文单票会员游客信息表等
  • 维护人 / 最后改动liuxu　2025-06-20　最近提交：单票会员游客信息表等
  • 读写数据表tickets_sku、tickets、tickets_calendar、tickets_calender_time_slot　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.tickets.TicketsSkuController#getSkuDetail
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsSkuController.java:209
  • 判定依据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 类型 TicketsSkuDetailResponse
参数名参数值是否必填参数类型描述说明
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
sku…否TicketsSku
id…否Long商品id，主键 → 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
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预定时间:1=可订当天,0=可订明日 → 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
contentWith…否String费用包含 → tickets_sku.content_with
contentWithout…否String费用不包含 → tickets_sku.content_without
enterDemand…否String入园要求 → tickets_sku.enter_demand
enterType…否String入园方式 → tickets_sku.enter_type
enterChangeFlag…否Boolean → tickets_sku.enter_change_flag
changePostion…否String换票地点 → tickets_sku.change_postion
changeStart…否LocalTime换票起始 → tickets_sku.change_start
changeEnd…否LocalTime换票截止 → tickets_sku.change_end
enterPostion…否String入园地点 → tickets_sku.enter_postion
enterStart…否LocalTime入园起始 → tickets_sku.enter_start
enterEnd…否LocalTime入园截止 → tickets_sku.enter_end
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
calendarList…否List<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
timeSlotData…否List<TimeSlotData>
date…否String
timeSlotList…否List<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

响应示例

成功响应示例 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、tickets_calendar、tickets_calender_time_slot　反查全部引用接口 →
  • TicketsSkuController#getSkuDetail
其它依赖：TicketsCalendarService.applyWrapper、TicketsCalenderTimeSlotService.applyWrapper
逻辑摘要：查询详情（ticketsSkuService.get）；查询详情（ticketsService.get）；调用 applyWrapper（ticketsCalendarService.applyWrapper）
源码内联注释（旧站解析结果）
  • if (sku.getBookType() == 1) {
  • } else {
  • }
  • calendarQueryWrapperX.last("limit 90");
  • slotQueryWrapperX.gt("enable_date", DateUtil.format(new Date(), "yyyy-MM-dd"));
  • slotQueryWrapperX.last("limit 90");
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • xghmall/common/http.api.js:43　湘工惠商城 · getSkuDetailUrl
  • h5-meike/common/http.api.js:6　质惠游 公众号 H5 · getSkuDetailUrl
← 单票sku-删除单票sku-详情 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据