POST/tickets/updateTickets管理后台

单票-更新

门票与景区 / 门票(主表)· TicketsController#updateTickets

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/tickets/updateTickets
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台 前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台(1 个前端)
  • 需求上下文单票管理
  • 维护人 / 最后改动liuxu 2025-06-16 最近提交:单票管理
  • 读写数据表tickets 反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.tickets.TicketsController#updateTickets
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsController.java:225
  • 判定依据1 个调用点:dscp-html-manage/src/api/tickets/index.ts

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 TicketsUpdateRequest
参数名参数值是否必填参数类型描述说明
id…否Long → tickets.id
merchantId…否Long所属商户id → tickets.merchant_id
shopId…否Long所属商铺id → tickets.shop_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宣传图片url地址 → tickets.propagate_pic
status…否TicketsStatus单票状态,1正常,2编辑中,3已下架 → tickets.status 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省id → tickets.province_id
cityId…否String市id → tickets.city_id
districtId…否String县id → tickets.district_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

认证方式

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

响应参数

参数名参数值是否必填参数类型描述说明
void —— 不返回业务数据(外层包装见全局公共参数)

响应示例

成功响应示例 code=0

{"errcode":0,"errmsg":""}
示例来自源码/导出内容,仅结构参考,非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:tickets 反查全部引用接口 →
  • TicketsController#updateTickets
  • TicketsService#update(TicketsServiceImpl)
  • TicketsMapper#update
  • BeanUtils.map → Tickets ⇒ 表 tickets
其它依赖:RegionCache.get
逻辑摘要:更新(ticketsService.update);入参与返回值经 BeanUtils 做对象/分页映射
操作日志:tickets / 更新门票
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)
调用点证据
  • dscp-html-manage/src/api/tickets/index.ts:24 管理后台 · request
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据