POST
/card/queryCardOrderPageH5小程序旅游卡订单 - 列表
旅游卡 / 卡(主表)
基本信息
- 接口状态未见调用·长期未改动(待确认)
- 接口URLPOST
https://dscp-dev.hn12301.net/h5-api/card/queryCardOrderPage - 请求方式
POST - Content-Type
application/json - 暴露渠道H5、小程序 前缀
/h5-api - 名称来源源码注释
- 调用方本次扫描未发现调用
- 需求上下文
- 维护人 / 最后改动luoli 2024-02-19
- 读写数据表
order_goods反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.card.CardController#queryCardOrderPage - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardController.java:1103 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无(渠道统一鉴权头见《认证方式》) | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| id | … | 否 | Long | 订单id → order_goods.id |
| orderStatus | … | 否 | OrderStatus | 订单状态 → order.order_status 1=待支付 2=待发货 3=已发货 4=已完成 5=已取消 6=退款中 7=已退款 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| list | … | 否 | List<T><CardOrderResponse> | 分页数据集合(元素结构见下一行) |
| id | … | 否 | Long | 主键 → order_goods.id |
| orderId | … | 否 | Long | 订单Id,主键 → order_goods.order_id |
| orderName | … | 否 | String | 订单旅游卡(商品)名称 |
| orderPic | … | 否 | String | 订单旅游卡(商品)主图 |
| buyNum | … | 否 | Integer | 购买份数 → order.buy_num |
| goodsAmount | … | 否 | Integer | 商品金额 |
| payableAmount | … | 否 | Integer | 实收金额 → order.payable_amount |
| payStatus | … | 否 | PayStatus | 支付状态,1=待支付 2=已支付 3=已退款 → order.pay_status 1=待支付 2=已支付 3=已退款 4=退款失败 5=退款中 6=退款申请 |
| orderStatus | … | 否 | OrderStatus | 订单状态 → order.order_status 1=待支付 2=待发货 3=已发货 4=已完成 5=已取消 6=退款中 7=已退款 |
| orderTime | … | 否 | Date | 下单时间 → order.order_time |
| payTime | … | 否 | Date | 支付时间 |
| cardNum | … | 否 | String | 卡号 |
| total | … | 否 | Long | 数据总数 |
响应示例
成功响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"list": "[]",
"id": "1",
"orderId": "1",
"orderName": "\"string\"",
"orderPic": "\"string\"",
"buyNum": "1",
"goodsAmount": "1",
"payableAmount": "1",
"payStatus": "1",
"orderStatus": "1",
"orderTime": "\"2026-01-01 00:00:00\"",
"payTime": "\"2026-01-01 00:00:00\""
}
}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:order_goods 反查全部引用接口 →
- CardController#queryCardOrderPage
- SessionUserService#getSessionId
- OrderService#queryPage(OrderServiceImpl)
- OrderMapper#queryPage
- OrderGoodsService#mustGet(OrderGoodsServiceImpl)
- OrderGoodsMapper#mustGet
- BeanUtils.map → OrderQuery
- BeanUtils.mapPage → CardOrderResponse
其它依赖:SessionUserService.getSessionId、OrderGoodsService.mustGet、GoodsCache.get
逻辑摘要:查询详情(sessionService.getSessionId);分页查询(orderService.queryPage);调用 mustGet(orderGoodsService.mustGet);入参与返回值经 BeanUtils 做对象/分页映射
源码内联注释(旧站解析结果)
- 会员用户Id
- 暂时只查询旅游卡订单
- 按订单时间排序
- 查询出旅游卡订单关联的商品信息
- 根据商品ID查询出商品信息
- 商品订单图片
- 商品订单名称
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)