POST
/cardCheck/singleRecordCardCheck管理后台【入园记录-增加单条补录功能】
旅游卡 / 核销
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/cardCheck/singleRecordCardCheck - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台（1 个前端）
- 需求上下文
- 维护人 / 最后改动luoli 2024-05-16
- 读写数据表
checker、card_resource_rule反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.card.CardCheckController#singleRecordCardCheck - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardCheckController.java:408 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无（渠道统一鉴权头见《认证方式》） | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| cardModelId | … | 是 | Long | 卡种id → card_resource_rule.card_model_id |
| resourceId | … | 是 | Long | 资源id |
| entranceId | … | 否 | Long | 景区入口id |
| cardNumber | … | 是 | String | 卡号 |
| checkTime | … | 否 | Date | 入园时间 |
| checkerId | … | 是 | Long | 和校园 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| void —— 不返回业务数据（外层包装见全局公共参数） | ||||
响应示例
成功响应示例
{"errcode":0,"errmsg":""}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表：checker、card_resource_rule 反查全部引用接口 →
- CardCheckController#singleRecordCardCheck
- CheckerService#unifiedConsume（CheckerServiceImpl）
其它依赖：CardCheckHandlerCache.get
逻辑摘要：查询详情（CardChannelUtil.getCardChannel）；查询详情（cardResourceRuleService.get）；调用 unifiedConsume（checkerService.unifiedConsume）
操作日志：card / 单记录核销
源码内联注释（旧站解析结果）
- 直接调用核销接口
- if (cardNo.length() == 16 || cardNo.length() == 20 || cardNo.length() == 19) {
- consumeRequest.setChannel(ChannelType.Channel_SSYKT.getValue());
- // 2024温泉联票-惠享版
- consumeRequest.setChannel(ChannelType.Channel_ZHY.getValue());
- // 2024温泉联票-尊享版
- } else {
- consumeRequest.setChannel(ChannelType.Channel_SZH.getValue());
旧站环境备注：pro：（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）
调用点证据
dscp-html-manage/src/api/card/index.ts:127管理后台 · request