POST/cqy/queryOpenapiCqyRecordPage管理后台

春秋游记录-分页查询

开放与对接 / 对接方 CQY（代号待业务确认）· OpenapiCqyRecordController#queryOpenapiCqyRecordPage

基本信息

  • 接口状态前端在用 置信度 高
  • 接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordPage
  • 请求方式POST
  • Content-Typeapplication/json
  • 暴露渠道管理后台　前缀 /manage-api
  • 名称来源源码注释
  • 调用方已确认在用 · 管理后台（1 个前端）
  • 需求上下文春秋游基础功能
  • 维护人 / 最后改动liuxu　2026-03-12　最近提交：春秋游基础功能
  • 读写数据表openapi_cqy_record　反查该表全部接口 →
  • 控制器com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#queryOpenapiCqyRecordPage
  • 源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/openapi/OpenapiCqyRecordController.java:183
  • 判定依据1 个调用点：dscp-html-manage/src/api/goods/index.ts

请求参数

分页字段来自 AbstractPageRequest：pageNo（不是 pageNum）· pageSize · orderBy

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 OpenapiCqyRecordPageRequest
参数名参数值是否必填参数类型描述说明
pageNo…否Integer当前页面
pageSize…否Integer每页记录数
orderBy…否String排序语句
keywords…否String关键字
orgId…否String → openapi_cqy_record.org_id
mobile…否String手机号 → openapi_cqy_record.mobile
userName…否String姓名 → openapi_cqy_record.user_name
actName…否String活动名称 → openapi_cqy_record.act_name
couponType…否String券类型 → openapi_cqy_record.coupon_type
couponNumber…否String券号 → openapi_cqy_record.coupon_number
couponStatus…否Integer券状态 0=领取失败 1=领取成功 2=退票 3=核销成功 → openapi_cqy_record.coupon_status
amount…否String累计发放金额 → openapi_cqy_record.amount
getTime…否Date领取日期 → openapi_cqy_record.get_time
consumeTime…否Date核销日期 → openapi_cqy_record.consume_time
orderId…否String订单号 → openapi_cqy_record.order_id
goodsId…否Long产品id → openapi_cqy_record.goods_id
goodsName…否String → openapi_cqy_record.goods_name
createTime…否Date创建日期 → openapi_cqy_record.create_time
updateTime…否Date更新时间 → openapi_cqy_record.update_time
remark…否String → openapi_cqy_record.remark

认证方式

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

响应参数

data 类型 PageInfo<OpenapiCqyRecordResponse>
参数名参数值是否必填参数类型描述说明
list…否List<T><OpenapiCqyRecordResponse>分页数据集合（元素结构见下一行）
id…否Longid → openapi_cqy_record.id
orgId…否String → openapi_cqy_record.org_id
mobile…否String手机号 → openapi_cqy_record.mobile
userName…否String姓名 → openapi_cqy_record.user_name
actName…否String活动名称 → openapi_cqy_record.act_name
couponType…否String券类型 → openapi_cqy_record.coupon_type
couponNumber…否String券号 → openapi_cqy_record.coupon_number
couponStatus…否Integer券状态 0=领取失败 1=领取成功 2=退票 3=核销成功 → openapi_cqy_record.coupon_status
amount…否String累计发放金额 → openapi_cqy_record.amount
getTime…否Date领取日期 → openapi_cqy_record.get_time
consumeTime…否Date核销日期 → openapi_cqy_record.consume_time
orderId…否String订单号 → openapi_cqy_record.order_id
goodsId…否Long产品id → openapi_cqy_record.goods_id
goodsName…否String → openapi_cqy_record.goods_name
createTime…否Date创建日期 → openapi_cqy_record.create_time
updateTime…否Date更新时间 → openapi_cqy_record.update_time
remark…否String → openapi_cqy_record.remark
checkerId…否Long核销人id → openapi_cqy_record.checker_id
checkerName…否String核销人员姓名 → openapi_cqy_record.checker_name
order…否Order
id…否Longid → openapi_cqy_record.id
orderId…否Long订单Id，主键 → openapi_cqy_record.order_id
merchantId…否Long商户Id，merchant表Id
shopId…否Long商铺Id，shop表Id
memberId…否Long会员用户Id
orderType…否OrderType订单类型，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食 1＝景区套票 2＝酒店民宿 3＝餐饮美食 4＝美食特产 5＝自驾路线 6＝非遗专区 7＝旅游卡 8＝旅游卡
orderSource…否OrderSource订单来源，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP 1＝H5 2＝微信小程序 3＝支付宝小程序 4＝安卓APP 5＝IOSAPP 6＝YOUZHENG 7＝XIANGGONGHUI 8＝XIANGYUEMA 9＝ZHIHUIYOU 10＝BCM 11＝JIANHANG 24＝MEIKE
buyNum…否Integer购买份数
orderAmount…否Integer订单金额(订单原始金额)
receivableAmount…否Integer应收金额
payableAmount…否Integer实收金额
reducedPrice…否Integer优惠金额
expressAmount…否Integer运费金额
discountAmount…否Integer折扣金额
isDelivery…否Integer是否配送(0=否；1=是)
payStatus…否PayStatus支付状态，1=待支付 2=已支付 3=已退款 1＝待支付 2＝已支付 3＝已退款 4＝退款失败 5＝退款中 6＝退款申请
orderStatus…否OrderStatus订单状态，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消 1＝待支付 2＝待发货 3＝已发货 4＝已完成 5＝已取消 6＝退款中 7＝已退款
orderPhone…否String下单人手机
orderRemark…否String订单备注
orderTime…否Date下单时间
orderExpressTime…否Date订单失效时间
isSendIntegral…否Integer订单积分是否已发放(0=否 1=是)
isComment…否Integer订单是否已经评价(0=否；1=是)
isProfitSharing…否Integer订单资金是否已冻结(0=已冻结 1=已解冻)
isSendCommission…否SendCommission订单佣金是否已发放，0=否 1=是 2=无佣金 0＝否 1＝是 2＝无佣金
icode…否String分销邀请码
shouldReturnCommission…否Integer应返佣金
reallyReturnCommission…否Integer实返佣金
createdBy…否String创建人id
createdTime…否LocalDateTime创建时间
updatedBy…否String更新人id
updatedTime…否LocalDateTime更新时间
total…否Long数据总数

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "list": "[]",
    "id": "1",
    "orgId": "\"string\"",
    "mobile": "\"string\"",
    "userName": "\"string\"",
    "actName": "\"string\"",
    "couponType": "\"string\"",
    "couponNumber": "\"string\"",
    "couponStatus": "1",
    "amount": "\"string\"",
    "getTime": "\"2026-01-01 00:00:00\"",
    "consumeTime": "\"2026-01-01 00:00:00\""
  }
}
示例来自源码/导出内容，仅结构参考，非线上真实数据。

附录 · 实现细节

调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：openapi_cqy_record　反查全部引用接口 →
  • OpenapiCqyRecordController#queryOpenapiCqyRecordPage
  • OpenapiCqyRecordService#queryPage（OpenapiCqyRecordServiceImpl）
  • OpenapiCqyRecordMapper#queryPage
  • BeanUtils.map → OpenapiCqyRecordQuery
  • BeanUtils.mapPage → OpenapiCqyRecordResponse
逻辑摘要：分页查询（openapiCqyRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释（旧站解析结果）
  • 设置其他查询条件
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
  • dscp-html-manage/src/api/goods/index.ts:54　管理后台 · request
← 春秋游记录-列表查询对接方 CQY（代号待业务确认）-reapal支付回 →
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据