POST/tickets/order/queryTicketsOrderPageAdmin管理后台

门票订单-管理端分页查询

门票与景区 / 订单· TicketsOrderController#queryTicketsOrderPageAdmin

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/tickets/order/queryTicketsOrderPageAdmin
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台 前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台(1 个前端)
  • 需求上下文上传人脸增加各参数校验
  • 维护人 / 最后改动liuxu 2026-08-11 最近提交:上传人脸增加各参数校验
  • 读写数据表tickets_order、tickets_check、tickets_order_payment、tickets_order_goods 反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.tickets.TicketsOrderController#queryTicketsOrderPageAdmin
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/tickets/TicketsOrderController.java:234
  • 判定依据1 个调用点:dscp-html-manage/src/api/tickets/index.ts

请求参数

分页字段来自 AbstractPageRequest:pageNo(不是 pageNum)· pageSize · orderBy

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 TicketsOrderPageRequest
参数名参数值是否必填参数类型描述说明
pageNo…否Integer当前页面
pageSize…否Integer每页记录数
orderBy…否String排序语句
keywords…否String关键字
orderStatus…否OrderStatus → tickets_order.order_status 1=待支付 2=待发货 3=已发货 4=已完成 5=已取消 6=退款中 7=已退款
orderPhone…否String → tickets_order.order_phone
payStatus…否PayStatus → tickets_order.pay_status 1=待支付 2=已支付 3=已退款 4=退款失败 5=退款中 6=退款申请
createdTimeRange…否Date[]

认证方式

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

响应参数

data 类型 PageInfo<TicketsOrderResponse>
参数名参数值是否必填参数类型描述说明
list…否List<T><TicketsOrderResponse>分页数据集合(元素结构见下一行)
id…否Longid → tickets_order_payment.id
orderNo…否String订单号 → tickets_order.order_no
merchantId…否Long商户Id,merchant表Id → tickets_order.merchant_id
shopId…否Long商铺Id,shop表Id → tickets_order.shop_id
memberId…否Long会员用户Id → tickets_order.member_id
orderType…否OrderType订单类型,1景区套票,2酒店民宿,3餐饮美食,4美食特产,5自驾路线,6非遗专区,7旅游卡 → tickets_order.order_type 1=景区套票 2=酒店民宿 3=餐饮美食 4=美食特产 5=自驾路线 6=非遗专区 7=旅游卡 8=旅游卡
orderSource…否OrderSource订单来源,1H5,2微信小程序,3支付宝小程序,4安卓APP,5IOSAPP → tickets_order.order_source 1=H5 2=微信小程序 3=支付宝小程序 4=安卓APP 5=IOSAPP 6=YOUZHENG 7=XIANGGONGHUI 8=XIANGYUEMA 9=ZHIHUIYOU 10=BCM 11=JIANHANG 24=MEIKE
buyNum…否Integer购买份数 → tickets_order.buy_num
orderAmount…否Integer订单金额,订单原始金额 → tickets_order.order_amount
receivableAmount…否Integer应收金额 → tickets_order.receivable_amount
payableAmount…否Integer实收金额 → tickets_order.payable_amount
reducedPrice…否Integer优惠金额 → tickets_order.reduced_price
discountAmount…否Integer折扣金额 → tickets_order.discount_amount
payStatus…否PayStatus支付状态,1=待支付 2=已支付 3=已退款 → tickets_order.pay_status 1=待支付 2=已支付 3=已退款 4=退款失败 5=退款中 6=退款申请
orderStatus…否OrderStatus订单状态,1=待确认 2=待发货 3=已发货 4=已完成 5=已取消 → tickets_order.order_status 1=待支付 2=待发货 3=已发货 4=已完成 5=已取消 6=退款中 7=已退款
orderPhone…否String下单人手机 → tickets_order.order_phone
orderContactMobile…否String → tickets_order.order_contact_mobile
orderContactName…否String → tickets_order.order_contact_name
orderRemark…否String订单备注 → tickets_order.order_remark
orderTime…否Date下单时间 → tickets_order.order_time
orderExpressTime…否Date订单失效时间 → tickets_order.order_express_time
createdBy…否String创建人 → tickets_order_payment.created_by
createdTime…否Date创建时间 → tickets_order_payment.created_time
updatedBy…否String修改人 → tickets_order_payment.updated_by
updatedTime…否Date修改时间 → tickets_order_payment.updated_time
skuName…否String
orderDate…否String
name…否String → tickets_check.name
skuPrice…否Integer → tickets_order_goods.sku_price
checkStatus…否String
refundAmount…否Integer
total…否Long数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "orderNo": "\"string\"",
    "merchantId": "1",
    "shopId": "1",
    "memberId": "1",
    "orderType": "1",
    "orderSource": "1",
    "buyNum": "1",
    "orderAmount": "1",
    "receivableAmount": "1",
    "payableAmount": "1"
  }
}
示例来自源码/导出内容,仅结构参考,非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:tickets_order、tickets_check、tickets_order_payment、tickets_order_goods 反查全部引用接口 →
  • TicketsOrderController#queryTicketsOrderPageAdmin
  • TicketsOrderService#queryPage(TicketsOrderServiceImpl)
  • TicketsOrderMapper#queryPage
  • TicketsCheckService#queryList(TicketsCheckServiceImpl)
  • TicketsCheckMapper#queryList
  • TicketsOrderPaymentService#queryList(TicketsOrderPaymentServiceImpl)
  • TicketsOrderPaymentMapper#queryList
  • BeanUtils.map → TicketsOrderQuery
  • BeanUtils.mapPage → TicketsOrderResponse
逻辑摘要:ticketsOrderService.queryPage;ticketsOrderGoodsService.get;ticketsCheckService.get;ticketsCheckService.queryList;ticketsOrderPaymentService.queryList;完整实现见源码 TicketsOrderController#queryTicketsOrderPageAdmin
源码内联注释(旧站解析结果)
  • 设置其他查询条件
  • TicketsCheck check = ticketsCheckService.get(TicketsCheckQue
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)
调用点证据
  • dscp-html-manage/src/api/tickets/index.ts:136 管理后台 · request
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据