POST/tickets/queryTicketsShopList管理后台

核销-查询Tickets商铺列表 · queryTicketsShopList 推断名·方法名推断

门票与景区 / 核销· TicketsCheckController#queryTicketsShopList

基本信息

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/tickets/queryTicketsShopList
请求方式POST
暴露渠道管理后台　前缀 /manage-api
名称来源方法名推断　补 javadoc 后自动转正
调用方已确认在用 · 管理后台（1 个前端）
需求上下文获取单票店铺接口；
维护人 / 最后改动liuxu　2025-07-01　最近提交：获取单票店铺接口；
读写数据表tickets　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.tickets.TicketsCheckController#queryTicketsShopList
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsCheckController.java:165
判定依据1 个调用点：dscp-html-manage/src/api/tickets/index.ts

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

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

认证方式

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

响应参数

data 类型 List<ShopResponse>

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	商铺id，主键 → tickets.id
merchantId	…	否	Long	所属商户id，关联merchant表id → tickets.merchant_id
merchantType	…	否	MerchantType	商户类型 1＝供应商 2＝分销商 3＝发卡商 4＝其他 5＝酒店 6＝第三方
name	…	否	String	商铺名称 → tickets.name
logo	…	否	String	商铺LOGO图片url地址
typeId	…	否	Long	商铺大类 → tickets.type_id
subTypeId	…	否	Long	商铺小类ID → tickets.sub_type_id
status	…	否	ShopStatus	商铺状态，1正常运营，2审核中，3暂停运营，4已关店 → tickets.status 1＝正常运营 2＝审核中 3＝暂停运营 4＝已关店
provinceId	…	否	Long	省id → tickets.province_id
cityId	…	否	Long	市id → tickets.city_id
districtId	…	否	Long	区县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	温馨提示
merchantName	…	否	String	所属商户名称
createdTime	…	否	Date	创建时间 → tickets.created_time
thirdId	…	否	String
thirdName	…	否	String
relationList	…	否	List<ShopRelationResponse>
id	…	否	Long	id → tickets.id
shopId	…	否	Long	shopId → tickets.shop_id
channelType	…	否	ChannelType	类型
thirdId	…	否	String	第三方id
thirdName	…	否	String	第三方名称
remark	…	否	String	xuchao: 第三方备注
createdTime	…	否	Date	创建时间 → tickets.created_time
updatedTime	…	否	Date	修改时间 → tickets.updated_time

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": "1",
    "merchantId": "1",
    "merchantType": "1",
    "name": "\"string\"",
    "logo": "\"string\"",
    "typeId": "1",
    "subTypeId": "1",
    "status": "1",
    "provinceId": "1",
    "cityId": "1",
    "districtId": "1",
    "address": "\"string\""
  }
}

示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要

涉及数据表：tickets　反查全部引用接口 →

TicketsCheckController#queryTicketsShopList
TicketsService#queryList（TicketsServiceImpl）
TicketsMapper#queryList
BeanUtils.mapList → ShopResponse

其它依赖：ShopCache.getQuietly

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

旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

调用点证据

dscp-html-manage/src/api/tickets/index.ts:155　管理后台 · request