POST
/tickets/addTicketsSku管理后台单票sku-新增
门票与景区 / Sku
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/tickets/addTicketsSku - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台（1 个前端）
- 需求上下文
- 维护人 / 最后改动liuxu 2025-06-16
- 读写数据表
tickets_sku、tickets反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.tickets.TicketsSkuController#addTicketsSku - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsSkuController.java:114 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无（渠道统一鉴权头见《认证方式》） | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| merchantId | … | 否 | Long | 所属商户id → tickets_sku.merchant_id |
| shopId | … | 否 | Long | 所属商铺id → tickets_sku.shop_id |
| ticketsId | … | 否 | Long | 单票ID，关联单票表id → tickets_sku.tickets_id |
| skuName | … | 否 | String | sku名称 → tickets_sku.sku_name |
| typeId | … | 否 | String | sku类型 → 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 |
| 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 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| void —— 不返回业务数据（外层包装见全局公共参数） | ||||
响应示例
成功响应示例
{"errcode":0,"errmsg":""}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：tickets_sku、tickets 反查全部引用接口 →
- TicketsSkuController#addTicketsSku
- BeanUtils.map → TicketsSku ⇒ 表 tickets_sku
逻辑摘要：查询详情（ticketsService.get）；新增（ticketsSkuService.add）；入参与返回值经 BeanUtils 做对象/分页映射
操作日志：tickets / 新增门票SKU
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
dscp-html-manage/src/api/tickets/index.ts:56管理后台 · request