POST/cqy/cqyCheck管理后台开放/回调

对接方 CQY（代号待业务确认）-cqy核销 · cqyCheck 推断名·方法名推断

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

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/cqy/cqyCheck
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台、开放/回调　前缀 /manage-api
名称来源方法名推断　补 javadoc 后自动转正
调用方已确认在用 · 景区核销（1 个前端）
需求上下文春秋游核销相关接口
维护人 / 最后改动liuxu　2026-04-07　最近提交：春秋游核销相关接口
读写数据表openapi_cqy_record、checker　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#cqyCheck
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/openapi/OpenapiCqyRecordController.java:570
判定依据1 个调用点：writeoff/common/http.api.js

请求参数

Header 请求参数

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

Query 请求参数

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

路径参数及说明

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

Body 请求参数

Body 类型 CqyCheckRequest

参数名	参数值	是否必填	参数类型	描述说明
userId	…	是	Long
checkCode	…	是	String

认证方式

免鉴权：@Route(auth = false) —— 该接口不校验登录态，改动前确认调用方与签名校验。

响应参数

data 类型 OpenapiCqyRecord

参数名	参数值	是否必填	参数类型	描述说明
id	…	否	Long	id → checker.id
orgId	…	否	String	单位id → openapi_cqy_record.org_id
mobile	…	否	String	手机号 → checker.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=核销成功 4=已过期 5=已使用 → 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	创建日期 → checker.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

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "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\"",
    "orderId": "\"string\""
  }
}

失败响应示例

{
  "data": null,
  "可能返回": [
    {
      "errcode": "99999",
      "errmsg": "服务内部错误"
    }
  ]
}

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

附录 · 实现细节

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

涉及数据表：openapi_cqy_record、checker　反查全部引用接口 →

OpenapiCqyRecordController#cqyCheck
OpenapiCqyRecordService#update（OpenapiCqyRecordServiceImpl）
OpenapiCqyRecordMapper#update
OrderService#update（OrderServiceImpl）
OrderMapper#update

逻辑摘要：查询详情（orderService.get）；查询详情（openapiCqyRecordService.get）；查询详情（checkerService.get）

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

调用点证据

writeoff/common/http.api.js:26　景区核销 · cqyCheckUrl

可能抛出的业务码：99999 服务内部错误　错误码字典 →