开放接口/对接 · 12301-dscp 接口速查

CibController 3/12 在用

POST /cib/activateCibCard 未使用管理后台 #

激活兴动潇湘卡 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#activateCibCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_businessopenapi_channel_infoopenapi_channel_operatororderorder_operatelogmember

ControllerCibController#activateCibCard

ServiceOpenapiChannelBusinessService#queryList （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectList ⇒ 表 openapi_channel_business

ServiceOpenapiChannelBusinessService#activateCibCard （OpenapiChannelBusinessServiceImpl）

ServiceOpenapiChannelInfoService#get （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#selectById ⇒ 表 openapi_channel_info

MapperOpenapiChannelBusinessMapper#selectCount ⇒ 表 openapi_channel_business

ServiceOpenapiChannelOperatorService#get （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectById ⇒ 表 openapi_channel_operator

ServiceOrderService#maxOrderId （OrderServiceImpl）

MapperOrderMapper#maxOrderId ⇒ 表 order

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

ServiceOpenApiCardService#send （OpenApiCardServiceImpl）

转换BeanUtils.map → OrderOperatelog ⇒ 表 order_operatelog

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 32

AuthService.getAuthValueRedisCacheService.getRedisCacheService.deleteSessionUserService.getSessionIdCardModelCache.getSzhCardService.createOrderCardService.addCardOrderSessionUserService.getSessionUserShopCache.getLockService.lockChaosTransactionTemplate.executeOpenapiChannelInfoService.getOpenapiChannelRuleService.queryListCardModelService.queryListOpenapiChannelOrderService.queryListOrderHandlerCache.getCardCheckHandlerCache.getOpenapiChannelOrderService.addOpenapiChannelCardService.addSendSmsService.sendCardNotifySzhCardService.createOrderOpenapiChannelOrderService.updateOrderService.callbackOrderOrderService.getOrderService.updateOpenapiChannelRuleService.updateOpenapiChannelOperatorService.queryListOpenapiChannelBusinessService.getShopCache.getOpenapiChannelBusinessService.addOrderOperatelogService.addLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/activateCibCard
uat	https://dscp-uat.hn12301.net/manage-api/cib/activateCibCard
pro	https://dscp-uat.hn12301.net/manage-api/cib/activateCibCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibCardActivateRequest

字段	类型	必填	取值/校验	表 / 列	说明
userName	String			`openapi_channel_business`.`user_name`	@NotBlank(message = "用户姓名不能为空")
phone	String	是	必填/正则:^1[3-9]\\d{9}$	—	手机号码
userIdno	String			`openapi_channel_business`.`user_idno`	@NotBlank(message = "证件号码不能为空")
userIdType	IdType		1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_channel_business`.`user_id_type`	证件类型

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/activateCibCard

{
  "body": {
    "userName": "",
    "phone": "13800000000",
    "userIdno": "",
    "userIdType": "1"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要查询详情（authService.getAuthValue）；查询详情（redisCacheService.get）；调用 isBlank（StrUtil.isBlank）

内联注释

// 1. 验证短信验证码
//String cachedCode = (String) authService.getAuthValue(cacheKey);
String cachedCode = (String) redisCacheService.get(cacheKey, "CHAOS-AUTH");
if (StrUtil.isBlank(cachedCode)) {
return new OpenapiResponse(500, "验证码已过期，请重新获取", null);
}
if (!cachedCode.equals(request.getVerifyCode())) {
return new OpenapiResponse(501, "验证码错误", null);

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/cibLogin 未使用管理后台 #

兴业银行激活平台登录 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#cibLogin
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_usersystem_user_relationsystem_oauth2_access_token

ControllerCibController#cibLogin

转换BeanUtils.map → CibLoginResponse

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceUserRelationService#queryList （UserRelationServiceImpl）

MapperUserRelationMapper#selectList ⇒ 表 system_user_relation

ServiceOauth2AccessTokenService#queryList （Oauth2AccessTokenServiceImpl）

MapperOauth2AccessTokenMapper#selectList ⇒ 表 system_oauth2_access_token

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 7

RedisCacheService.getAuthService.getAuthValuePasswordEncoder.matchesOauth2AccessTokenService.createAccessTokenOauth2ClientService.mustGetAuthService.setAuthAccIdRedisCacheService.delete

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/cibLogin
uat	https://dscp-uat.hn12301.net/manage-api/cib/cibLogin
pro	https://dscp-uat.hn12301.net/manage-api/cib/cibLogin	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibLoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String	是	必填	`system_user`.`mobile`	手机号
password	String	是	必填	`system_user`.`password`	密码
verifyCode	String	是	必填	—	验证码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/cibLogin

{
  "body": {
    "mobile": "13800000000",
    "password": "",
    "verifyCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要查询详情（redisCacheService.get）；查询详情（authService.getAuthValue）；调用 isBlank（StrUtil.isBlank）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

1. 验证短信验证码
String cachedCode = (String) authService.getAuthValue(cacheKey);
查询用户信息
校验用户密码
查询用户组织关系
查询是否已登录过
创建token
设置会话信息

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/cibOperatorList 在用管理后台 #

（无摘要） · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#cibOperatorList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operator

ControllerCibController#cibOperatorList

ServiceOpenapiChannelOperatorService#queryList （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectList ⇒ 表 openapi_channel_operator

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/cibOperatorList
uat	https://dscp-uat.hn12301.net/manage-api/cib/cibOperatorList
pro	https://dscp-uat.hn12301.net/manage-api/cib/cibOperatorList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelOperator>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`openapi_channel_operator`.`id`	id
channelInfoId	Long	`openapi_channel_operator`.`channel_info_id`	业务渠道id
operatorId	Long	`openapi_channel_operator`.`operator_id`	业务员id
operatorName	String	`openapi_channel_operator`.`operator_name`	业务员姓名
totalCardNum	Integer	`openapi_channel_operator`.`total_card_num`	可激活卡总数量
dayCardNum	Integer	`openapi_channel_operator`.`day_card_num`	每日可激活数量
status	Integer	`openapi_channel_operator`.`status`	业务员状态
addDate	Date	`openapi_channel_operator`.`add_date`	添加时间
merchantId	Long	`openapi_channel_operator`.`merchant_id`
shopId	Long	`openapi_channel_operator`.`shop_id`

示例

请求示例（自动生成，仅结构参考）

POST /cib/cibOperatorList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "channelInfoId": 1,
      "operatorId": 1,
      "operatorName": "",
      "totalCardNum": 0,
      "dayCardNum": 0,
      "status": 0,
      "addDate": "2026-01-01 12:00:00",
      "merchantId": 1,
      "shopId": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelOperatorService.queryList）

前端调用方

dscp-html-manage cibOperatorList exact

POST /cib/cibStat 在用管理后台 #

（无摘要） · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#cibStat
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_businessopenapi_channel_operator

ControllerCibController#cibStat

ServiceOpenapiChannelBusinessService#cibStat （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#cibStat ⇒ 表 openapi_channel_business

ServiceOpenapiChannelOperatorService#get （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectById ⇒ 表 openapi_channel_operator

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/cibStat
uat	https://dscp-uat.hn12301.net/manage-api/cib/cibStat
pro	https://dscp-uat.hn12301.net/manage-api/cib/cibStat	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibStatRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
operatorId	Long		`openapi_channel_business`.`operator_id`
operatorName	String		`openapi_channel_business`.`operator_name`
userPhone	String		`openapi_channel_business`.`user_phone`
activeTimeRange	Date[]		—
cardNumber	String		`openapi_channel_business`.`card_number`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<CibStatResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
operatorName	String	`openapi_channel_business`.`operator_name`
num	Integer	—
operatorId	Long	`openapi_channel_business`.`operator_id`
totalNum	Integer	—
dayNum	Integer	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/cibStat

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "operatorId": 1,
    "operatorName": "",
    "userPhone": "13800000000",
    "activeTimeRange": "2026-01-01 12:00:00",
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "operatorName": "",
        "num": 0,
        "operatorId": 1,
        "totalNum": 0,
        "dayNum": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 cibStat（openapiChannelBusinessService.cibStat）；查询详情（openapiChannelOperatorService.get）

内联注释

如果起始索引超出了列表范围，返回空列表

前端调用方

dscp-html-manage cibStat exact

POST /cib/cibUserLogin 未使用管理后台 #

用户端登录 - 验证用户是否有卡 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#cibUserLogin
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_businesscard_bind

ControllerCibController#cibUserLogin

ServiceOpenapiChannelBusinessService#queryList （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectList ⇒ 表 openapi_channel_business

ServiceCardBindService#queryList （CardBindServiceImpl）

MapperCardBindMapper#selectList ⇒ 表 card_bind

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

AuthService.getAuthValueRedisCacheService.getRedisCacheService.delete

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/cibUserLogin
uat	https://dscp-uat.hn12301.net/manage-api/cib/cibUserLogin
pro	https://dscp-uat.hn12301.net/manage-api/cib/cibUserLogin	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibUserLoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String	是	必填	—	手机号
verifyCode	String	是	必填	—	验证码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/cibUserLogin

{
  "body": {
    "mobile": "13800000000",
    "verifyCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要列表查询（openapiChannelBusinessService.queryList）；查询详情（authService.getAuthValue）；查询详情（redisCacheService.get）

内联注释

// 1. 查询用户是否有卡
OpenapiChannelBusinessQuery query = OpenapiChannelBusinessQuery.builder()
.userPhone(request.getMobile())
.isDeleted(false)
.build();
// // 如果没有找到卡号，则返回错误
if (businessList.isEmpty()) {
return new OpenapiResponse(502, "该手机号码没有可使用权益，请重新输入", null);

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/exportCibStatDetail 未使用管理后台 #

（无摘要） · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#exportCibStatDetail
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_businesscard_bind

ControllerCibController#exportCibStatDetail

ServiceOpenapiChannelBusinessService#cibStatDetail （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#queryList ⇒ 表 openapi_channel_business

ServiceCardBindService#get （CardBindServiceImpl）

MapperCardBindMapper#selectById ⇒ 表 card_bind

MapperOpenapiChannelBusinessMapper#cibStatDetail ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/exportCibStatDetail
uat	https://dscp-uat.hn12301.net/manage-api/cib/exportCibStatDetail
pro	https://dscp-uat.hn12301.net/manage-api/cib/exportCibStatDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cib/exportCibStatDetail

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 cibStatDetail（openapiChannelBusinessService.cibStatDetail）；查询详情（cardBindService.get）；调用 cibStatDetail（openapiChannelBusinessMapper.cibStatDetail）

内联注释

if (!result.isEmpty()) {
for (OpenapiChannelBusiness temp : result) {
if (cardBind != null) {
temp.setUserName(cardBind.getName());
temp.setUserPhone(cardBind.getPhone());
temp.setUserIdno(cardBind.getIdentityNo());
temp.setUserIdType(cardBind.getIdType());
} else {

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/getActivationDetailList 未使用管理后台 #

获取激活明细列表 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#getActivationDetailList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerCibController#getActivationDetailList

ServiceOpenapiChannelBusinessService#queryActivationDetailList （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectPage ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/getActivationDetailList
uat	https://dscp-uat.hn12301.net/manage-api/cib/getActivationDetailList
pro	https://dscp-uat.hn12301.net/manage-api/cib/getActivationDetailList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ActivationDetailListRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
operatorId	Long		`openapi_channel_business`.`operator_id`	操作员ID
activeStatus	Integer		`openapi_channel_business`.`active_status`	激活状态：0-确认中，1-已绑定不传则查询全部状态(0,1)

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<ActivationDetailItemResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_channel_business`.`id`	业务ID
activeTime	Date	`openapi_channel_business`.`active_time`	激活时间
cardNumber	String	`openapi_channel_business`.`card_number`	卡号
userName	String	`openapi_channel_business`.`user_name`	用户姓名
userPhone	String	`openapi_channel_business`.`user_phone`	用户手机号
orderNo	String	`openapi_channel_business`.`order_no`	订单号
userIdno	String	`openapi_channel_business`.`user_idno`
activeStatus	Integer	`openapi_channel_business`.`active_status`	激活状态：0-确认中，1-已绑定
statusDesc	String	—	状态描述

示例

请求示例（自动生成，仅结构参考）

POST /cib/getActivationDetailList

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "operatorId": 1,
    "activeStatus": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "activeTime": "2026-01-01 12:00:00",
        "cardNumber": "",
        "userName": "",
        "userPhone": "13800000000",
        "orderNo": "",
        "userIdno": "",
        "activeStatus": 0,
        "statusDesc": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要列表查询（openapiChannelBusinessService.queryActivationDetailList）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/getCibStatDetail 在用管理后台 #

（无摘要） · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#getCibStatDetail
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_businesscard_bind

ControllerCibController#getCibStatDetail

ServiceOpenapiChannelBusinessService#cibStatDetail （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#queryList ⇒ 表 openapi_channel_business

ServiceCardBindService#get （CardBindServiceImpl）

MapperCardBindMapper#selectById ⇒ 表 card_bind

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/getCibStatDetail
uat	https://dscp-uat.hn12301.net/manage-api/cib/getCibStatDetail
pro	https://dscp-uat.hn12301.net/manage-api/cib/getCibStatDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibStatRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
operatorId	Long		`openapi_channel_business`.`operator_id`
operatorName	String		`openapi_channel_business`.`operator_name`
userPhone	String		`openapi_channel_business`.`user_phone`
activeTimeRange	Date[]		—
cardNumber	String		`openapi_channel_business`.`card_number`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelBusiness>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`openapi_channel_business`.`id`	ID
channelId	Long		`openapi_channel_business`.`channel_id`	渠道id
channelName	String		`openapi_channel_business`.`channel_name`	渠道名称
operatorId	Long		`openapi_channel_business`.`operator_id`	业务员id
operatorName	String		`openapi_channel_business`.`operator_name`	业务员姓名
orderNo	String		`openapi_channel_business`.`order_no`	订单号
cardModelId	Long		`openapi_channel_business`.`card_model_id`	卡种id
cardModelName	String		`openapi_channel_business`.`card_model_name`	卡种名称
cardNumber	String		`openapi_channel_business`.`card_number`	卡号
activeTime	Date		`openapi_channel_business`.`active_time`	激活时间
activeStatus	Integer		`openapi_channel_business`.`active_status`	激活状态
cardExpireTime	Date		`openapi_channel_business`.`card_expire_time`	卡过期时间
userName	String		`openapi_channel_business`.`user_name`	持卡人姓名
userIdno	String		`openapi_channel_business`.`user_idno`	持卡人证件号码
userPhone	String		`openapi_channel_business`.`user_phone`	持卡人手机号
userIdType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_channel_business`.`user_id_type`	持卡人证件类型
createdTime	Date		`openapi_channel_business`.`created_time`	创建时间
isDeleted	Boolean		`openapi_channel_business`.`is_deleted`	是否删除
createdBy	Long		`openapi_channel_business`.`created_by`	创建人
updatedBy	Long		`openapi_channel_business`.`updated_by`	更新人
updatedTime	Date		`openapi_channel_business`.`updated_time`	更新时间
status	Integer		`openapi_channel_business`.`status`	业务状态
activePlatform	Long		`openapi_channel_business`.`active_platform`	激活平台
activePlatformName	String		`openapi_channel_business`.`active_platform_name`	激活平台名称
bindPlatform	Long		`openapi_channel_business`.`bind_platform`	绑卡平台
bindPlatformName	String		`openapi_channel_business`.`bind_platform_name`	绑卡平台名称
cardStatus	Integer		`openapi_channel_business`.`card_status`	卡状态
bindTime	Date		`openapi_channel_business`.`bind_time`	绑定时间

示例

请求示例（自动生成，仅结构参考）

POST /cib/getCibStatDetail

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "operatorId": 1,
    "operatorName": "",
    "userPhone": "13800000000",
    "activeTimeRange": "2026-01-01 12:00:00",
    "cardNumber": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "channelId": 1,
        "channelName": "",
        "operatorId": 1,
        "operatorName": "",
        "orderNo": "",
        "cardModelId": 1,
        "cardModelName": "",
        "cardNumber": "",
        "activeTime": "2026-01-01 12:00:00",
        "activeStatus": 0,
        "cardExpireTime": "2026-01-01 12:00:00",
        "userName": "",
        "userIdno": "",
        "userPhone": "13800000000",
        "userIdType": "1",
        "createdTime": "2026-01-01 12:00:00",
        "isDeleted": false,
        "createdBy": 0,
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "status": 0,
        "activePlatform": 0,
        "activePlatformName": "",
        "bindPlatform": 0,
        "bindPlatformName": "",
        "cardStatus": 0,
        "bindTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 cibStatDetail（openapiChannelBusinessService.cibStatDetail）；调用 isNotEmpty（StrUtil.isNotEmpty）；查询详情（cardBindService.get）

内联注释

如果起始索引超出了列表范围，返回空列表

前端调用方

dscp-html-manage getCibStatDetail exact

POST /cib/getOperatorActivationStatus 未使用管理后台 #

获取业务员激活信息 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#getOperatorActivationStatus
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerCibController#getOperatorActivationStatus

ServiceOpenapiChannelOperatorService#getActivationStatus （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelBusinessMapper#selectCount ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/getOperatorActivationStatus
uat	https://dscp-uat.hn12301.net/manage-api/cib/getOperatorActivationStatus
pro	https://dscp-uat.hn12301.net/manage-api/cib/getOperatorActivationStatus	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OperatorActivationStatusRequest

字段	类型	必填	取值/校验	表 / 列	说明
operatorId	Long	是	必填	`openapi_channel_business`.`operator_id`	业务员ID

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OperatorActivationStatusResponse　（object）

字段	类型	表 / 列	说明
operatorName	String	`openapi_channel_business`.`operator_name`	业务员姓名
totalAvailable	Integer	—	可激活总量
totalActivated	Integer	—	已激活总量
todayActivated	Integer	—	当日激活量
remainingAvailable	Integer	—	剩余可激活量

示例

请求示例（自动生成，仅结构参考）

POST /cib/getOperatorActivationStatus

{
  "body": {
    "operatorId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "operatorName": "",
    "totalAvailable": 0,
    "totalActivated": 0,
    "todayActivated": 0,
    "remainingAvailable": 0
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelOperatorService.getActivationStatus）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/queryCibCard 未使用管理后台 #

查询兴动潇湘卡 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#queryCibCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerCibController#queryCibCard

ServiceOpenapiChannelBusinessService#queryCibCard （OpenapiChannelBusinessServiceImpl）

ServiceOpenapiChannelInfoService#get （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#selectById ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/queryCibCard
uat	https://dscp-uat.hn12301.net/manage-api/cib/queryCibCard
pro	https://dscp-uat.hn12301.net/manage-api/cib/queryCibCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibCardQueryRequest

字段	类型	必填	取值/校验	表 / 列	说明
orderNo	String	是	必填	—	订单号

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/queryCibCard

{
  "body": {
    "orderNo": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要调用 queryCibCard（openapiChannelBusinessService.queryCibCard）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/sendLoginVerifyCode 未使用管理后台 #

短信-发送验证码 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#sendVerifyCode
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_useropenapi_channel_businesssms_log

ControllerCibController#sendVerifyCode

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceOpenapiChannelBusinessService#queryList （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectList ⇒ 表 openapi_channel_business

ServiceSmsLogService#add （SmsLogServiceImpl）

MapperSmsLogMapper#insert ⇒ 表 sms_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

CacheService.putIfAbsentRedisCacheService.putAuthService.setAuthValueSendSmsService.sendVerifyCodeSmsService.sendSms

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/sendLoginVerifyCode
uat	https://dscp-uat.hn12301.net/manage-api/cib/sendLoginVerifyCode
pro	https://dscp-uat.hn12301.net/manage-api/cib/sendLoginVerifyCode	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　VerifyCodeSendRequest

字段	类型	必填	取值/校验	表 / 列	说明
smsType	SmsType		1兴业银行激活平台登录2兴业银行激活平台激活3兴业银行H5登录99未知	`sms_log`.`sms_type`	发送验证码类型
mobile	String			`system_user`.`mobile`	手机号

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	`sms_log`.`code`
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/sendLoginVerifyCode

{
  "body": {
    "smsType": "1",
    "mobile": "13800000000"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要查询详情（userService.get）；列表查询（openapiChannelBusinessService.queryList）；调用 putIfAbsent（cacheService.putIfAbsent）

内联注释

确保短信类型已设置，默认为CIB_OTHER
1. 查询用户是否有卡
如果没有找到卡号，则返回错误
2. 过滤出已激活成功的卡片（状态为1-已绑定）
List<OpenapiChannelBusiness> activatedCards = businessList.stream()
.filter(card -> card.getActiveStatus() != null && card.getActiveStatus() == 1)
.collect(Collectors.toList());
//if (activatedCards.isEmpty()) {

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cib/verifySmsCode 未使用管理后台 #

验证短信验证码 · CibController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.CibController#verifySmsCode
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerCibController#verifySmsCode

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

RedisCacheService.getRedisCacheService.delete

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cib/verifySmsCode
uat	https://dscp-uat.hn12301.net/manage-api/cib/verifySmsCode
pro	https://dscp-uat.hn12301.net/manage-api/cib/verifySmsCode	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　VerifySmsCodeRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String	是	必填/正则:^1[3-9]\\d{9}$	—	手机号码
verifyCode	String	是	必填	—	验证码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /cib/verifySmsCode

{
  "body": {
    "mobile": "13800000000",
    "verifyCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要查询详情（redisCacheService.get）；调用 isBlank（StrUtil.isBlank）；删除（redisCacheService.delete）

内联注释

构建缓存Key
从Redis缓存中获取验证码
检查验证码是否存在
检查验证码是否匹配
验证通过后删除缓存中的验证码，防止重复使用
验证成功，返回用户信息（这里可以根据需要返回必要的信息，用于下一步激活流程）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcAppointConfigController 0/6 在用

POST /openapiBjcAppointConfig/addOpenapiBjcAppointConfig 未使用管理后台 #

旅游卡预约配置-新增 · OpenapiBjcAppointConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointConfigController#addOpenapiBjcAppointConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_config

ControllerOpenapiBjcAppointConfigController#addOpenapiBjcAppointConfig

转换BeanUtils.map → OpenapiBjcAppointConfig ⇒ 表 openapi_bjc_appoint_config

ServiceOpenapiBjcAppointConfigService#add （OpenapiBjcAppointConfigServiceImpl）

MapperOpenapiBjcAppointConfigMapper#insert ⇒ 表 openapi_bjc_appoint_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointConfig/addOpenapiBjcAppointConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/addOpenapiBjcAppointConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/addOpenapiBjcAppointConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointConfigAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointConfig/addOpenapiBjcAppointConfig

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcAppointConfigService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointConfig/deleteOpenapiBjcAppointConfig 未使用管理后台 #

旅游卡预约配置-删除 · OpenapiBjcAppointConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointConfigController#deleteOpenapiBjcAppointConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_config

ControllerOpenapiBjcAppointConfigController#deleteOpenapiBjcAppointConfig

ServiceOpenapiBjcAppointConfigService#delete （OpenapiBjcAppointConfigServiceImpl）

MapperOpenapiBjcAppointConfigMapper#deleteById ⇒ 表 openapi_bjc_appoint_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointConfig/deleteOpenapiBjcAppointConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/deleteOpenapiBjcAppointConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/deleteOpenapiBjcAppointConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_appoint_config`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointConfig/deleteOpenapiBjcAppointConfig

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcAppointConfigService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointConfig/getOpenapiBjcAppointConfig 未使用管理后台 #

旅游卡预约配置-详情 · OpenapiBjcAppointConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointConfigController#getOpenapiBjcAppointConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_config

ControllerOpenapiBjcAppointConfigController#getOpenapiBjcAppointConfig

ServiceOpenapiBjcAppointConfigService#get （OpenapiBjcAppointConfigServiceImpl）

MapperOpenapiBjcAppointConfigMapper#selectById ⇒ 表 openapi_bjc_appoint_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointConfig/getOpenapiBjcAppointConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/getOpenapiBjcAppointConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/getOpenapiBjcAppointConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_appoint_config`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcAppointConfigResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_appoint_config`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointConfig/getOpenapiBjcAppointConfig

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcAppointConfigService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointConfig/queryOpenapiBjcAppointConfigList 未使用管理后台 #

旅游卡预约配置-列表查询 · OpenapiBjcAppointConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointConfigController#queryOpenapiBjcAppointConfigList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_config

ControllerOpenapiBjcAppointConfigController#queryOpenapiBjcAppointConfigList

转换BeanUtils.map → OpenapiBjcAppointConfigQuery

ServiceOpenapiBjcAppointConfigService#queryList （OpenapiBjcAppointConfigServiceImpl）

MapperOpenapiBjcAppointConfigMapper#selectList ⇒ 表 openapi_bjc_appoint_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointConfig/queryOpenapiBjcAppointConfigList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/queryOpenapiBjcAppointConfigList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/queryOpenapiBjcAppointConfigList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointConfigListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcAppointConfigResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_appoint_config`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointConfig/queryOpenapiBjcAppointConfigList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcAppointConfigService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointConfig/queryOpenapiBjcAppointConfigPage 未使用管理后台 #

旅游卡预约配置-分页查询 · OpenapiBjcAppointConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointConfigController#queryOpenapiBjcAppointConfigPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_config

ControllerOpenapiBjcAppointConfigController#queryOpenapiBjcAppointConfigPage

转换BeanUtils.map → OpenapiBjcAppointConfigQuery

ServiceOpenapiBjcAppointConfigService#queryPage （OpenapiBjcAppointConfigServiceImpl）

MapperOpenapiBjcAppointConfigMapper#selectPage ⇒ 表 openapi_bjc_appoint_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointConfig/queryOpenapiBjcAppointConfigPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/queryOpenapiBjcAppointConfigPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/queryOpenapiBjcAppointConfigPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointConfigPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcAppointConfigResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_appoint_config`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointConfig/queryOpenapiBjcAppointConfigPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcAppointConfigService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointConfig/updateOpenapiBjcAppointConfig 未使用管理后台 #

旅游卡预约配置-更新 · OpenapiBjcAppointConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointConfigController#updateOpenapiBjcAppointConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_config

ControllerOpenapiBjcAppointConfigController#updateOpenapiBjcAppointConfig

转换BeanUtils.map → OpenapiBjcAppointConfig ⇒ 表 openapi_bjc_appoint_config

ServiceOpenapiBjcAppointConfigService#update （OpenapiBjcAppointConfigServiceImpl）

MapperOpenapiBjcAppointConfigMapper#updateById ⇒ 表 openapi_bjc_appoint_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointConfig/updateOpenapiBjcAppointConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/updateOpenapiBjcAppointConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointConfig/updateOpenapiBjcAppointConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointConfigUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_appoint_config`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointConfig/updateOpenapiBjcAppointConfig

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcAppointConfigService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcAppointRecordController 0/6 在用

POST /openapiBjcAppointRecord/addOpenapiBjcAppointRecord 未使用管理后台 #

北京卡预约记录表-新增 · OpenapiBjcAppointRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointRecordController#addOpenapiBjcAppointRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_record

ControllerOpenapiBjcAppointRecordController#addOpenapiBjcAppointRecord

转换BeanUtils.map → OpenapiBjcAppointRecord ⇒ 表 openapi_bjc_appoint_record

ServiceOpenapiBjcAppointRecordService#add （OpenapiBjcAppointRecordServiceImpl）

MapperOpenapiBjcAppointRecordMapper#insert ⇒ 表 openapi_bjc_appoint_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointRecord/addOpenapiBjcAppointRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/addOpenapiBjcAppointRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/addOpenapiBjcAppointRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointRecordAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointRecord/addOpenapiBjcAppointRecord

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcAppointRecordService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointRecord/deleteOpenapiBjcAppointRecord 未使用管理后台 #

北京卡预约记录表-删除 · OpenapiBjcAppointRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointRecordController#deleteOpenapiBjcAppointRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_record

ControllerOpenapiBjcAppointRecordController#deleteOpenapiBjcAppointRecord

ServiceOpenapiBjcAppointRecordService#delete （OpenapiBjcAppointRecordServiceImpl）

MapperOpenapiBjcAppointRecordMapper#deleteById ⇒ 表 openapi_bjc_appoint_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointRecord/deleteOpenapiBjcAppointRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/deleteOpenapiBjcAppointRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/deleteOpenapiBjcAppointRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_appoint_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointRecord/deleteOpenapiBjcAppointRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcAppointRecordService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointRecord/getOpenapiBjcAppointRecord 未使用管理后台 #

北京卡预约记录表-详情 · OpenapiBjcAppointRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointRecordController#getOpenapiBjcAppointRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_record

ControllerOpenapiBjcAppointRecordController#getOpenapiBjcAppointRecord

ServiceOpenapiBjcAppointRecordService#get （OpenapiBjcAppointRecordServiceImpl）

MapperOpenapiBjcAppointRecordMapper#selectById ⇒ 表 openapi_bjc_appoint_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointRecord/getOpenapiBjcAppointRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/getOpenapiBjcAppointRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/getOpenapiBjcAppointRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_appoint_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcAppointRecordResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_appoint_record`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointRecord/getOpenapiBjcAppointRecord

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcAppointRecordService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointRecord/queryOpenapiBjcAppointRecordList 未使用管理后台 #

北京卡预约记录表-列表查询 · OpenapiBjcAppointRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointRecordController#queryOpenapiBjcAppointRecordList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_record

ControllerOpenapiBjcAppointRecordController#queryOpenapiBjcAppointRecordList

转换BeanUtils.map → OpenapiBjcAppointRecordQuery

ServiceOpenapiBjcAppointRecordService#queryList （OpenapiBjcAppointRecordServiceImpl）

MapperOpenapiBjcAppointRecordMapper#selectList ⇒ 表 openapi_bjc_appoint_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointRecord/queryOpenapiBjcAppointRecordList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/queryOpenapiBjcAppointRecordList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/queryOpenapiBjcAppointRecordList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointRecordListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcAppointRecordResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_appoint_record`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointRecord/queryOpenapiBjcAppointRecordList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcAppointRecordService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointRecord/queryOpenapiBjcAppointRecordPage 未使用管理后台 #

北京卡预约记录表-分页查询 · OpenapiBjcAppointRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointRecordController#queryOpenapiBjcAppointRecordPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_record

ControllerOpenapiBjcAppointRecordController#queryOpenapiBjcAppointRecordPage

转换BeanUtils.map → OpenapiBjcAppointRecordQuery

ServiceOpenapiBjcAppointRecordService#queryPage （OpenapiBjcAppointRecordServiceImpl）

MapperOpenapiBjcAppointRecordMapper#selectPage ⇒ 表 openapi_bjc_appoint_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointRecord/queryOpenapiBjcAppointRecordPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/queryOpenapiBjcAppointRecordPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/queryOpenapiBjcAppointRecordPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcAppointRecordResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_appoint_record`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointRecord/queryOpenapiBjcAppointRecordPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcAppointRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointRecord/updateOpenapiBjcAppointRecord 未使用管理后台 #

北京卡预约记录表-更新 · OpenapiBjcAppointRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointRecordController#updateOpenapiBjcAppointRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_record

ControllerOpenapiBjcAppointRecordController#updateOpenapiBjcAppointRecord

转换BeanUtils.map → OpenapiBjcAppointRecord ⇒ 表 openapi_bjc_appoint_record

ServiceOpenapiBjcAppointRecordService#update （OpenapiBjcAppointRecordServiceImpl）

MapperOpenapiBjcAppointRecordMapper#updateById ⇒ 表 openapi_bjc_appoint_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointRecord/updateOpenapiBjcAppointRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/updateOpenapiBjcAppointRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointRecord/updateOpenapiBjcAppointRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointRecordUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_appoint_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointRecord/updateOpenapiBjcAppointRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcAppointRecordService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcAppointScenicController 0/6 在用

POST /openapiBjcAppointScenic/addOpenapiBjcAppointScenic 未使用管理后台 #

卡预约景区列表-新增 · OpenapiBjcAppointScenicController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointScenicController#addOpenapiBjcAppointScenic
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_scenic

ControllerOpenapiBjcAppointScenicController#addOpenapiBjcAppointScenic

转换BeanUtils.map → OpenapiBjcAppointScenic ⇒ 表 openapi_bjc_appoint_scenic

ServiceOpenapiBjcAppointScenicService#add （OpenapiBjcAppointScenicServiceImpl）

MapperOpenapiBjcAppointScenicMapper#insert ⇒ 表 openapi_bjc_appoint_scenic

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointScenic/addOpenapiBjcAppointScenic
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/addOpenapiBjcAppointScenic
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/addOpenapiBjcAppointScenic	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointScenicAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointScenic/addOpenapiBjcAppointScenic

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcAppointScenicService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointScenic/deleteOpenapiBjcAppointScenic 未使用管理后台 #

卡预约景区列表-删除 · OpenapiBjcAppointScenicController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointScenicController#deleteOpenapiBjcAppointScenic
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_scenic

ControllerOpenapiBjcAppointScenicController#deleteOpenapiBjcAppointScenic

ServiceOpenapiBjcAppointScenicService#delete （OpenapiBjcAppointScenicServiceImpl）

MapperOpenapiBjcAppointScenicMapper#deleteById ⇒ 表 openapi_bjc_appoint_scenic

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointScenic/deleteOpenapiBjcAppointScenic
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/deleteOpenapiBjcAppointScenic
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/deleteOpenapiBjcAppointScenic	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_appoint_scenic`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointScenic/deleteOpenapiBjcAppointScenic

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcAppointScenicService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointScenic/getOpenapiBjcAppointScenic 未使用管理后台 #

卡预约景区列表-详情 · OpenapiBjcAppointScenicController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointScenicController#getOpenapiBjcAppointScenic
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_scenic

ControllerOpenapiBjcAppointScenicController#getOpenapiBjcAppointScenic

ServiceOpenapiBjcAppointScenicService#get （OpenapiBjcAppointScenicServiceImpl）

MapperOpenapiBjcAppointScenicMapper#selectById ⇒ 表 openapi_bjc_appoint_scenic

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointScenic/getOpenapiBjcAppointScenic
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/getOpenapiBjcAppointScenic
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/getOpenapiBjcAppointScenic	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_appoint_scenic`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcAppointScenicResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_appoint_scenic`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointScenic/getOpenapiBjcAppointScenic

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcAppointScenicService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointScenic/queryOpenapiBjcAppointScenicList 未使用管理后台 #

卡预约景区列表-列表查询 · OpenapiBjcAppointScenicController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointScenicController#queryOpenapiBjcAppointScenicList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_scenic

ControllerOpenapiBjcAppointScenicController#queryOpenapiBjcAppointScenicList

转换BeanUtils.map → OpenapiBjcAppointScenicQuery

ServiceOpenapiBjcAppointScenicService#queryList （OpenapiBjcAppointScenicServiceImpl）

MapperOpenapiBjcAppointScenicMapper#selectList ⇒ 表 openapi_bjc_appoint_scenic

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointScenic/queryOpenapiBjcAppointScenicList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/queryOpenapiBjcAppointScenicList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/queryOpenapiBjcAppointScenicList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointScenicListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcAppointScenicResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_appoint_scenic`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointScenic/queryOpenapiBjcAppointScenicList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcAppointScenicService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointScenic/queryOpenapiBjcAppointScenicPage 未使用管理后台 #

卡预约景区列表-分页查询 · OpenapiBjcAppointScenicController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointScenicController#queryOpenapiBjcAppointScenicPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_scenic

ControllerOpenapiBjcAppointScenicController#queryOpenapiBjcAppointScenicPage

转换BeanUtils.map → OpenapiBjcAppointScenicQuery

ServiceOpenapiBjcAppointScenicService#queryPage （OpenapiBjcAppointScenicServiceImpl）

MapperOpenapiBjcAppointScenicMapper#selectPage ⇒ 表 openapi_bjc_appoint_scenic

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointScenic/queryOpenapiBjcAppointScenicPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/queryOpenapiBjcAppointScenicPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/queryOpenapiBjcAppointScenicPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointScenicPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcAppointScenicResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_appoint_scenic`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointScenic/queryOpenapiBjcAppointScenicPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcAppointScenicService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcAppointScenic/updateOpenapiBjcAppointScenic 未使用管理后台 #

卡预约景区列表-更新 · OpenapiBjcAppointScenicController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcAppointScenicController#updateOpenapiBjcAppointScenic
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_appoint_scenic

ControllerOpenapiBjcAppointScenicController#updateOpenapiBjcAppointScenic

转换BeanUtils.map → OpenapiBjcAppointScenic ⇒ 表 openapi_bjc_appoint_scenic

ServiceOpenapiBjcAppointScenicService#update （OpenapiBjcAppointScenicServiceImpl）

MapperOpenapiBjcAppointScenicMapper#updateById ⇒ 表 openapi_bjc_appoint_scenic

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcAppointScenic/updateOpenapiBjcAppointScenic
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/updateOpenapiBjcAppointScenic
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcAppointScenic/updateOpenapiBjcAppointScenic	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcAppointScenicUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_appoint_scenic`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcAppointScenic/updateOpenapiBjcAppointScenic

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcAppointScenicService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcCardInfoController 0/6 在用

POST /openapiBjcCardInfo/addOpenapiBjcCardInfo 未使用管理后台 #

北京卡信息表-新增 · OpenapiBjcCardInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcCardInfoController#addOpenapiBjcCardInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_card_info

ControllerOpenapiBjcCardInfoController#addOpenapiBjcCardInfo

转换BeanUtils.map → OpenapiBjcCardInfo ⇒ 表 openapi_bjc_card_info

ServiceOpenapiBjcCardInfoService#add （OpenapiBjcCardInfoServiceImpl）

MapperOpenapiBjcCardInfoMapper#insert ⇒ 表 openapi_bjc_card_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcCardInfo/addOpenapiBjcCardInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/addOpenapiBjcCardInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/addOpenapiBjcCardInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcCardInfoAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcCardInfo/addOpenapiBjcCardInfo

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcCardInfoService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcCardInfo/deleteOpenapiBjcCardInfo 未使用管理后台 #

北京卡信息表-删除 · OpenapiBjcCardInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcCardInfoController#deleteOpenapiBjcCardInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_card_info

ControllerOpenapiBjcCardInfoController#deleteOpenapiBjcCardInfo

ServiceOpenapiBjcCardInfoService#delete （OpenapiBjcCardInfoServiceImpl）

MapperOpenapiBjcCardInfoMapper#deleteById ⇒ 表 openapi_bjc_card_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcCardInfo/deleteOpenapiBjcCardInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/deleteOpenapiBjcCardInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/deleteOpenapiBjcCardInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_card_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcCardInfo/deleteOpenapiBjcCardInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcCardInfoService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcCardInfo/getOpenapiBjcCardInfo 未使用管理后台 #

北京卡信息表-详情 · OpenapiBjcCardInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcCardInfoController#getOpenapiBjcCardInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_card_info

ControllerOpenapiBjcCardInfoController#getOpenapiBjcCardInfo

ServiceOpenapiBjcCardInfoService#get （OpenapiBjcCardInfoServiceImpl）

MapperOpenapiBjcCardInfoMapper#selectById ⇒ 表 openapi_bjc_card_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcCardInfo/getOpenapiBjcCardInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/getOpenapiBjcCardInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/getOpenapiBjcCardInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_card_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcCardInfoResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_card_info`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcCardInfo/getOpenapiBjcCardInfo

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcCardInfoService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcCardInfo/queryOpenapiBjcCardInfoList 未使用管理后台 #

北京卡信息表-列表查询 · OpenapiBjcCardInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcCardInfoController#queryOpenapiBjcCardInfoList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_card_info

ControllerOpenapiBjcCardInfoController#queryOpenapiBjcCardInfoList

转换BeanUtils.map → OpenapiBjcCardInfoQuery

ServiceOpenapiBjcCardInfoService#queryList （OpenapiBjcCardInfoServiceImpl）

MapperOpenapiBjcCardInfoMapper#selectList ⇒ 表 openapi_bjc_card_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcCardInfo/queryOpenapiBjcCardInfoList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/queryOpenapiBjcCardInfoList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/queryOpenapiBjcCardInfoList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcCardInfoListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcCardInfoResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_card_info`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcCardInfo/queryOpenapiBjcCardInfoList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcCardInfoService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcCardInfo/queryOpenapiBjcCardInfoPage 未使用管理后台 #

北京卡信息表-分页查询 · OpenapiBjcCardInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcCardInfoController#queryOpenapiBjcCardInfoPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_card_info

ControllerOpenapiBjcCardInfoController#queryOpenapiBjcCardInfoPage

转换BeanUtils.map → OpenapiBjcCardInfoQuery

ServiceOpenapiBjcCardInfoService#queryPage （OpenapiBjcCardInfoServiceImpl）

MapperOpenapiBjcCardInfoMapper#selectPage ⇒ 表 openapi_bjc_card_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcCardInfo/queryOpenapiBjcCardInfoPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/queryOpenapiBjcCardInfoPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/queryOpenapiBjcCardInfoPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcCardInfoPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcCardInfoResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_card_info`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcCardInfo/queryOpenapiBjcCardInfoPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcCardInfoService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcCardInfo/updateOpenapiBjcCardInfo 未使用管理后台 #

北京卡信息表-更新 · OpenapiBjcCardInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcCardInfoController#updateOpenapiBjcCardInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_card_info

ControllerOpenapiBjcCardInfoController#updateOpenapiBjcCardInfo

转换BeanUtils.map → OpenapiBjcCardInfo ⇒ 表 openapi_bjc_card_info

ServiceOpenapiBjcCardInfoService#update （OpenapiBjcCardInfoServiceImpl）

MapperOpenapiBjcCardInfoMapper#updateById ⇒ 表 openapi_bjc_card_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcCardInfo/updateOpenapiBjcCardInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/updateOpenapiBjcCardInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcCardInfo/updateOpenapiBjcCardInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcCardInfoUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_card_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcCardInfo/updateOpenapiBjcCardInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcCardInfoService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcConsumeRecordController 0/6 在用

POST /openapiBjcConsumeRecord/addOpenapiBjcConsumeRecord 未使用管理后台 #

北京卡核销记录表-新增 · OpenapiBjcConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcConsumeRecordController#addOpenapiBjcConsumeRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_consume_record

ControllerOpenapiBjcConsumeRecordController#addOpenapiBjcConsumeRecord

转换BeanUtils.map → OpenapiBjcConsumeRecord ⇒ 表 openapi_bjc_consume_record

ServiceOpenapiBjcConsumeRecordService#add （OpenapiBjcConsumeRecordServiceImpl）

MapperOpenapiBjcConsumeRecordMapper#insert ⇒ 表 openapi_bjc_consume_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcConsumeRecord/addOpenapiBjcConsumeRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/addOpenapiBjcConsumeRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/addOpenapiBjcConsumeRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcConsumeRecordAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcConsumeRecord/addOpenapiBjcConsumeRecord

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcConsumeRecordService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcConsumeRecord/deleteOpenapiBjcConsumeRecord 未使用管理后台 #

北京卡核销记录表-删除 · OpenapiBjcConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcConsumeRecordController#deleteOpenapiBjcConsumeRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_consume_record

ControllerOpenapiBjcConsumeRecordController#deleteOpenapiBjcConsumeRecord

ServiceOpenapiBjcConsumeRecordService#delete （OpenapiBjcConsumeRecordServiceImpl）

MapperOpenapiBjcConsumeRecordMapper#deleteById ⇒ 表 openapi_bjc_consume_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcConsumeRecord/deleteOpenapiBjcConsumeRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/deleteOpenapiBjcConsumeRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/deleteOpenapiBjcConsumeRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_consume_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcConsumeRecord/deleteOpenapiBjcConsumeRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcConsumeRecordService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcConsumeRecord/getOpenapiBjcConsumeRecord 未使用管理后台 #

北京卡核销记录表-详情 · OpenapiBjcConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcConsumeRecordController#getOpenapiBjcConsumeRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_consume_record

ControllerOpenapiBjcConsumeRecordController#getOpenapiBjcConsumeRecord

ServiceOpenapiBjcConsumeRecordService#get （OpenapiBjcConsumeRecordServiceImpl）

MapperOpenapiBjcConsumeRecordMapper#selectById ⇒ 表 openapi_bjc_consume_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcConsumeRecord/getOpenapiBjcConsumeRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/getOpenapiBjcConsumeRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/getOpenapiBjcConsumeRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_consume_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcConsumeRecordResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_consume_record`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcConsumeRecord/getOpenapiBjcConsumeRecord

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcConsumeRecordService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordList 未使用管理后台 #

北京卡核销记录表-列表查询 · OpenapiBjcConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcConsumeRecordController#queryOpenapiBjcConsumeRecordList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_consume_record

ControllerOpenapiBjcConsumeRecordController#queryOpenapiBjcConsumeRecordList

转换BeanUtils.map → OpenapiBjcConsumeRecordQuery

ServiceOpenapiBjcConsumeRecordService#queryList （OpenapiBjcConsumeRecordServiceImpl）

MapperOpenapiBjcConsumeRecordMapper#selectList ⇒ 表 openapi_bjc_consume_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcConsumeRecordListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcConsumeRecordResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_consume_record`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcConsumeRecordService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordPage 未使用管理后台 #

北京卡核销记录表-分页查询 · OpenapiBjcConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcConsumeRecordController#queryOpenapiBjcConsumeRecordPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_consume_record

ControllerOpenapiBjcConsumeRecordController#queryOpenapiBjcConsumeRecordPage

转换BeanUtils.map → OpenapiBjcConsumeRecordQuery

ServiceOpenapiBjcConsumeRecordService#queryPage （OpenapiBjcConsumeRecordServiceImpl）

MapperOpenapiBjcConsumeRecordMapper#selectPage ⇒ 表 openapi_bjc_consume_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcConsumeRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcConsumeRecordResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_consume_record`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcConsumeRecord/queryOpenapiBjcConsumeRecordPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcConsumeRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcConsumeRecord/updateOpenapiBjcConsumeRecord 未使用管理后台 #

北京卡核销记录表-更新 · OpenapiBjcConsumeRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcConsumeRecordController#updateOpenapiBjcConsumeRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_consume_record

ControllerOpenapiBjcConsumeRecordController#updateOpenapiBjcConsumeRecord

转换BeanUtils.map → OpenapiBjcConsumeRecord ⇒ 表 openapi_bjc_consume_record

ServiceOpenapiBjcConsumeRecordService#update （OpenapiBjcConsumeRecordServiceImpl）

MapperOpenapiBjcConsumeRecordMapper#updateById ⇒ 表 openapi_bjc_consume_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcConsumeRecord/updateOpenapiBjcConsumeRecord
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/updateOpenapiBjcConsumeRecord
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcConsumeRecord/updateOpenapiBjcConsumeRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcConsumeRecordUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_consume_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcConsumeRecord/updateOpenapiBjcConsumeRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcConsumeRecordService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcLogController 0/6 在用

POST /openapiBjcLog/addOpenapiBjcLog 未使用管理后台 #

北京接口调用记录表-新增 · OpenapiBjcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcLogController#addOpenapiBjcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_log

ControllerOpenapiBjcLogController#addOpenapiBjcLog

转换BeanUtils.map → OpenapiBjcLog ⇒ 表 openapi_bjc_log

ServiceOpenapiBjcLogService#add （OpenapiBjcLogServiceImpl）

MapperOpenapiBjcLogMapper#insert ⇒ 表 openapi_bjc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcLog/addOpenapiBjcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/addOpenapiBjcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/addOpenapiBjcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcLog/addOpenapiBjcLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcLog/deleteOpenapiBjcLog 未使用管理后台 #

北京接口调用记录表-删除 · OpenapiBjcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcLogController#deleteOpenapiBjcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_log

ControllerOpenapiBjcLogController#deleteOpenapiBjcLog

ServiceOpenapiBjcLogService#delete （OpenapiBjcLogServiceImpl）

MapperOpenapiBjcLogMapper#deleteById ⇒ 表 openapi_bjc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcLog/deleteOpenapiBjcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/deleteOpenapiBjcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/deleteOpenapiBjcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcLog/deleteOpenapiBjcLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcLog/getOpenapiBjcLog 未使用管理后台 #

北京接口调用记录表-详情 · OpenapiBjcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcLogController#getOpenapiBjcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_log

ControllerOpenapiBjcLogController#getOpenapiBjcLog

ServiceOpenapiBjcLogService#get （OpenapiBjcLogServiceImpl）

MapperOpenapiBjcLogMapper#selectById ⇒ 表 openapi_bjc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcLog/getOpenapiBjcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/getOpenapiBjcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/getOpenapiBjcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcLogResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcLog/getOpenapiBjcLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcLog/queryOpenapiBjcLogList 未使用管理后台 #

北京接口调用记录表-列表查询 · OpenapiBjcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcLogController#queryOpenapiBjcLogList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_log

ControllerOpenapiBjcLogController#queryOpenapiBjcLogList

转换BeanUtils.map → OpenapiBjcLogQuery

ServiceOpenapiBjcLogService#queryList （OpenapiBjcLogServiceImpl）

MapperOpenapiBjcLogMapper#selectList ⇒ 表 openapi_bjc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcLog/queryOpenapiBjcLogList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/queryOpenapiBjcLogList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/queryOpenapiBjcLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcLogResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcLog/queryOpenapiBjcLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcLog/queryOpenapiBjcLogPage 未使用管理后台 #

北京接口调用记录表-分页查询 · OpenapiBjcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcLogController#queryOpenapiBjcLogPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_log

ControllerOpenapiBjcLogController#queryOpenapiBjcLogPage

转换BeanUtils.map → OpenapiBjcLogQuery

ServiceOpenapiBjcLogService#queryPage （OpenapiBjcLogServiceImpl）

MapperOpenapiBjcLogMapper#selectPage ⇒ 表 openapi_bjc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcLog/queryOpenapiBjcLogPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/queryOpenapiBjcLogPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/queryOpenapiBjcLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcLog/queryOpenapiBjcLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcLog/updateOpenapiBjcLog 未使用管理后台 #

北京接口调用记录表-更新 · OpenapiBjcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcLogController#updateOpenapiBjcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_log

ControllerOpenapiBjcLogController#updateOpenapiBjcLog

转换BeanUtils.map → OpenapiBjcLog ⇒ 表 openapi_bjc_log

ServiceOpenapiBjcLogService#update （OpenapiBjcLogServiceImpl）

MapperOpenapiBjcLogMapper#updateById ⇒ 表 openapi_bjc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcLog/updateOpenapiBjcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/updateOpenapiBjcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcLog/updateOpenapiBjcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcLog/updateOpenapiBjcLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiBjcTokenController 0/6 在用

POST /openapiBjcToken/addOpenapiBjcToken 未使用管理后台 #

北京接口token记录表-新增 · OpenapiBjcTokenController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcTokenController#addOpenapiBjcToken
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_token

ControllerOpenapiBjcTokenController#addOpenapiBjcToken

转换BeanUtils.map → OpenapiBjcToken ⇒ 表 openapi_bjc_token

ServiceOpenapiBjcTokenService#add （OpenapiBjcTokenServiceImpl）

MapperOpenapiBjcTokenMapper#insert ⇒ 表 openapi_bjc_token

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcToken/addOpenapiBjcToken
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/addOpenapiBjcToken
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/addOpenapiBjcToken	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcTokenAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcToken/addOpenapiBjcToken

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiBjcTokenService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcToken/deleteOpenapiBjcToken 未使用管理后台 #

北京接口token记录表-删除 · OpenapiBjcTokenController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcTokenController#deleteOpenapiBjcToken
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_token

ControllerOpenapiBjcTokenController#deleteOpenapiBjcToken

ServiceOpenapiBjcTokenService#delete （OpenapiBjcTokenServiceImpl）

MapperOpenapiBjcTokenMapper#deleteById ⇒ 表 openapi_bjc_token

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcToken/deleteOpenapiBjcToken
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/deleteOpenapiBjcToken
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/deleteOpenapiBjcToken	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_token`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcToken/deleteOpenapiBjcToken

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiBjcTokenService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcToken/getOpenapiBjcToken 未使用管理后台 #

北京接口token记录表-详情 · OpenapiBjcTokenController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcTokenController#getOpenapiBjcToken
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_token

ControllerOpenapiBjcTokenController#getOpenapiBjcToken

ServiceOpenapiBjcTokenService#get （OpenapiBjcTokenServiceImpl）

MapperOpenapiBjcTokenMapper#selectById ⇒ 表 openapi_bjc_token

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcToken/getOpenapiBjcToken
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/getOpenapiBjcToken
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/getOpenapiBjcToken	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_bjc_token`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiBjcTokenResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_token`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcToken/getOpenapiBjcToken

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiBjcTokenService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcToken/queryOpenapiBjcTokenList 未使用管理后台 #

北京接口token记录表-列表查询 · OpenapiBjcTokenController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcTokenController#queryOpenapiBjcTokenList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_token

ControllerOpenapiBjcTokenController#queryOpenapiBjcTokenList

转换BeanUtils.map → OpenapiBjcTokenQuery

ServiceOpenapiBjcTokenService#queryList （OpenapiBjcTokenServiceImpl）

MapperOpenapiBjcTokenMapper#selectList ⇒ 表 openapi_bjc_token

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcToken/queryOpenapiBjcTokenList
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/queryOpenapiBjcTokenList
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/queryOpenapiBjcTokenList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcTokenListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiBjcTokenResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_bjc_token`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcToken/queryOpenapiBjcTokenList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiBjcTokenService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcToken/queryOpenapiBjcTokenPage 未使用管理后台 #

北京接口token记录表-分页查询 · OpenapiBjcTokenController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcTokenController#queryOpenapiBjcTokenPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_token

ControllerOpenapiBjcTokenController#queryOpenapiBjcTokenPage

转换BeanUtils.map → OpenapiBjcTokenQuery

ServiceOpenapiBjcTokenService#queryPage （OpenapiBjcTokenServiceImpl）

MapperOpenapiBjcTokenMapper#selectPage ⇒ 表 openapi_bjc_token

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcToken/queryOpenapiBjcTokenPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/queryOpenapiBjcTokenPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/queryOpenapiBjcTokenPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcTokenPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiBjcTokenResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_bjc_token`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcToken/queryOpenapiBjcTokenPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiBjcTokenService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiBjcToken/updateOpenapiBjcToken 未使用管理后台 #

北京接口token记录表-更新 · OpenapiBjcTokenController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiBjcTokenController#updateOpenapiBjcToken
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_bjc_token

ControllerOpenapiBjcTokenController#updateOpenapiBjcToken

转换BeanUtils.map → OpenapiBjcToken ⇒ 表 openapi_bjc_token

ServiceOpenapiBjcTokenService#update （OpenapiBjcTokenServiceImpl）

MapperOpenapiBjcTokenMapper#updateById ⇒ 表 openapi_bjc_token

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiBjcToken/updateOpenapiBjcToken
uat	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/updateOpenapiBjcToken
pro	https://dscp-uat.hn12301.net/manage-api/openapiBjcToken/updateOpenapiBjcToken	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiBjcTokenUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_bjc_token`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiBjcToken/updateOpenapiBjcToken

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiBjcTokenService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiCardConfigController 0/6 在用

POST /openapi/addOpenapiCardConfig 未使用管理后台 #

旅游卡配置表-新增 · OpenapiCardConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCardConfigController#addOpenapiCardConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_card_config

ControllerOpenapiCardConfigController#addOpenapiCardConfig

转换BeanUtils.map → OpenapiCardConfig ⇒ 表 openapi_card_config

ServiceOpenapiCardConfigService#add （OpenapiCardConfigServiceImpl）

MapperOpenapiCardConfigMapper#insert ⇒ 表 openapi_card_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiCardConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiCardConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiCardConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCardConfigAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiCardConfig

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiCardConfigService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiCardConfig 未使用管理后台 #

旅游卡配置表-删除 · OpenapiCardConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCardConfigController#deleteOpenapiCardConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_card_config

ControllerOpenapiCardConfigController#deleteOpenapiCardConfig

ServiceOpenapiCardConfigService#delete （OpenapiCardConfigServiceImpl）

MapperOpenapiCardConfigMapper#deleteById ⇒ 表 openapi_card_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiCardConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiCardConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiCardConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_card_config`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiCardConfig

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiCardConfigService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiCardConfig 未使用管理后台 #

旅游卡配置表-详情 · OpenapiCardConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCardConfigController#getOpenapiCardConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_card_config

ControllerOpenapiCardConfigController#getOpenapiCardConfig

ServiceOpenapiCardConfigService#get （OpenapiCardConfigServiceImpl）

MapperOpenapiCardConfigMapper#selectById ⇒ 表 openapi_card_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiCardConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiCardConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiCardConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_card_config`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiCardConfigResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_card_config`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiCardConfig

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiCardConfigService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiCardConfigList 未使用管理后台 #

旅游卡配置表-列表查询 · OpenapiCardConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCardConfigController#queryOpenapiCardConfigList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_card_config

ControllerOpenapiCardConfigController#queryOpenapiCardConfigList

转换BeanUtils.map → OpenapiCardConfigQuery

ServiceOpenapiCardConfigService#queryList （OpenapiCardConfigServiceImpl）

MapperOpenapiCardConfigMapper#selectList ⇒ 表 openapi_card_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiCardConfigList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiCardConfigList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiCardConfigList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCardConfigListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiCardConfigResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_card_config`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiCardConfigList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiCardConfigService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiCardConfigPage 未使用管理后台 #

旅游卡配置表-分页查询 · OpenapiCardConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCardConfigController#queryOpenapiCardConfigPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_card_config

ControllerOpenapiCardConfigController#queryOpenapiCardConfigPage

转换BeanUtils.map → OpenapiCardConfigQuery

ServiceOpenapiCardConfigService#queryPage （OpenapiCardConfigServiceImpl）

MapperOpenapiCardConfigMapper#selectPage ⇒ 表 openapi_card_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiCardConfigPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiCardConfigPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiCardConfigPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCardConfigPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiCardConfigResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_card_config`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiCardConfigPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiCardConfigService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiCardConfig 未使用管理后台 #

旅游卡配置表-更新 · OpenapiCardConfigController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCardConfigController#updateOpenapiCardConfig
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_card_config

ControllerOpenapiCardConfigController#updateOpenapiCardConfig

转换BeanUtils.map → OpenapiCardConfig ⇒ 表 openapi_card_config

ServiceOpenapiCardConfigService#update （OpenapiCardConfigServiceImpl）

MapperOpenapiCardConfigMapper#updateById ⇒ 表 openapi_card_config

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiCardConfig
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiCardConfig
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiCardConfig	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCardConfigUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_card_config`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiCardConfig

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiCardConfigService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiChannelBusinessController 0/6 在用

POST /openapi/addOpenapiChannelBusiness 未使用管理后台 #

第三方卡业务信息表-新增 · OpenapiChannelBusinessController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelBusinessController#addOpenapiChannelBusiness
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerOpenapiChannelBusinessController#addOpenapiChannelBusiness

转换BeanUtils.map → OpenapiChannelBusiness ⇒ 表 openapi_channel_business

ServiceOpenapiChannelBusinessService#add （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#insert ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiChannelBusiness
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelBusiness
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelBusiness	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelBusinessAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiChannelBusiness

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiChannelBusinessService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiChannelBusiness 未使用管理后台 #

第三方卡业务信息表-删除 · OpenapiChannelBusinessController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelBusinessController#deleteOpenapiChannelBusiness
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerOpenapiChannelBusinessController#deleteOpenapiChannelBusiness

ServiceOpenapiChannelBusinessService#delete （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#deleteById ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiChannelBusiness
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelBusiness
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelBusiness	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_business`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiChannelBusiness

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiChannelBusinessService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiChannelBusiness 未使用管理后台 #

第三方卡业务信息表-详情 · OpenapiChannelBusinessController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelBusinessController#getOpenapiChannelBusiness
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerOpenapiChannelBusinessController#getOpenapiChannelBusiness

ServiceOpenapiChannelBusinessService#get （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectById ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiChannelBusiness
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelBusiness
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelBusiness	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_business`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiChannelBusinessResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_business`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiChannelBusiness

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelBusinessService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelBusinessList 未使用管理后台 #

第三方卡业务信息表-列表查询 · OpenapiChannelBusinessController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelBusinessController#queryOpenapiChannelBusinessList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerOpenapiChannelBusinessController#queryOpenapiChannelBusinessList

转换BeanUtils.map → OpenapiChannelBusinessQuery

ServiceOpenapiChannelBusinessService#queryList （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectList ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelBusinessList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelBusinessList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelBusinessList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelBusinessListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelBusinessResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_channel_business`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelBusinessList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelBusinessService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelBusinessPage 未使用管理后台 #

第三方卡业务信息表-分页查询 · OpenapiChannelBusinessController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelBusinessController#queryOpenapiChannelBusinessPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerOpenapiChannelBusinessController#queryOpenapiChannelBusinessPage

转换BeanUtils.map → OpenapiChannelBusinessQuery

ServiceOpenapiChannelBusinessService#queryPage （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#selectPage ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelBusinessPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelBusinessPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelBusinessPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelBusinessPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelBusinessResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_channel_business`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelBusinessPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiChannelBusinessService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiChannelBusiness 未使用管理后台 #

第三方卡业务信息表-更新 · OpenapiChannelBusinessController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelBusinessController#updateOpenapiChannelBusiness
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_business

ControllerOpenapiChannelBusinessController#updateOpenapiChannelBusiness

转换BeanUtils.map → OpenapiChannelBusiness ⇒ 表 openapi_channel_business

ServiceOpenapiChannelBusinessService#update （OpenapiChannelBusinessServiceImpl）

MapperOpenapiChannelBusinessMapper#updateById ⇒ 表 openapi_channel_business

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiChannelBusiness
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelBusiness
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelBusiness	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelBusinessUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_business`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiChannelBusiness

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiChannelBusinessService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiChannelCardController 0/6 在用

POST /openapi/addOpenapiChannelCard 未使用管理后台 #

渠道发卡信息-新增 · OpenapiChannelCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelCardController#addOpenapiChannelCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_card

ControllerOpenapiChannelCardController#addOpenapiChannelCard

转换BeanUtils.map → OpenapiChannelCard ⇒ 表 openapi_channel_card

ServiceOpenapiChannelCardService#add （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#insert ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiChannelCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelCardAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiChannelCard

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiChannelCardService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiChannelCard 未使用管理后台 #

渠道发卡信息-删除 · OpenapiChannelCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelCardController#deleteOpenapiChannelCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_card

ControllerOpenapiChannelCardController#deleteOpenapiChannelCard

ServiceOpenapiChannelCardService#delete （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#deleteById ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiChannelCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiChannelCard

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiChannelCardService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiChannelCard 未使用管理后台 #

渠道发卡信息-详情 · OpenapiChannelCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelCardController#getOpenapiChannelCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_card

ControllerOpenapiChannelCardController#getOpenapiChannelCard

ServiceOpenapiChannelCardService#get （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#selectById ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiChannelCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiChannelCardResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_card`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiChannelCard

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelCardService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelCardList 未使用管理后台 #

渠道发卡信息-列表查询 · OpenapiChannelCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelCardController#queryOpenapiChannelCardList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_card

ControllerOpenapiChannelCardController#queryOpenapiChannelCardList

转换BeanUtils.map → OpenapiChannelCardQuery

ServiceOpenapiChannelCardService#queryList （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#selectList ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelCardList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelCardList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelCardList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelCardListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelCardResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_channel_card`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelCardList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelCardService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelCardPage 未使用管理后台 #

渠道发卡信息-分页查询 · OpenapiChannelCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelCardController#queryOpenapiChannelCardPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_card

ControllerOpenapiChannelCardController#queryOpenapiChannelCardPage

转换BeanUtils.map → OpenapiChannelCardQuery

ServiceOpenapiChannelCardService#queryPage （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#selectPage ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelCardPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelCardPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelCardPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelCardResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_channel_card`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiChannelCardService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiChannelCard 未使用管理后台 #

渠道发卡信息-更新 · OpenapiChannelCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelCardController#updateOpenapiChannelCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_card

ControllerOpenapiChannelCardController#updateOpenapiChannelCard

转换BeanUtils.map → OpenapiChannelCard ⇒ 表 openapi_channel_card

ServiceOpenapiChannelCardService#update （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#updateById ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiChannelCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelCardUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiChannelCard

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiChannelCardService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiChannelInfoController 6/6 在用

POST /openapi/addOpenapiChannelInfo 在用管理后台 #

发卡渠道方信息-新增 · OpenapiChannelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelInfoController#addOpenapiChannelInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerOpenapiChannelInfoController#addOpenapiChannelInfo

转换BeanUtils.map → OpenapiChannelInfo ⇒ 表 openapi_channel_info

ServiceOpenapiChannelInfoService#add （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#insert ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiChannelInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelInfoAddRequest

字段	类型	表 / 列	说明
channelName	String	`openapi_channel_info`.`channel_name`
appName	String	`openapi_channel_info`.`app_name`	名称
appKey	String	`openapi_channel_info`.`app_key`	appkey
appSecret	String	`openapi_channel_info`.`app_secret`	appSecret
cardNumLimit	Integer	`openapi_channel_info`.`card_num_limit`	发卡数量限制
status	Integer	`openapi_channel_info`.`status`	状态 0=禁用 1=正常

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiChannelInfo

{
  "body": {
    "channelName": "",
    "appName": "",
    "appKey": "",
    "appSecret": "",
    "cardNumLimit": 0,
    "status": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiChannelInfoService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage addOpenapiChannelInfo exact

POST /openapi/deleteOpenapiChannelInfo 在用管理后台 #

发卡渠道方信息-删除 · OpenapiChannelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelInfoController#deleteOpenapiChannelInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerOpenapiChannelInfoController#deleteOpenapiChannelInfo

ServiceOpenapiChannelInfoService#delete （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#deleteById ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiChannelInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiChannelInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiChannelInfoService.delete）

前端调用方

dscp-html-manage deleteOpenapiChannelInfo exact

POST /openapi/getOpenapiChannelInfo 在用管理后台 #

发卡渠道方信息-详情 · OpenapiChannelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelInfoController#getOpenapiChannelInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerOpenapiChannelInfoController#getOpenapiChannelInfo

ServiceOpenapiChannelInfoService#get （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#selectById ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiChannelInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiChannelInfoResponse　（object）

字段	类型	表 / 列	说明
id	Long	`openapi_channel_info`.`id`	id
channelName	String	`openapi_channel_info`.`channel_name`	平台名称
appName	String	`openapi_channel_info`.`app_name`	名称
appKey	String	`openapi_channel_info`.`app_key`	appkey
appSecret	String	`openapi_channel_info`.`app_secret`	appSecret
cardNumLimit	Integer	`openapi_channel_info`.`card_num_limit`	发卡数量限制
status	Integer	`openapi_channel_info`.`status`	状态 0=禁用 1=正常
addDate	Date	`openapi_channel_info`.`add_date`	添加时间

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiChannelInfo

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "channelName": "",
    "appName": "",
    "appKey": "",
    "appSecret": "",
    "cardNumLimit": 0,
    "status": 0,
    "addDate": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelInfoService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getOpenapiChannelInfo exact

POST /openapi/queryOpenapiChannelInfoList 在用管理后台 #

发卡渠道方信息-列表查询 · OpenapiChannelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelInfoController#queryOpenapiChannelInfoList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerOpenapiChannelInfoController#queryOpenapiChannelInfoList

转换BeanUtils.map → OpenapiChannelInfoQuery

ServiceOpenapiChannelInfoService#queryList （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#selectList ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelInfoList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelInfoList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelInfoList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelInfoListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelInfoResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`openapi_channel_info`.`id`	id
channelName	String	`openapi_channel_info`.`channel_name`	平台名称
appName	String	`openapi_channel_info`.`app_name`	名称
appKey	String	`openapi_channel_info`.`app_key`	appkey
appSecret	String	`openapi_channel_info`.`app_secret`	appSecret
cardNumLimit	Integer	`openapi_channel_info`.`card_num_limit`	发卡数量限制
status	Integer	`openapi_channel_info`.`status`	状态 0=禁用 1=正常
addDate	Date	`openapi_channel_info`.`add_date`	添加时间

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelInfoList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "channelName": "",
      "appName": "",
      "appKey": "",
      "appSecret": "",
      "cardNumLimit": 0,
      "status": 0,
      "addDate": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelInfoService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryChannelInfoList exact

POST /openapi/queryOpenapiChannelInfoPage 在用管理后台 #

发卡渠道方信息-分页查询 · OpenapiChannelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelInfoController#queryOpenapiChannelInfoPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerOpenapiChannelInfoController#queryOpenapiChannelInfoPage

转换BeanUtils.map → OpenapiChannelInfoQuery

ServiceOpenapiChannelInfoService#queryPage （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#selectPage ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelInfoPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelInfoPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelInfoPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelInfoPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
channelName	String	否	可选(@MvcOptional)	`openapi_channel_info`.`channel_name`
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelInfoResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_channel_info`.`id`	id
channelName	String	`openapi_channel_info`.`channel_name`	平台名称
appName	String	`openapi_channel_info`.`app_name`	名称
appKey	String	`openapi_channel_info`.`app_key`	appkey
appSecret	String	`openapi_channel_info`.`app_secret`	appSecret
cardNumLimit	Integer	`openapi_channel_info`.`card_num_limit`	发卡数量限制
status	Integer	`openapi_channel_info`.`status`	状态 0=禁用 1=正常
addDate	Date	`openapi_channel_info`.`add_date`	添加时间

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelInfoPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "channelName": "",
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "channelName": "",
        "appName": "",
        "appKey": "",
        "appSecret": "",
        "cardNumLimit": 0,
        "status": 0,
        "addDate": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiChannelInfoService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryOpenapiChannelInfoPage exact

POST /openapi/updateOpenapiChannelInfo 在用管理后台 #

发卡渠道方信息-更新 · OpenapiChannelInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelInfoController#updateOpenapiChannelInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_info

ControllerOpenapiChannelInfoController#updateOpenapiChannelInfo

转换BeanUtils.map → OpenapiChannelInfo ⇒ 表 openapi_channel_info

ServiceOpenapiChannelInfoService#update （OpenapiChannelInfoServiceImpl）

MapperOpenapiChannelInfoMapper#updateById ⇒ 表 openapi_channel_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiChannelInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelInfoUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiChannelInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiChannelInfoService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateOpenapiChannelInfo exact

OpenapiChannelOperatorController 5/6 在用

POST /openapi/addOpenapiChannelOperator 在用管理后台 #

渠道业务员表-新增 · OpenapiChannelOperatorController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOperatorController#addOpenapiChannelOperator
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表system_usersystem_rolesystem_user_rolesystem_user_relationopenapi_channel_operator

ControllerOpenapiChannelOperatorController#addOpenapiChannelOperator

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceUserService#add （UserServiceImpl）

MapperUserMapper#insert ⇒ 表 system_user

ServiceRoleService#get （RoleServiceImpl）

MapperRoleMapper#selectById ⇒ 表 system_role

ServiceUserRoleService#add （UserRoleServiceImpl）

MapperUserRoleMapper#insert ⇒ 表 system_user_role

ServiceUserRelationService#add （UserRelationServiceImpl）

MapperUserRelationMapper#insert ⇒ 表 system_user_relation

ServiceOpenapiChannelOperatorService#add （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#insert ⇒ 表 openapi_channel_operator

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

ChaosTransactionTemplate.executePasswordEncoder.encode

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiChannelOperator
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelOperator
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelOperator	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOperatorAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
operatorName	String	是	必填	`openapi_channel_operator`.`operator_name`	业务员姓名
channelInfoId	Long			`openapi_channel_operator`.`channel_info_id`
mobile	String	是	必填	`system_user`.`mobile`	手机号
merchantId	Long	是	必填	`system_role`.`merchant_id`	所属商户ID
shopId	Long	是	必填	`system_role`.`shop_id`	所属商铺ID
totalCardNum	Integer	是	必填	`openapi_channel_operator`.`total_card_num`	可激活卡总数量
dayCardNum	Integer	是	必填	`openapi_channel_operator`.`day_card_num`	每日可激活数量
status	Integer	是	必填	`openapi_channel_operator`.`status`	业务员状态：1-正常，0-禁用

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiChannelOperator

{
  "body": {
    "operatorName": "",
    "channelInfoId": 1,
    "mobile": "13800000000",
    "merchantId": 1,
    "shopId": 1,
    "totalCardNum": 0,
    "dayCardNum": 0,
    "status": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 execute（newTransactionTemplate.execute）；查询详情（userService.get）；新增（userService.add）

内联注释

1. 检查用户是否已存在
2. 创建用户
默认密码
3. 查询角色ID
4. 创建用户角色关系
5. 创建用户组织关系
6. 创建业务员信息
默认渠道ID，可根据需要调整

前端调用方

dscp-html-manage addOpenapiChannelOperator exact

POST /openapi/deleteOpenapiChannelOperator 在用管理后台 #

渠道业务员表-删除 · OpenapiChannelOperatorController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOperatorController#deleteOpenapiChannelOperator
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operator

ControllerOpenapiChannelOperatorController#deleteOpenapiChannelOperator

ServiceOpenapiChannelOperatorService#delete （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#deleteById ⇒ 表 openapi_channel_operator

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiChannelOperator
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelOperator
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelOperator	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_operator`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiChannelOperator

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiChannelOperatorService.delete）

前端调用方

dscp-html-manage deleteOpenapiChannelOperator exact

POST /openapi/getOpenapiChannelOperator 在用管理后台 #

渠道业务员表-详情 · OpenapiChannelOperatorController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOperatorController#getOpenapiChannelOperator
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operatorsystem_usersystem_user_relation

ControllerOpenapiChannelOperatorController#getOpenapiChannelOperator

转换BeanUtils.map → OpenapiChannelOperatorResponse

ServiceOpenapiChannelOperatorService#get （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectById ⇒ 表 openapi_channel_operator

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceUserRelationService#get （UserRelationServiceImpl）

MapperUserRelationMapper#selectById ⇒ 表 system_user_relation

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiChannelOperator
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelOperator
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelOperator	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_operator`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiChannelOperatorResponse　（object）

字段	类型	表 / 列	说明
id	Long	`openapi_channel_operator`.`id`	id
channelInfoId	Long	`openapi_channel_operator`.`channel_info_id`	业务渠道id
operatorId	Long	`openapi_channel_operator`.`operator_id`	业务员id
operatorName	String	`openapi_channel_operator`.`operator_name`	业务员姓名
mobile	String	`system_user`.`mobile`	业务员手机号
merchantId	Long	`openapi_channel_operator`.`merchant_id`	所属商户ID
shopId	Long	`openapi_channel_operator`.`shop_id`	所属商铺ID
totalCardNum	Integer	`openapi_channel_operator`.`total_card_num`	可激活卡总数量
dayCardNum	Integer	`openapi_channel_operator`.`day_card_num`	每日可激活数量
status	Integer	`openapi_channel_operator`.`status`	业务员状态
addDate	Date	`openapi_channel_operator`.`add_date`	添加时间

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiChannelOperator

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "channelInfoId": 1,
    "operatorId": 1,
    "operatorName": "",
    "mobile": "13800000000",
    "merchantId": 1,
    "shopId": 1,
    "totalCardNum": 0,
    "dayCardNum": 0,
    "status": 0,
    "addDate": "2026-01-01 12:00:00"
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelOperatorService.get）；查询详情（userService.get）；查询详情（userRelationService.get）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

获取业务员信息
根据operatorId查询用户信息
查询用户组织关系获取商户ID和商铺ID
转换响应对象并填充附加信息
设置手机号
设置商户和商铺信息

前端调用方

dscp-html-manage getOpenapiChannelOperator exact

POST /openapi/queryOpenapiChannelOperatorList 未使用管理后台 #

渠道业务员表-列表查询 · OpenapiChannelOperatorController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOperatorController#queryOpenapiChannelOperatorList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operator

ControllerOpenapiChannelOperatorController#queryOpenapiChannelOperatorList

转换BeanUtils.map → OpenapiChannelOperatorQuery

ServiceOpenapiChannelOperatorService#queryList （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectList ⇒ 表 openapi_channel_operator

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelOperatorList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOperatorList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOperatorList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOperatorListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelOperatorResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`openapi_channel_operator`.`id`	id
channelInfoId	Long	`openapi_channel_operator`.`channel_info_id`	业务渠道id
operatorId	Long	`openapi_channel_operator`.`operator_id`	业务员id
operatorName	String	`openapi_channel_operator`.`operator_name`	业务员姓名
mobile	String	—	业务员手机号
merchantId	Long	`openapi_channel_operator`.`merchant_id`	所属商户ID
shopId	Long	`openapi_channel_operator`.`shop_id`	所属商铺ID
totalCardNum	Integer	`openapi_channel_operator`.`total_card_num`	可激活卡总数量
dayCardNum	Integer	`openapi_channel_operator`.`day_card_num`	每日可激活数量
status	Integer	`openapi_channel_operator`.`status`	业务员状态
addDate	Date	`openapi_channel_operator`.`add_date`	添加时间

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelOperatorList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "channelInfoId": 1,
      "operatorId": 1,
      "operatorName": "",
      "mobile": "13800000000",
      "merchantId": 1,
      "shopId": 1,
      "totalCardNum": 0,
      "dayCardNum": 0,
      "status": 0,
      "addDate": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelOperatorService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelOperatorPage 在用管理后台 #

渠道业务员表-分页查询 · OpenapiChannelOperatorController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOperatorController#queryOpenapiChannelOperatorPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operator

ControllerOpenapiChannelOperatorController#queryOpenapiChannelOperatorPage

转换BeanUtils.map → OpenapiChannelOperatorQuery

ServiceOpenapiChannelOperatorService#queryPage （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectPage ⇒ 表 openapi_channel_operator

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelOperatorPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOperatorPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOperatorPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOperatorPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
operatorName	String	否	可选(@MvcOptional)	`openapi_channel_operator`.`operator_name`
channelInfoId	Long	否	可选(@MvcOptional)	`openapi_channel_operator`.`channel_info_id`
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelOperatorResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_channel_operator`.`id`	id
channelInfoId	Long	`openapi_channel_operator`.`channel_info_id`	业务渠道id
operatorId	Long	`openapi_channel_operator`.`operator_id`	业务员id
operatorName	String	`openapi_channel_operator`.`operator_name`	业务员姓名
mobile	String	—	业务员手机号
merchantId	Long	`openapi_channel_operator`.`merchant_id`	所属商户ID
shopId	Long	`openapi_channel_operator`.`shop_id`	所属商铺ID
totalCardNum	Integer	`openapi_channel_operator`.`total_card_num`	可激活卡总数量
dayCardNum	Integer	`openapi_channel_operator`.`day_card_num`	每日可激活数量
status	Integer	`openapi_channel_operator`.`status`	业务员状态
addDate	Date	`openapi_channel_operator`.`add_date`	添加时间

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelOperatorPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "operatorName": "",
    "channelInfoId": 1,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "channelInfoId": 1,
        "operatorId": 1,
        "operatorName": "",
        "mobile": "13800000000",
        "merchantId": 1,
        "shopId": 1,
        "totalCardNum": 0,
        "dayCardNum": 0,
        "status": 0,
        "addDate": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiChannelOperatorService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryOpenapiChannelOperatorPage exact

POST /openapi/updateOpenapiChannelOperator 在用管理后台 #

渠道业务员表-更新 · OpenapiChannelOperatorController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOperatorController#updateOpenapiChannelOperator
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operatorsystem_usersystem_user_relationsystem_user_role

ControllerOpenapiChannelOperatorController#updateOpenapiChannelOperator

ServiceOpenapiChannelOperatorService#get （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectById ⇒ 表 openapi_channel_operator

ServiceUserService#get （UserServiceImpl）

MapperUserMapper#selectById ⇒ 表 system_user

ServiceUserRelationService#get （UserRelationServiceImpl）

MapperUserRelationMapper#selectById ⇒ 表 system_user_relation

ServiceUserService#update （UserServiceImpl）

MapperUserMapper#updateById ⇒ 表 system_user

ServiceUserRelationService#update （UserRelationServiceImpl）

MapperUserRelationMapper#updateById ⇒ 表 system_user_relation

ServiceUserRoleService#queryList （UserRoleServiceImpl）

MapperUserRoleMapper#selectList ⇒ 表 system_user_role

ServiceUserRoleService#update （UserRoleServiceImpl）

MapperUserRoleMapper#updateById ⇒ 表 system_user_role

ServiceOpenapiChannelOperatorService#update （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#updateById ⇒ 表 openapi_channel_operator

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ChaosTransactionTemplate.execute

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiChannelOperator
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelOperator
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelOperator	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOperatorUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_operator`.`id`	id
channelInfoId	Long	是	必填	`openapi_channel_operator`.`channel_info_id`	业务渠道id
operatorId	Long			`openapi_channel_operator`.`operator_id`	业务员id
operatorName	String	是	必填	`openapi_channel_operator`.`operator_name`	业务员姓名
mobile	String	是	必填	`system_user`.`mobile`	手机号
merchantId	Long	是	必填	`openapi_channel_operator`.`merchant_id`	所属商户ID
shopId	Long	是	必填	`openapi_channel_operator`.`shop_id`	所属商铺ID
totalCardNum	Integer	是	必填	`openapi_channel_operator`.`total_card_num`	可激活卡总数量
dayCardNum	Integer	是	必填	`openapi_channel_operator`.`day_card_num`	每日可激活数量
status	Integer	是	必填	`openapi_channel_operator`.`status`	业务员状态：1-正常，0-禁用

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiChannelOperator

{
  "body": {
    "id": 1,
    "channelInfoId": 1,
    "operatorId": 1,
    "operatorName": "",
    "mobile": "13800000000",
    "merchantId": 1,
    "shopId": 1,
    "totalCardNum": 0,
    "dayCardNum": 0,
    "status": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 execute（newTransactionTemplate.execute）；查询详情（openapiChannelOperatorService.get）；查询详情（userService.get）

内联注释

1. 获取原业务员信息
2. 获取用户信息
3. 获取用户组织关系
4. 更新用户信息
5. 更新用户组织关系
同时更新用户角色关系中的商户ID和商铺ID
6. 更新业务员信息
回滚事务

前端调用方

dscp-html-manage updateOpenapiChannelOperator exact

OpenapiChannelOrderController 0/6 在用

POST /openapi/addOpenapiChannelOrder 未使用管理后台 #

渠道发卡订单表-新增 · OpenapiChannelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOrderController#addOpenapiChannelOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_order

ControllerOpenapiChannelOrderController#addOpenapiChannelOrder

转换BeanUtils.map → OpenapiChannelOrder ⇒ 表 openapi_channel_order

ServiceOpenapiChannelOrderService#add （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#insert ⇒ 表 openapi_channel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiChannelOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiChannelOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiChannelOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiChannelOrder 未使用管理后台 #

渠道发卡订单表-删除 · OpenapiChannelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOrderController#deleteOpenapiChannelOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_order

ControllerOpenapiChannelOrderController#deleteOpenapiChannelOrder

ServiceOpenapiChannelOrderService#delete （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#deleteById ⇒ 表 openapi_channel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiChannelOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiChannelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiChannelOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiChannelOrder 未使用管理后台 #

渠道发卡订单表-详情 · OpenapiChannelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOrderController#getOpenapiChannelOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_order

ControllerOpenapiChannelOrderController#getOpenapiChannelOrder

ServiceOpenapiChannelOrderService#get （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#selectById ⇒ 表 openapi_channel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiChannelOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiChannelOrderResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiChannelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelOrderService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelOrderList 未使用管理后台 #

渠道发卡订单表-列表查询 · OpenapiChannelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOrderController#queryOpenapiChannelOrderList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_order

ControllerOpenapiChannelOrderController#queryOpenapiChannelOrderList

转换BeanUtils.map → OpenapiChannelOrderQuery

ServiceOpenapiChannelOrderService#queryList （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#selectList ⇒ 表 openapi_channel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelOrderList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOrderList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_channel_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelOrderPage 未使用管理后台 #

渠道发卡订单表-分页查询 · OpenapiChannelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOrderController#queryOpenapiChannelOrderPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_order

ControllerOpenapiChannelOrderController#queryOpenapiChannelOrderPage

转换BeanUtils.map → OpenapiChannelOrderQuery

ServiceOpenapiChannelOrderService#queryPage （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#selectPage ⇒ 表 openapi_channel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelOrderResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_channel_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiChannelOrderService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiChannelOrder 未使用管理后台 #

渠道发卡订单表-更新 · OpenapiChannelOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelOrderController#updateOpenapiChannelOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_order

ControllerOpenapiChannelOrderController#updateOpenapiChannelOrder

转换BeanUtils.map → OpenapiChannelOrder ⇒ 表 openapi_channel_order

ServiceOpenapiChannelOrderService#update （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#updateById ⇒ 表 openapi_channel_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiChannelOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiChannelOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiChannelOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiChannelRuleController 5/6 在用

POST /openapi/addOpenapiChannelRule 在用管理后台 #

发卡渠道规则信息-新增 · OpenapiChannelRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelRuleController#addOpenapiChannelRule
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_operatorskugoodscard_modelopenapi_channel_rule

ControllerOpenapiChannelRuleController#addOpenapiChannelRule

ServiceOpenapiChannelOperatorService#get （OpenapiChannelOperatorServiceImpl）

MapperOpenapiChannelOperatorMapper#selectById ⇒ 表 openapi_channel_operator

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceOpenapiChannelRuleService#add （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#insert ⇒ 表 openapi_channel_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiChannelRule
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelRule
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiChannelRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelRuleAddRequest

字段	类型	必填	取值/校验	表 / 列
skuId	Long	是	必填	—
operatorId	Long	是	必填	`openapi_channel_operator`.`operator_id`
status	Integer	是	必填	`openapi_channel_operator`.`status`
price	Integer			`card_model`.`price`
memberPrice	Integer			`openapi_channel_rule`.`member_price`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiChannelRule

{
  "body": {
    "skuId": 1,
    "operatorId": 1,
    "status": 0,
    "price": 0,
    "memberPrice": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（openapiChannelOperatorService.get）；查询详情（skuService.get）；查询详情（goodsService.get）

前端调用方

dscp-html-manage addOpenapiChannelRule exact

POST /openapi/deleteOpenapiChannelRule 在用管理后台 #

发卡渠道规则信息-删除 · OpenapiChannelRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelRuleController#deleteOpenapiChannelRule
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_rule

ControllerOpenapiChannelRuleController#deleteOpenapiChannelRule

ServiceOpenapiChannelRuleService#delete （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#deleteById ⇒ 表 openapi_channel_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiChannelRule
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelRule
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiChannelRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_rule`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiChannelRule

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiChannelRuleService.delete）

前端调用方

dscp-html-manage deleteOpenapiChannelRule exact

POST /openapi/getOpenapiChannelRule 在用管理后台 #

发卡渠道规则信息-详情 · OpenapiChannelRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelRuleController#getOpenapiChannelRule
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_rule

ControllerOpenapiChannelRuleController#getOpenapiChannelRule

ServiceOpenapiChannelRuleService#get （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectById ⇒ 表 openapi_channel_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiChannelRule
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelRule
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiChannelRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_channel_rule`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiChannelRuleResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`openapi_channel_rule`.`id`	id
channelId	Long		`openapi_channel_rule`.`channel_id`
cardName	String		`openapi_channel_rule`.`card_name`	卡名称
channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_rule`.`channel`	卡种平台
typeId	String		`openapi_channel_rule`.`type_id`	卡种id
cardNumLimit	Integer		`openapi_channel_rule`.`card_num_limit`	发卡数量限制
cardNumRemain	Integer		`openapi_channel_rule`.`card_num_remain`	剩余可发卡数量
status	Integer		`openapi_channel_rule`.`status`	状态 0=禁用 1=正常
addDate	Date		`openapi_channel_rule`.`add_date`	添加时间
operatorId	Long		`openapi_channel_rule`.`operator_id`	渠道id
cardModelId	Long		`openapi_channel_rule`.`card_model_id`	卡种id
goodsId	Long		`openapi_channel_rule`.`goods_id`	商品id
price	Integer		`openapi_channel_rule`.`price`
memberPrice	Integer		`openapi_channel_rule`.`member_price`

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiChannelRule

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "channelId": 1,
    "cardName": "",
    "channel": "1",
    "typeId": "",
    "cardNumLimit": 0,
    "cardNumRemain": 0,
    "status": 0,
    "addDate": "2026-01-01 12:00:00",
    "operatorId": 1,
    "cardModelId": 1,
    "goodsId": 1,
    "price": 0,
    "memberPrice": 0
  }
}

处理逻辑

逻辑摘要查询详情（openapiChannelRuleService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage getOpenapiChannelRule exact

POST /openapi/queryOpenapiChannelRuleList 未使用管理后台 #

发卡渠道规则信息-列表查询 · OpenapiChannelRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelRuleController#queryOpenapiChannelRuleList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_rule

ControllerOpenapiChannelRuleController#queryOpenapiChannelRuleList

转换BeanUtils.map → OpenapiChannelRuleQuery

ServiceOpenapiChannelRuleService#queryList （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectList ⇒ 表 openapi_channel_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelRuleList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelRuleList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelRuleList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelRuleListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiChannelRuleResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`openapi_channel_rule`.`id`	id
channelId	Long		`openapi_channel_rule`.`channel_id`
cardName	String		`openapi_channel_rule`.`card_name`	卡名称
channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_rule`.`channel`	卡种平台
typeId	String		`openapi_channel_rule`.`type_id`	卡种id
cardNumLimit	Integer		`openapi_channel_rule`.`card_num_limit`	发卡数量限制
cardNumRemain	Integer		`openapi_channel_rule`.`card_num_remain`	剩余可发卡数量
status	Integer		`openapi_channel_rule`.`status`	状态 0=禁用 1=正常
addDate	Date		`openapi_channel_rule`.`add_date`	添加时间
operatorId	Long		`openapi_channel_rule`.`operator_id`	渠道id
cardModelId	Long		`openapi_channel_rule`.`card_model_id`	卡种id
goodsId	Long		`openapi_channel_rule`.`goods_id`	商品id
price	Integer		`openapi_channel_rule`.`price`
memberPrice	Integer		`openapi_channel_rule`.`member_price`

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelRuleList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "channelId": 1,
      "cardName": "",
      "channel": "1",
      "typeId": "",
      "cardNumLimit": 0,
      "cardNumRemain": 0,
      "status": 0,
      "addDate": "2026-01-01 12:00:00",
      "operatorId": 1,
      "cardModelId": 1,
      "goodsId": 1,
      "price": 0,
      "memberPrice": 0
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiChannelRuleService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiChannelRulePage 在用管理后台 #

发卡渠道规则信息-分页查询 · OpenapiChannelRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelRuleController#queryOpenapiChannelRulePage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_rule

ControllerOpenapiChannelRuleController#queryOpenapiChannelRulePage

转换BeanUtils.map → OpenapiChannelRuleQuery

ServiceOpenapiChannelRuleService#queryPage （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectPage ⇒ 表 openapi_channel_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiChannelRulePage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelRulePage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiChannelRulePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelRulePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
cardName	String	否	可选(@MvcOptional)	`openapi_channel_rule`.`card_name`
operatorId	Long	否	可选(@MvcOptional)	`openapi_channel_rule`.`operator_id`
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiChannelRuleResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`openapi_channel_rule`.`id`	id
channelId	Long		`openapi_channel_rule`.`channel_id`
cardName	String		`openapi_channel_rule`.`card_name`	卡名称
channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_rule`.`channel`	卡种平台
typeId	String		`openapi_channel_rule`.`type_id`	卡种id
cardNumLimit	Integer		`openapi_channel_rule`.`card_num_limit`	发卡数量限制
cardNumRemain	Integer		`openapi_channel_rule`.`card_num_remain`	剩余可发卡数量
status	Integer		`openapi_channel_rule`.`status`	状态 0=禁用 1=正常
addDate	Date		`openapi_channel_rule`.`add_date`	添加时间
operatorId	Long		`openapi_channel_rule`.`operator_id`	渠道id
cardModelId	Long		`openapi_channel_rule`.`card_model_id`	卡种id
goodsId	Long		`openapi_channel_rule`.`goods_id`	商品id
price	Integer		`openapi_channel_rule`.`price`
memberPrice	Integer		`openapi_channel_rule`.`member_price`

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiChannelRulePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "cardName": "",
    "operatorId": 1,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "channelId": 1,
        "cardName": "",
        "channel": "1",
        "typeId": "",
        "cardNumLimit": 0,
        "cardNumRemain": 0,
        "status": 0,
        "addDate": "2026-01-01 12:00:00",
        "operatorId": 1,
        "cardModelId": 1,
        "goodsId": 1,
        "price": 0,
        "memberPrice": 0
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiChannelRuleService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryOpenapiChannelRulePage exact

POST /openapi/updateOpenapiChannelRule 在用管理后台 #

发卡渠道规则信息-更新 · OpenapiChannelRuleController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiChannelRuleController#updateOpenapiChannelRule
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_ruleskugoodscard_model

ControllerOpenapiChannelRuleController#updateOpenapiChannelRule

转换BeanUtils.map → OpenapiChannelRule ⇒ 表 openapi_channel_rule

ServiceOpenapiChannelRuleService#get （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectById ⇒ 表 openapi_channel_rule

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceOpenapiChannelRuleService#update （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#updateById ⇒ 表 openapi_channel_rule

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiChannelRule
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelRule
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiChannelRule	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiChannelRuleUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_channel_rule`.`id`	id
skuId	Long	是	必填	—
status	Integer	是	必填	`openapi_channel_rule`.`status`
price	Integer	是	必填	`openapi_channel_rule`.`price`
memberPrice	Integer			`openapi_channel_rule`.`member_price`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiChannelRule

{
  "body": {
    "id": 1,
    "skuId": 1,
    "status": 0,
    "price": 0,
    "memberPrice": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要查询详情（openapiChannelRuleService.get）；查询详情（skuService.get）；查询详情（goodsService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

dscp-html-manage updateOpenapiChannelRule exact

OpenapiCqyRecordController 14/20 在用

POST /cqy/addOpenapiCqyRecord 未使用管理后台 #

春秋游记录-新增 · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#addOpenapiCqyRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#addOpenapiCqyRecord

转换BeanUtils.map → OpenapiCqyRecord ⇒ 表 openapi_cqy_record

ServiceOpenapiCqyRecordService#add （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#insert ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/addOpenapiCqyRecord
uat	https://dscp-uat.hn12301.net/manage-api/cqy/addOpenapiCqyRecord
pro	https://dscp-uat.hn12301.net/manage-api/cqy/addOpenapiCqyRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCqyRecordAddRequest

字段	类型	表 / 列	说明
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	`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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	`openapi_cqy_record`.`goods_id`	产品id
createTime	Date	`openapi_cqy_record`.`create_time`	创建日期
updateTime	Date	`openapi_cqy_record`.`update_time`	更新时间
remark	String	`openapi_cqy_record`.`remark`
checkerId	Long	`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String	`openapi_cqy_record`.`checker_name`	核销人员姓名

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cqy/addOpenapiCqyRecord

{
  "body": {
    "orgId": "",
    "mobile": "13800000000",
    "userName": "",
    "actName": "",
    "couponType": "",
    "couponNumber": "",
    "couponStatus": 0,
    "amount": "",
    "getTime": "2026-01-01 12:00:00",
    "consumeTime": "2026-01-01 12:00:00",
    "orderId": "",
    "goodsId": 1,
    "createTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiCqyRecordService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cqy/bindGoods 在用管理后台 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#bindGoods
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOpenapiCqyRecordController#bindGoods

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

OpenapiCqyRecordService.bindGoodsGoodsCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/bindGoods
uat	https://dscp-uat.hn12301.net/manage-api/cqy/bindGoods
pro	https://dscp-uat.hn12301.net/manage-api/cqy/bindGoods	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CqyThirdRequest

字段	类型	表 / 列	说明
startTime	Date	—	开始时间
endTime	Date	—	结束时间
orgId	String	—	单位ID
realname	String	—	姓名
mobile	String	—	手机号
actName	String	—	活动名称
cardType	String	—	余额券类型
cardNo	String	—	余额券号
flkState	String	—	卡状态
getTime	Date	—
goodsId	Long	—
amount	String	—	累计发放金额
pageNo	Integer	—
pageSize	Integer	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cqy/bindGoods

{
  "body": {
    "startTime": "2026-01-01 12:00:00",
    "endTime": "2026-01-01 12:00:00",
    "orgId": "",
    "realname": "",
    "mobile": "13800000000",
    "actName": "",
    "cardType": "",
    "cardNo": "",
    "flkState": "",
    "getTime": "2026-01-01 12:00:00",
    "goodsId": 1,
    "amount": "",
    "pageNo": 0,
    "pageSize": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 bindGoods（openapiCqyRecordService.bindGoods）

前端调用方

dscp-html-manage bindGoods exact

POST /cqy/cqyCheck 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#cqyCheck
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_recordorderchecker

ControllerOpenapiCqyRecordController#cqyCheck

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOpenapiCqyRecordService#get （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectById ⇒ 表 openapi_cqy_record

ServiceCheckerService#get （CheckerServiceImpl）

MapperCheckerMapper#selectById ⇒ 表 checker

ServiceOpenapiCqyRecordService#update （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#updateById ⇒ 表 openapi_cqy_record

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/cqyCheck
uat	https://dscp-uat.hn12301.net/open-api/cqy/cqyCheck
pro	https://dscp-uat.hn12301.net/open-api/cqy/cqyCheck	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CqyCheckRequest

字段	类型	必填	取值/校验	表 / 列	说明
userId	Long	是	必填	—
checkCode	String	是	必填	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiCqyRecord　（object）

字段	类型	表 / 列	说明
id	Long	`openapi_cqy_record`.`id`	id
orgId	String	`openapi_cqy_record`.`org_id`	单位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	`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功 4=已过期 5=已使用
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	`openapi_cqy_record`.`goods_id`	产品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	`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String	`openapi_cqy_record`.`checker_name`	核销人员姓名

示例

请求示例（自动生成，仅结构参考）

POST /cqy/cqyCheck

{
  "body": {
    "userId": 1,
    "checkCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orgId": "",
    "mobile": "13800000000",
    "userName": "",
    "actName": "",
    "couponType": "",
    "couponNumber": "",
    "couponStatus": 0,
    "amount": "",
    "getTime": "2026-01-01 12:00:00",
    "consumeTime": "2026-01-01 12:00:00",
    "orderId": "",
    "goodsId": 1,
    "goodsName": "",
    "createTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

处理逻辑

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

前端调用方

writeoff cqyCheck exact

POST /cqy/cqyCheckerGoods 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#cqyCheckerGoods
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodschecker_cqy_relation

ControllerOpenapiCqyRecordController#cqyCheckerGoods

ServiceCheckerCqyRelationService#queryList （CheckerCqyRelationServiceImpl）

MapperCheckerCqyRelationMapper#selectList ⇒ 表 checker_cqy_relation

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

GoodsCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/cqyCheckerGoods
uat	https://dscp-uat.hn12301.net/open-api/cqy/cqyCheckerGoods
pro	https://dscp-uat.hn12301.net/open-api/cqy/cqyCheckerGoods	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	userId	Long	是		—

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<Goods>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`goods`.`id`	商品id，主键
merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`goods`.`shop_id`	所属商铺id
name	String		`goods`.`name`	商品名称
cardModelId	Long		`goods`.`card_model_id`	旅游卡ID，关联旅游卡表id
mainPic	String		`goods`.`main_pic`	商品主图
typeId	String		`goods`.`type_id`	商品大类
subTypeId	String		`goods`.`sub_type_id`	商品小类
grade	String		`goods`.`grade`	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		`goods`.`qrcode`	商品二维码
isDeleted	Boolean		`goods`.`is_deleted`	是否删除
createdBy	Long		`goods`.`created_by`	创建人
createdTime	Date		`goods`.`created_time`	创建时间
updatedBy	Long		`goods`.`updated_by`	修改人
updatedTime	Date		`goods`.`updated_time`	修改时间
thirdId	String		`goods`.`third_id`	第三方id
thirdName	String		`goods`.`third_name`	第三方名称

示例

请求示例（自动生成，仅结构参考）

POST /cqy/cqyCheckerGoods?userId=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "cardModelId": 1,
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "subTypeId": "",
      "grade": "",
      "status": "1",
      "qrcode": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（cqyRelationService.queryList）

前端调用方

writeoff cqyCheckerGoods exact

POST /cqy/createOrder 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#createOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表order_operatelogskumembergoodsopenapi_cqy_recordordergoods_relationorder_goodsorder_payment

ControllerOpenapiCqyRecordController#createOrder

转换BeanUtils.map → OrderOperatelog ⇒ 表 order_operatelog

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceOpenapiCqyRecordService#get （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectById ⇒ 表 openapi_cqy_record

ServiceOrderService#maxOrderId （OrderServiceImpl）

MapperOrderMapper#maxOrderId ⇒ 表 order

ServiceGoodsRelationService#get （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectById ⇒ 表 goods_relation

ServiceOrderService#add （OrderServiceImpl）

MapperOrderMapper#insert ⇒ 表 order

ServiceOrderGoodsService#add （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#insert ⇒ 表 order_goods

ServiceOrderOperatelogService#add （OrderOperatelogServiceImpl）

MapperOrderOperatelogMapper#insert ⇒ 表 order_operatelog

ServiceSkuService#update （SkuServiceImpl）

MapperSkuMapper#updateById ⇒ 表 sku

ServiceOpenapiCqyRecordService#update （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#updateById ⇒ 表 openapi_cqy_record

ServiceOrderService#callbackOrder （OrderServiceImpl）

转换BeanUtils.map → OrderIdRequest

转换BeanUtils.map → OrderUpdateRequest

转换BeanUtils.map → OrderPayment ⇒ 表 order_payment

转换BeanUtils.map → OrderOperatelog ⇒ 表 order_operatelog

MapperOrderMapper#queryOrderByOrderId ⇒ 表 order

ServiceOrderPaymentService#add （OrderPaymentServiceImpl）

MapperOrderPaymentMapper#insert ⇒ 表 order_payment

ServiceOrderOperatelogService#add （OrderOperatelogServiceImpl）

MapperOrderOperatelogMapper#insert ⇒ 表 order_operatelog

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 4

LockService.tryLockMemberService.getMemberGoodsInfoService.mustGetPayProperties.getMchid

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/createOrder
uat	https://dscp-uat.hn12301.net/open-api/cqy/createOrder
pro	https://dscp-uat.hn12301.net/open-api/cqy/createOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CreateOrderRequest

字段	类型	表 / 列	说明
mobile	String	`member`.`mobile`
openId	String	`member`.`open_id`
skuId	Long	—
num	Integer	—
plat	Integer	—	微信=1，融宝=2

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ChannelPrePayResponse　（object）

字段	类型	表 / 列	说明
outTradeNo	String	—	我方交易号
tradeNo	String	—	第三方交易号
flag	Boolean	—
payUrl	String	—

示例

请求示例（自动生成，仅结构参考）

POST /cqy/createOrder

{
  "body": {
    "mobile": "13800000000",
    "openId": "",
    "skuId": 1,
    "num": 0,
    "plat": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "outTradeNo": "",
    "tradeNo": "",
    "flag": false,
    "payUrl": "https://example.com/x.png"
  }
}

处理逻辑

逻辑摘要查询详情（skuService.get）；调用 tryLock（lockService.tryLock）；查询详情（memberService.getMember）

内联注释

查询是否有券有资格
生成订单ID
当前时间
构建订单的数据
订单id
商铺Id
商户Id
会员用户Id

前端调用方

xghmall createCqyOrder exact

POST /cqy/deleteOpenapiCqyRecord 未使用管理后台 #

春秋游记录-删除 · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#deleteOpenapiCqyRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#deleteOpenapiCqyRecord

ServiceOpenapiCqyRecordService#delete （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#deleteById ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/deleteOpenapiCqyRecord
uat	https://dscp-uat.hn12301.net/manage-api/cqy/deleteOpenapiCqyRecord
pro	https://dscp-uat.hn12301.net/manage-api/cqy/deleteOpenapiCqyRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_cqy_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cqy/deleteOpenapiCqyRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiCqyRecordService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cqy/getOpenapiCqyRecord 未使用管理后台 #

春秋游记录-详情 · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#getOpenapiCqyRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#getOpenapiCqyRecord

ServiceOpenapiCqyRecordService#get （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectById ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/getOpenapiCqyRecord
uat	https://dscp-uat.hn12301.net/manage-api/cqy/getOpenapiCqyRecord
pro	https://dscp-uat.hn12301.net/manage-api/cqy/getOpenapiCqyRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_cqy_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiCqyRecordResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`openapi_cqy_record`.`id`	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		`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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		`openapi_cqy_record`.`goods_id`	产品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		`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String		`openapi_cqy_record`.`checker_name`	核销人员姓名
order	Order		—
order.id	Long		`openapi_cqy_record`.`id`	id
order.orderId	Long		`openapi_cqy_record`.`order_id`	订单Id，主键
order.merchantId	Long		—	商户Id，merchant表Id
order.shopId	Long		—	商铺Id，shop表Id
order.memberId	Long		—	会员用户Id
order.orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	—	订单类型(枚举:order.OrderType)，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食
order.orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	—	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
order.buyNum	Integer		—	购买份数
order.orderAmount	Integer		—	订单金额(订单原始金额)
order.receivableAmount	Integer		—	应收金额
order.payableAmount	Integer		—	实收金额
order.reducedPrice	Integer		—	优惠金额
order.expressAmount	Integer		—	运费金额
order.discountAmount	Integer		—	折扣金额
order.isDelivery	Integer		—	是否配送(0=否；1=是)
order.payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	—	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
order.orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	—	订单状态(枚举:order.OrderStatus)，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消
order.orderPhone	String		—	下单人手机
order.orderRemark	String		—	订单备注
order.orderTime	Date		—	下单时间
order.orderExpressTime	Date		—	订单失效时间
order.isSendIntegral	Integer		—	订单积分是否已发放(0=否 1=是)
order.isComment	Integer		—	订单是否已经评价(0=否；1=是)
order.isProfitSharing	Integer		—	订单资金是否已冻结(0=已冻结 1=已解冻)
order.isSendCommission	SendCommission	0订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金1是2无佣金	—	订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金
order.icode	String		—	分销邀请码
order.shouldReturnCommission	Integer		—	应返佣金
order.reallyReturnCommission	Integer		—	实返佣金
order.createdBy	String		—	创建人id
order.createdTime	LocalDateTime		—	创建时间
order.updatedBy	String		—	更新人id
order.updatedTime	LocalDateTime		—	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /cqy/getOpenapiCqyRecord

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orgId": "",
    "mobile": "13800000000",
    "userName": "",
    "actName": "",
    "couponType": "",
    "couponNumber": "",
    "couponStatus": 0,
    "amount": "",
    "getTime": "2026-01-01 12:00:00",
    "consumeTime": "2026-01-01 12:00:00",
    "orderId": "",
    "goodsId": 1,
    "goodsName": "",
    "createTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": "",
    "order": {
      "id": 1,
      "orderId": 1,
      "merchantId": 1,
      "shopId": 1,
      "memberId": 1,
      "orderType": "1",
      "orderSource": "1",
      "buyNum": 0,
      "orderAmount": 0,
      "receivableAmount": 0,
      "payableAmount": 0,
      "reducedPrice": 0,
      "expressAmount": 0,
      "discountAmount": 0,
      "isDelivery": 0,
      "payStatus": "1",
      "orderStatus": "1",
      "orderPhone": "13800000000",
      "orderRemark": "",
      "orderTime": "2026-01-01 12:00:00",
      "orderExpressTime": "2026-01-01 12:00:00",
      "isSendIntegral": 0,
      "isComment": 0,
      "isProfitSharing": 0,
      "isSendCommission": "0",
      "icode": "",
      "shouldReturnCommission": 0,
      "reallyReturnCommission": 0,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    }
  }
}

处理逻辑

逻辑摘要查询详情（openapiCqyRecordService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cqy/getOrder 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#getOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表orderopenapi_cqy_recordorder_paymentskugoods_info

ControllerOpenapiCqyRecordController#getOrder

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOpenapiCqyRecordService#get （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectById ⇒ 表 openapi_cqy_record

ServiceOrderPaymentService#queryList （OrderPaymentServiceImpl）

MapperOrderPaymentMapper#selectList ⇒ 表 order_payment

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceGoodsInfoService#get （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectById ⇒ 表 goods_info

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

OrderGoodsService.mustGetGoodsCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/getOrder
uat	https://dscp-uat.hn12301.net/open-api/cqy/getOrder
pro	https://dscp-uat.hn12301.net/open-api/cqy/getOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
orderNo	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　CqyOrderDetailResponse　（object）

字段	类型	取值/校验	表 / 列	说明
order	Order		—
order.id	Long		`order`.`id`	id
order.orderId	Long		`order`.`order_id`	订单Id，主键
order.merchantId	Long		`order`.`merchant_id`	商户Id，merchant表Id
order.shopId	Long		`order`.`shop_id`	商铺Id，shop表Id
order.memberId	Long		`order`.`member_id`	会员用户Id
order.orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	`order`.`order_type`	订单类型(枚举:order.OrderType)，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食
order.orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	`order`.`order_source`	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
order.buyNum	Integer		`order`.`buy_num`	购买份数
order.orderAmount	Integer		`order`.`order_amount`	订单金额(订单原始金额)
order.receivableAmount	Integer		`order`.`receivable_amount`	应收金额
order.payableAmount	Integer		`order`.`payable_amount`	实收金额
order.reducedPrice	Integer		`order`.`reduced_price`	优惠金额
order.expressAmount	Integer		`order`.`express_amount`	运费金额
order.discountAmount	Integer		`order`.`discount_amount`	折扣金额
order.isDelivery	Integer		`order`.`is_delivery`	是否配送(0=否；1=是)
order.payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`order`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
order.orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	`order`.`order_status`	订单状态(枚举:order.OrderStatus)，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消
order.orderPhone	String		`order`.`order_phone`	下单人手机
order.orderRemark	String		`order`.`order_remark`	订单备注
order.orderTime	Date		`order`.`order_time`	下单时间
order.orderExpressTime	Date		`order`.`order_express_time`	订单失效时间
order.isSendIntegral	Integer		`order`.`is_send_integral`	订单积分是否已发放(0=否 1=是)
order.isComment	Integer		`order`.`is_comment`	订单是否已经评价(0=否；1=是)
order.isProfitSharing	Integer		`order`.`is_profit_sharing`	订单资金是否已冻结(0=已冻结 1=已解冻)
order.isSendCommission	SendCommission	0订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金1是2无佣金	`order`.`is_send_commission`	订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金
order.icode	String		`order`.`icode`	分销邀请码
order.shouldReturnCommission	Integer		`order`.`should_return_commission`	应返佣金
order.reallyReturnCommission	Integer		`order`.`really_return_commission`	实返佣金
order.createdBy	String		`order`.`created_by`	创建人id
order.createdTime	LocalDateTime		`order`.`created_time`	创建时间
order.updatedBy	String		`order`.`updated_by`	更新人id
order.updatedTime	LocalDateTime		`order`.`updated_time`	更新时间
orderGoods	OrderGoods		—
orderGoods.id	Long		`order`.`id`
orderGoods.orderId	Long		`order`.`order_id`	订单号，order表id
orderGoods.goodsId	Long		`openapi_cqy_record`.`goods_id`	产品id，goods表id
orderGoods.goodsName	String		`openapi_cqy_record`.`goods_name`	产品名称
orderGoods.goodsSkuId	Long		—	产品SKU id，sku表id
orderGoods.goodsSkuName	String		—	产品SKU
orderGoods.skuPrice	Integer		—	产品SKU销售价
orderGoods.isDelivery	Integer		`order`.`is_delivery`	是否需要配送(0=否 1=是)
orderGoods.isIntegral	Integer		—	是否产生积分(0=否 1=是)
orderGoods.integralRate	BigDecimal		—	积分倍率
orderGoods.createdBy	String		`order`.`created_by`	创建人id
orderGoods.createdTime	LocalDateTime		`order`.`created_time`	创建时间
orderGoods.updatedBy	String		`order`.`updated_by`	更新人id
orderGoods.updatedTime	LocalDateTime		`order`.`updated_time`	更新时间
goods	Goods		—
goods.id	Long		`order`.`id`	商品id，主键
goods.merchantId	Long		`order`.`merchant_id`	所属商户id，关联merchant表id
goods.shopId	Long		`order`.`shop_id`	所属商铺id
goods.name	String		—	商品名称
goods.cardModelId	Long		—	旅游卡ID，关联旅游卡表id
goods.mainPic	String		—	商品主图
goods.typeId	String		—	商品大类
goods.subTypeId	String		—	商品小类
goods.grade	String		—	商品等级
goods.status	GoodsStatus	1已上架2编辑中3已下架	`order_payment`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
goods.qrcode	String		—	商品二维码
goods.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
goods.createdBy	Long		`order`.`created_by`	创建人
goods.createdTime	Date		`order`.`created_time`	创建时间
goods.updatedBy	Long		`order`.`updated_by`	修改人
goods.updatedTime	Date		`order`.`updated_time`	修改时间
goods.thirdId	String		—	第三方id
goods.thirdName	String		—	第三方名称
sku	Sku		—
sku.id	Long		`order`.`id`	商品skuID，主键
sku.merchantId	Long		`order`.`merchant_id`	所属商户id
sku.shopId	Long		`order`.`shop_id`	所属商铺id
sku.goodsId	Long		`openapi_cqy_record`.`goods_id`	商品ID，关联商品表id
sku.goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
sku.skuName	String		`sku`.`sku_name`	sku名称
sku.showPrice	Integer		`sku`.`show_price`	商品挂牌价
sku.buyPrice	Integer		`sku`.`buy_price`	商品实际售价
sku.costPrice	Integer		`sku`.`cost_price`	商品成本价
sku.buyCount	Integer		`sku`.`buy_count`	单次可购买数量
sku.stock	Integer		`sku`.`stock`	库存数量
sku.isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
sku.carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
sku.mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
sku.isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
sku.commission	Integer		`sku`.`commission`	分销佣金
sku.isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
sku.isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
sku.isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
sku.useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
sku.addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
sku.cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
sku.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
sku.createdBy	String		`order`.`created_by`	创建人id
sku.createdTime	Date		`order`.`created_time`	创建时间
sku.updatedBy	String		`order`.`updated_by`	更新人id
sku.updatedTime	Date		`order`.`updated_time`	修改时间
goodsInfo	GoodsInfo		—
goodsInfo.id	Long		`order`.`id`	商品id，主键
goodsInfo.shortName	String		`goods_info`.`short_name`	商品简称
goodsInfo.weight	Integer		`goods_info`.`weight`	商品权重
goodsInfo.tags	String		`goods_info`.`tags`	商品标签
goodsInfo.businessTime	String		`goods_info`.`business_time`	营业时间
goodsInfo.recommendReason	String		`goods_info`.`recommend_reason`	推荐理由
goodsInfo.introduction	String		`goods_info`.`introduction`	简介
goodsInfo.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
goodsInfo.video	String		`goods_info`.`video`	宣传视频url地址
goodsInfo.notice	String		`goods_info`.`notice`	购买须知
goodsInfo.tips	String		`goods_info`.`tips`	温馨提示
goodsInfo.expireDate	Date		`goods_info`.`expire_date`
goodsInfo.isRefund	Boolean		`goods_info`.`is_refund`
goodsInfo.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
goodsInfo.createdBy	String		`order`.`created_by`	创建人id
goodsInfo.createdTime	LocalDateTime		`order`.`created_time`	创建时间
goodsInfo.updatedBy	String		`order`.`updated_by`	更新人id
goodsInfo.updatedTime	LocalDateTime		`order`.`updated_time`	更新时间
paymentList	List<OrderPayment>		—
paymentList[].id	Long		`order`.`id`
paymentList[].orderId	Long		`order`.`order_id`	订单号，order表id
paymentList[].paymentType	PaymentType	1收款2退款3红冲4返佣5抵扣6手续费	`order_payment`.`payment_type`	交易类型(枚举:PaymentType)，1=收款 2=退款 3=红冲 4=返佣 5=抵扣 6=手续费
paymentList[].paymentMode	PaymentMode	1积分2优惠券3微信4支付宝5工商银行6其他7湘工惠8建行+1	`order_payment`.`payment_mode`	交易方式(枚举:PaymentMode)，1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他
paymentList[].paymentAmount	Integer		`order_payment`.`payment_amount`	交易金额
paymentList[].paymentCurrency	Integer		`order_payment`.`payment_currency`	交易币种（1=人民币）
paymentList[].transactionNo	String		`order_payment`.`transaction_no`	支付中心otg的交易流水
paymentList[].remark	String		`openapi_cqy_record`.`remark`	备注(如:积分抵扣，优惠券抵扣)
paymentList[].status	Integer		`order_payment`.`status`	状态(1=成功 )
paymentList[].createdBy	String		`order`.`created_by`	创建人id
paymentList[].createdTime	Date		`order`.`created_time`	交易时间
paymentList[].updatedBy	String		`order`.`updated_by`	更新人id
paymentList[].updatedTime	Date		`order`.`updated_time`
cqyRecord	OpenapiCqyRecord		—
cqyRecord.id	Long		`order`.`id`	id
cqyRecord.orgId	String		`openapi_cqy_record`.`org_id`	单位id
cqyRecord.mobile	String		`openapi_cqy_record`.`mobile`	手机号
cqyRecord.userName	String		`openapi_cqy_record`.`user_name`	姓名
cqyRecord.actName	String		`openapi_cqy_record`.`act_name`	活动名称
cqyRecord.couponType	String		`openapi_cqy_record`.`coupon_type`	券类型
cqyRecord.couponNumber	String		`openapi_cqy_record`.`coupon_number`	券号
cqyRecord.couponStatus	Integer		`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功 4=已过期 5=已使用
cqyRecord.amount	String		`openapi_cqy_record`.`amount`	累计发放金额
cqyRecord.getTime	Date		`openapi_cqy_record`.`get_time`	领取日期
cqyRecord.consumeTime	Date		`openapi_cqy_record`.`consume_time`	核销日期
cqyRecord.orderId	String		`order`.`order_id`	订单号
cqyRecord.goodsId	Long		`openapi_cqy_record`.`goods_id`	产品id
cqyRecord.goodsName	String		`openapi_cqy_record`.`goods_name`
cqyRecord.createTime	Date		`openapi_cqy_record`.`create_time`	创建日期
cqyRecord.updateTime	Date		`openapi_cqy_record`.`update_time`	更新时间
cqyRecord.remark	String		`openapi_cqy_record`.`remark`
cqyRecord.checkerId	Long		`openapi_cqy_record`.`checker_id`	核销人id
cqyRecord.checkerName	String		`openapi_cqy_record`.`checker_name`	核销人员姓名
qrCode	String		—

示例

请求示例（自动生成，仅结构参考）

POST /cqy/getOrder

{
  "body": {
    "orderNo": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "order": {
      "id": 1,
      "orderId": 1,
      "merchantId": 1,
      "shopId": 1,
      "memberId": 1,
      "orderType": "1",
      "orderSource": "1",
      "buyNum": 0,
      "orderAmount": 0,
      "receivableAmount": 0,
      "payableAmount": 0,
      "reducedPrice": 0,
      "expressAmount": 0,
      "discountAmount": 0,
      "isDelivery": 0,
      "payStatus": "1",
      "orderStatus": "1",
      "orderPhone": "13800000000",
      "orderRemark": "",
      "orderTime": "2026-01-01 12:00:00",
      "orderExpressTime": "2026-01-01 12:00:00",
      "isSendIntegral": 0,
      "isComment": 0,
      "isProfitSharing": 0,
      "isSendCommission": "0",
      "icode": "",
      "shouldReturnCommission": 0,
      "reallyReturnCommission": 0,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "orderGoods": {
      "id": 1,
      "orderId": 1,
      "goodsId": 1,
      "goodsName": "",
      "goodsSkuId": 1,
      "goodsSkuName": "",
      "skuPrice": 0,
      "isDelivery": 0,
      "isIntegral": 0,
      "integralRate": 0,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "goods": {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "cardModelId": 1,
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "subTypeId": "",
      "grade": "",
      "status": "1",
      "qrcode": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    },
    "sku": {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "goodsId": 1,
      "goodsChannelId": 1,
      "skuName": "",
      "showPrice": 0,
      "buyPrice": 0,
      "costPrice": 0,
      "buyCount": 0,
      "stock": 0,
      "isLogistic": false,
      "carriageId": 1,
      "mold": "1",
      "isDistributes": false,
      "commission": 0,
      "isPreferential": false,
      "isUseScore": false,
      "isAddScore": false,
      "useScoreRate": 0,
      "addScoreRate": 0,
      "cardNum": 0,
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "goodsInfo": {
      "id": 1,
      "shortName": "",
      "weight": 0,
      "tags": "",
      "businessTime": "2026-01-01 12:00:00",
      "recommendReason": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "notice": "",
      "tips": "",
      "expireDate": "2026-01-01 12:00:00",
      "isRefund": false,
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "paymentList": [
      {
        "id": 1,
        "orderId": 1,
        "paymentType": "1",
        "paymentMode": "1",
        "paymentAmount": 0,
        "paymentCurrency": 0,
        "transactionNo": "",
        "remark": "",
        "status": 0,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "cqyRecord": {
      "id": 1,
      "orgId": "",
      "mobile": "13800000000",
      "userName": "",
      "actName": "",
      "couponType": "",
      "couponNumber": "",
      "couponStatus": 0,
      "amount": "",
      "getTime": "2026-01-01 12:00:00",
      "consumeTime": "2026-01-01 12:00:00",
      "orderId": "",
      "goodsId": 1,
      "goodsName": "",
      "createTime": "2026-01-01 12:00:00",
      "updateTime": "2026-01-01 12:00:00",
      "remark": "",
      "checkerId": 1,
      "checkerName": ""
    },
    "qrCode": ""
  }
}

处理逻辑

逻辑摘要调用 mustGet（orderGoodsService.mustGet）；查询详情（orderService.get）；查询详情（openapiCqyRecordService.get）

内联注释

查询出旅游卡订单关联的商品信息
根据商品ID查询出商品信息

前端调用方

xghmall getCqyOrder exact

POST /cqy/goodsDetail 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#goodsDetail
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsskusku_entrancegoods_relationshopregion

ControllerOpenapiCqyRecordController#goodsDetail

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceSkuEntranceService#queryList （SkuEntranceServiceImpl）

MapperSkuEntranceMapper#selectList ⇒ 表 sku_entrance

ServiceGoodsRelationService#queryList （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectList ⇒ 表 goods_relation

ServiceShopService#get （ShopServiceImpl）

MapperShopMapper#selectById ⇒ 表 shop

ServiceRegionService#get （RegionServiceImpl）

MapperRegionMapper#selectById ⇒ 表 region

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

GoodsInfoService.mustGet

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/goodsDetail
uat	https://dscp-uat.hn12301.net/open-api/cqy/goodsDetail
pro	https://dscp-uat.hn12301.net/open-api/cqy/goodsDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	goodsId	Long	是		`sku`.`goods_id`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　GoodsResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`goods`.`id`	商品id，主键
merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`goods`.`shop_id`	所属商铺id，关联shop表id
name	String		`goods`.`name`	商品名称
mainPic	String		`goods`.`main_pic`	商品主图
typeId	String		`goods`.`type_id`	商品大类id
cardModelId	Long		`goods`.`card_model_id`	卡种id
subTypeId	String		`goods`.`sub_type_id`	商品小类id
grade	String		`goods`.`grade`	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		`goods`.`qrcode`	商品二维码
shopsName	String		—	商铺名称
shortName	String		`region`.`short_name`	商品简称
weight	Integer		—	商品权重
tags	String		`shop`.`tags`	商品标签
buyPrice	Integer		`sku`.`buy_price`	商品实际售价
salesAmount	Integer		—	累计销售金额
recommendReason	String		—	推荐理由
introduction	String		`shop`.`introduction`	简介
propagatePic	String		`shop`.`propagate_pic`	宣传图片url地址
video	String		`shop`.`video`	宣传视频url地址
notice	String		—	购买须知
tips	String		`shop`.`tips`	温馨提示
skuList	List<SkuResponse>		—	sku列表
skuList[].id	Long		`goods`.`id`	商品SKUID，主键
skuList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
skuList[].skuName	String		`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer		`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer		`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer		`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
skuList[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
skuList[].skuEntranceList	List<SkuEntrance>		—	景区入口列表
skuEntranceList[].id	Long		`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long		`sku_entrance`.`sku_id`	所属关联sku表id
skuEntranceList[].entranceName	String		`sku_entrance`.`entrance_name`	景区入口名称
skuEntranceList[].merchantId	Long		`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long		`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuEntranceList[].createdBy	String		`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList	List<GoodsRelationResponse>		—
relationList[].id	Long		`goods`.`id`	id
relationList[].goodsId	Long		`sku`.`goods_id`	goodsId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		`goods`.`third_id`	第三方id
relationList[].thirdName	String		`goods`.`third_name`	第三方名称
relationList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList[].updatedTime	Date		`goods`.`updated_time`	修改时间
businessTime	String		`shop`.`business_time`	营业时间
thirdId	String		`goods`.`third_id`	第三方id
thirdName	String		`goods`.`third_name`	第三方名称
expireDate	Date		—
isRefund	Boolean		—
areaInfo	String		—
shop	Shop		—
shop.id	Long		`goods`.`id`	商铺id，主键
shop.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	`shop`.`merchant_type`	商户类型(枚举:merchant.MerchantType)
shop.name	String		`goods`.`name`	商铺名称
shop.logo	String		`shop`.`logo`	商铺LOGO图片url地址
shop.typeId	Long		`goods`.`type_id`	商铺大类
shop.subTypeId	Long		`goods`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`goods`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		`shop`.`province_id`	省id
shop.cityId	String		`shop`.`city_id`	市id
shop.districtId	String		`shop`.`district_id`	区县id
shop.address	String		`shop`.`address`	商铺地址
shop.mobile	String		`shop`.`mobile`	客服电话
shop.linkman	String		`shop`.`linkman`	商户联系人
shop.linkphone	String		`shop`.`linkphone`	商户联系人手机
shop.manager	String		`shop`.`manager`	专属客户经理
shop.level	String		`shop`.`level`	等级
shop.lng	String		`shop`.`lng`	经度
shop.lat	String		`shop`.`lat`	纬度
shop.introduction	String		`shop`.`introduction`	简介
shop.businessTime	String		`shop`.`business_time`	营业时间
shop.tags	String		`shop`.`tags`	商铺标签
shop.mainPic	String		`goods`.`main_pic`	景区主图url地址
shop.propagatePic	String		`shop`.`propagate_pic`	宣传图片url地址
shop.video	String		`shop`.`video`	景区视频url地址
shop.poster	String		`shop`.`poster`	分享海报url地址
shop.propagateContent	String		`shop`.`propagate_content`	宣传语
shop.description	String		`shop`.`description`	图文详情
shop.ticketInfo	String		`shop`.`ticket_info`	门票信息
shop.trafficInfo	String		`shop`.`traffic_info`	交通信息
shop.tips	String		`shop`.`tips`	温馨提示
shop.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
shop.createdBy	String		`goods`.`created_by`	创建人id
shop.createdTime	Date		`goods`.`created_time`	创建时间
shop.updatedBy	String		`goods`.`updated_by`	更新人id
shop.updatedTime	Date		`goods`.`updated_time`	修改时间
shop.thirdId	String		`goods`.`third_id`
shop.thirdName	String		`goods`.`third_name`

示例

请求示例（自动生成，仅结构参考）

POST /cqy/goodsDetail?goodsId=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "merchantId": 1,
    "shopId": 1,
    "name": "",
    "mainPic": "https://example.com/x.png",
    "typeId": "",
    "cardModelId": 1,
    "subTypeId": "",
    "grade": "",
    "status": "1",
    "qrcode": "",
    "shopsName": "",
    "shortName": "",
    "weight": 0,
    "tags": "",
    "buyPrice": 0,
    "salesAmount": 0,
    "recommendReason": "",
    "introduction": "",
    "propagatePic": "https://example.com/x.png",
    "video": "",
    "notice": "",
    "tips": "",
    "skuList": [
      {
        "id": 1,
        "goodsId": 1,
        "goodsChannelId": 1,
        "skuName": "",
        "showPrice": 0,
        "buyPrice": 0,
        "costPrice": 0,
        "buyCount": 0,
        "stock": 0,
        "isLogistic": false,
        "carriageId": 1,
        "mold": "1",
        "isDistributes": false,
        "commission": 0,
        "isPreferential": false,
        "isUseScore": false,
        "isAddScore": false,
        "useScoreRate": 0,
        "addScoreRate": 0,
        "cardNum": 0,
        "skuEntranceList": [
          {
            "id": 1,
            "skuId": 1,
            "entranceName": "",
            "merchantId": 1,
            "shopId": 1,
            "goodsId": 1,
            "createdBy": "",
            "createdTime": "2026-01-01 12:00:00"
          }
        ]
      }
    ],
    "relationList": [
      {
        "id": 1,
        "goodsId": 1,
        "channelType": "1",
        "thirdId": "",
        "thirdName": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "businessTime": "2026-01-01 12:00:00",
    "thirdId": "",
    "thirdName": "",
    "expireDate": "2026-01-01 12:00:00",
    "isRefund": false,
    "areaInfo": "",
    "shop": {
      "id": 1,
      "merchantId": 1,
      "merchantType": "1",
      "name": "",
      "logo": "",
      "typeId": 1,
      "subTypeId": 1,
      "status": "1",
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "mobile": "13800000000",
      "linkman": "",
      "linkphone": "13800000000",
      "manager": "",
      "level": "",
      "lng": "",
      "lat": "",
      "introduction": "",
      "businessTime": "2026-01-01 12:00:00",
      "tags": "",
      "mainPic": "https://example.com/x.png",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "poster": "",
      "propagateContent": "",
      "description": "",
      "ticketInfo": "",
      "trafficInfo": "",
      "tips": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    }
  }
}

处理逻辑

逻辑摘要查询详情（goodsService.get）；调用 mustGet（goodsInfoService.mustGet）；调用 copyProperties（BeanUtil.copyProperties）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询商品信息
查询sku
查询relation

前端调用方

xghmall goodsDetail exact

POST /cqy/goodsList 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#productList
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodsskusku_entrancegoods_relationshopregion

ControllerOpenapiCqyRecordController#productList

ServiceGoodsService#queryList （GoodsServiceImpl）

MapperGoodsMapper#selectList ⇒ 表 goods

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceSkuEntranceService#queryList （SkuEntranceServiceImpl）

MapperSkuEntranceMapper#selectList ⇒ 表 sku_entrance

ServiceGoodsRelationService#queryList （GoodsRelationServiceImpl）

MapperGoodsRelationMapper#selectList ⇒ 表 goods_relation

ServiceShopService#get （ShopServiceImpl）

MapperShopMapper#selectById ⇒ 表 shop

ServiceRegionService#get （RegionServiceImpl）

MapperRegionMapper#selectById ⇒ 表 region

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

GoodsInfoService.mustGet

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/goodsList
uat	https://dscp-uat.hn12301.net/open-api/cqy/goodsList
pro	https://dscp-uat.hn12301.net/open-api/cqy/goodsList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<GoodsResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`goods`.`id`	商品id，主键
merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shopId	Long		`goods`.`shop_id`	所属商铺id，关联shop表id
name	String		`goods`.`name`	商品名称
mainPic	String		`goods`.`main_pic`	商品主图
typeId	String		`goods`.`type_id`	商品大类id
cardModelId	Long		`goods`.`card_model_id`	卡种id
subTypeId	String		`goods`.`sub_type_id`	商品小类id
grade	String		`goods`.`grade`	商品等级
status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
qrcode	String		`goods`.`qrcode`	商品二维码
shopsName	String		—	商铺名称
shortName	String		`region`.`short_name`	商品简称
weight	Integer		—	商品权重
tags	String		`shop`.`tags`	商品标签
buyPrice	Integer		`sku`.`buy_price`	商品实际售价
salesAmount	Integer		—	累计销售金额
recommendReason	String		—	推荐理由
introduction	String		`shop`.`introduction`	简介
propagatePic	String		`shop`.`propagate_pic`	宣传图片url地址
video	String		`shop`.`video`	宣传视频url地址
notice	String		—	购买须知
tips	String		`shop`.`tips`	温馨提示
skuList	List<SkuResponse>		—	sku列表
skuList[].id	Long		`goods`.`id`	商品SKUID，主键
skuList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
skuList[].skuName	String		`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer		`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer		`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer		`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
skuList[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
skuList[].skuEntranceList	List<SkuEntrance>		—	景区入口列表
skuEntranceList[].id	Long		`goods`.`id`	ID，主键
skuEntranceList[].skuId	Long		`sku_entrance`.`sku_id`	所属关联sku表id
skuEntranceList[].entranceName	String		`sku_entrance`.`entrance_name`	景区入口名称
skuEntranceList[].merchantId	Long		`goods`.`merchant_id`	所属商户id
skuEntranceList[].shopId	Long		`goods`.`shop_id`	所属商铺id
skuEntranceList[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
skuEntranceList[].createdBy	String		`goods`.`created_by`	创建人id
skuEntranceList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList	List<GoodsRelationResponse>		—
relationList[].id	Long		`goods`.`id`	id
relationList[].goodsId	Long		`sku`.`goods_id`	goodsId
relationList[].channelType	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`goods_relation`.`channel_type`	类型(枚举:checker.ChannelType)
relationList[].thirdId	String		`goods`.`third_id`	第三方id
relationList[].thirdName	String		`goods`.`third_name`	第三方名称
relationList[].createdTime	Date		`goods`.`created_time`	创建时间
relationList[].updatedTime	Date		`goods`.`updated_time`	修改时间
businessTime	String		`shop`.`business_time`	营业时间
thirdId	String		`goods`.`third_id`	第三方id
thirdName	String		`goods`.`third_name`	第三方名称
expireDate	Date		—
isRefund	Boolean		—
areaInfo	String		—
shop	Shop		—
shop.id	Long		`goods`.`id`	商铺id，主键
shop.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	`shop`.`merchant_type`	商户类型(枚举:merchant.MerchantType)
shop.name	String		`goods`.`name`	商铺名称
shop.logo	String		`shop`.`logo`	商铺LOGO图片url地址
shop.typeId	Long		`goods`.`type_id`	商铺大类
shop.subTypeId	Long		`goods`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`goods`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		`shop`.`province_id`	省id
shop.cityId	String		`shop`.`city_id`	市id
shop.districtId	String		`shop`.`district_id`	区县id
shop.address	String		`shop`.`address`	商铺地址
shop.mobile	String		`shop`.`mobile`	客服电话
shop.linkman	String		`shop`.`linkman`	商户联系人
shop.linkphone	String		`shop`.`linkphone`	商户联系人手机
shop.manager	String		`shop`.`manager`	专属客户经理
shop.level	String		`shop`.`level`	等级
shop.lng	String		`shop`.`lng`	经度
shop.lat	String		`shop`.`lat`	纬度
shop.introduction	String		`shop`.`introduction`	简介
shop.businessTime	String		`shop`.`business_time`	营业时间
shop.tags	String		`shop`.`tags`	商铺标签
shop.mainPic	String		`goods`.`main_pic`	景区主图url地址
shop.propagatePic	String		`shop`.`propagate_pic`	宣传图片url地址
shop.video	String		`shop`.`video`	景区视频url地址
shop.poster	String		`shop`.`poster`	分享海报url地址
shop.propagateContent	String		`shop`.`propagate_content`	宣传语
shop.description	String		`shop`.`description`	图文详情
shop.ticketInfo	String		`shop`.`ticket_info`	门票信息
shop.trafficInfo	String		`shop`.`traffic_info`	交通信息
shop.tips	String		`shop`.`tips`	温馨提示
shop.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
shop.createdBy	String		`goods`.`created_by`	创建人id
shop.createdTime	Date		`goods`.`created_time`	创建时间
shop.updatedBy	String		`goods`.`updated_by`	更新人id
shop.updatedTime	Date		`goods`.`updated_time`	修改时间
shop.thirdId	String		`goods`.`third_id`
shop.thirdName	String		`goods`.`third_name`

示例

请求示例（自动生成，仅结构参考）

POST /cqy/goodsList

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "cardModelId": 1,
      "subTypeId": "",
      "grade": "",
      "status": "1",
      "qrcode": "",
      "shopsName": "",
      "shortName": "",
      "weight": 0,
      "tags": "",
      "buyPrice": 0,
      "salesAmount": 0,
      "recommendReason": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "notice": "",
      "tips": "",
      "skuList": [
        {
          "id": 1,
          "goodsId": 1,
          "goodsChannelId": 1,
          "skuName": "",
          "showPrice": 0,
          "buyPrice": 0,
          "costPrice": 0,
          "buyCount": 0,
          "stock": 0,
          "isLogistic": false,
          "carriageId": 1,
          "mold": "1",
          "isDistributes": false,
          "commission": 0,
          "isPreferential": false,
          "isUseScore": false,
          "isAddScore": false,
          "useScoreRate": 0,
          "addScoreRate": 0,
          "cardNum": 0,
          "skuEntranceList": [
            {
              "id": 1,
              "skuId": 1,
              "entranceName": "",
              "merchantId": 1,
              "shopId": 1,
              "goodsId": 1,
              "createdBy": "",
              "createdTime": "2026-01-01 12:00:00"
            }
          ]
        }
      ],
      "relationList": [
        {
          "id": 1,
          "goodsId": 1,
          "channelType": "1",
          "thirdId": "",
          "thirdName": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ],
      "businessTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": "",
      "expireDate": "2026-01-01 12:00:00",
      "isRefund": false,
      "areaInfo": "",
      "shop": {
        "id": 1,
        "merchantId": 1,
        "merchantType": "1",
        "name": "",
        "logo": "",
        "typeId": 1,
        "subTypeId": 1,
        "status": "1",
        "provinceId": "",
        "cityId": "",
        "districtId": "",
        "address": "",
        "mobile": "13800000000",
        "linkman": "",
        "linkphone": "13800000000",
        "manager": "",
        "level": "",
        "lng": "",
        "lat": "",
        "introduction": "",
        "businessTime": "2026-01-01 12:00:00",
        "tags": "",
        "mainPic": "https://example.com/x.png",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "poster": "",
        "propagateContent": "",
        "description": "",
        "ticketInfo": "",
        "trafficInfo": "",
        "tips": "",
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      }
    }
  ]
}

处理逻辑

逻辑摘要列表查询（goodsService.queryList）；查询详情（goodsService.get）；调用 mustGet（goodsInfoService.mustGet）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

查询商品信息
查询sku
查询relation

前端调用方

xghmall goodsList exact

POST /cqy/listOrder 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#listOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表order

ControllerOpenapiCqyRecordController#listOrder

转换BeanUtils.map → OrderQuery

ServiceOrderService#queryPage （OrderServiceImpl）

MapperOrderMapper#selectPage ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

OrderGoodsService.mustGetGoodsCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/listOrder
uat	https://dscp-uat.hn12301.net/open-api/cqy/listOrder
pro	https://dscp-uat.hn12301.net/open-api/cqy/listOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbListOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
orderPhone	String			`order`.`order_phone`
orderStatus	OrderStatus		1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	`order`.`order_status`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OrderResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`order`.`id`	ID，主键
orderId	Long		`order`.`order_id`	订单Id，主键
merchantId	Long		`order`.`merchant_id`	商户Id，merchant表Id
merchantName	String		—	商户名称
shopId	Long		`order`.`shop_id`	商铺Id，shop表Id
shopName	String		—	商铺名称
memberId	Long		`order`.`member_id`	会员用户Id
memberPhone	String		—	会员用户手机号
orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	`order`.`order_type`	订单类型(枚举:order.OrderType)，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食
orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	`order`.`order_source`	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
buyNum	Integer		`order`.`buy_num`	购买份数
orderAmount	Integer		`order`.`order_amount`	订单金额(订单原始金额)
receivableAmount	Integer		`order`.`receivable_amount`	应收金额
payableAmount	Integer		`order`.`payable_amount`	实收金额
reducedPrice	Integer		`order`.`reduced_price`	优惠金额
expressAmount	Integer		`order`.`express_amount`	运费金额
discountAmount	Integer		`order`.`discount_amount`	折扣金额
isDelivery	Integer		`order`.`is_delivery`	是否配送(0=否；1=是)
payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`order`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	`order`.`order_status`	订单状态(枚举:order.OrderStatus)，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消
orderPhone	String		`order`.`order_phone`	下单人手机
orderRemark	String		`order`.`order_remark`	订单备注
orderTime	Date		`order`.`order_time`	下单时间
orderExpressTime	Date		`order`.`order_express_time`	订单失效时间
isSendIntegral	Integer		`order`.`is_send_integral`	订单积分是否已发放(0=否 1=是)
isComment	Integer		`order`.`is_comment`	订单是否已经评价(0=否；1=是)
isProfitSharing	Integer		`order`.`is_profit_sharing`	订单资金是否已冻结(0=已冻结 1=已解冻)
isSendCommission	SendCommission	0订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金1是2无佣金	`order`.`is_send_commission`	订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金
icode	String		`order`.`icode`	分销邀请码
shouldReturnCommission	Integer		`order`.`should_return_commission`	应返佣金
reallyReturnCommission	Integer		`order`.`really_return_commission`	实返佣金
goodsName	String		—	商品名称
goodsSkuName	String		—	商品Sku名称
refundAmount	Integer		—	退款金额
channelMerchantName	String		—	销售商户名称
channelShopName	String		—	销售商铺名称
transactionNo	String		—	支付中心otg的交易流水
refundTime	Date		—	退款时间

示例

请求示例（自动生成，仅结构参考）

POST /cqy/listOrder

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "orderPhone": "13800000000",
    "orderStatus": "1"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderId": 1,
        "merchantId": 1,
        "merchantName": "",
        "shopId": 1,
        "shopName": "",
        "memberId": 1,
        "memberPhone": "13800000000",
        "orderType": "1",
        "orderSource": "1",
        "buyNum": 0,
        "orderAmount": 0,
        "receivableAmount": 0,
        "payableAmount": 0,
        "reducedPrice": 0,
        "expressAmount": 0,
        "discountAmount": 0,
        "isDelivery": 0,
        "payStatus": "1",
        "orderStatus": "1",
        "orderPhone": "13800000000",
        "orderRemark": "",
        "orderTime": "2026-01-01 12:00:00",
        "orderExpressTime": "2026-01-01 12:00:00",
        "isSendIntegral": 0,
        "isComment": 0,
        "isProfitSharing": 0,
        "isSendCommission": "0",
        "icode": "",
        "shouldReturnCommission": 0,
        "reallyReturnCommission": 0,
        "goodsName": "",
        "goodsSkuName": "",
        "refundAmount": 0,
        "channelMerchantName": "",
        "channelShopName": "",
        "transactionNo": "",
        "refundTime": "2026-01-01 12:00:00"
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 isEmpty（StrUtil.isEmpty）；分页查询（orderService.queryPage）；调用 mustGet（orderGoodsService.mustGet）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

暂时只查询旅游卡订单
按订单时间排序
查询出旅游卡订单关联的商品信息
根据商品ID查询出商品信息

前端调用方

xghmall listCqyOrder exact

POST /cqy/prepay 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#prepay
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表order_goods

ControllerOpenapiCqyRecordController#prepay

ServiceOpenapiCqyRecordService#prepay （OpenapiCqyRecordServiceImpl）

ServiceOrderGoodsService#get （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#selectById ⇒ 表 order_goods

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

LockService.tryLockOrderService.mustGetGoodsCache.getTradeClientService.tradeLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/prepay
uat	https://dscp-uat.hn12301.net/open-api/cqy/prepay
pro	https://dscp-uat.hn12301.net/open-api/cqy/prepay	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ChannelPrePayRequest

字段	类型	必填	取值/校验	表 / 列	说明
openId	String			—
orderNo	String	是	必填	—	商户订单号
amount	Long	是	必填	—	订单金额，单位为分
description	String			—	商品描述
userId	String			—
type	Integer			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ChannelPrePayResponse　（object）

字段	类型	表 / 列	说明
outTradeNo	String	—	我方交易号
tradeNo	String	—	第三方交易号
flag	Boolean	—
payUrl	String	—

示例

请求示例（自动生成，仅结构参考）

POST /cqy/prepay

{
  "body": {
    "openId": "",
    "orderNo": "",
    "amount": 0,
    "description": "",
    "userId": "",
    "type": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "outTradeNo": "",
    "tradeNo": "",
    "flag": false,
    "payUrl": "https://example.com/x.png"
  }
}

处理逻辑

逻辑摘要调用 prepay（openapiCqyRecordService.prepay）

前端调用方

xghmall preCqyPay exact

POST /cqy/queryCqyCheck 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#queryQycCheck
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#queryQycCheck

MapperOpenapiCqyRecordService.getMapper#selectPage ⇒ 表 openapi_cqy_record

ServiceOpenapiCqyRecordService#queryPage （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectPage ⇒ 表 openapi_cqy_record

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

OpenapiCqyRecordService.applyWrapper

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/queryCqyCheck
uat	https://dscp-uat.hn12301.net/open-api/cqy/queryCqyCheck
pro	https://dscp-uat.hn12301.net/open-api/cqy/queryCqyCheck	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CqyCheckQueryRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`openapi_cqy_record`.`checker_id`
name	String		—	持卡人姓名
checkTimeRange	Date[]		—
goodsId	Long		`openapi_cqy_record`.`goods_id`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiCqyRecordResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`openapi_cqy_record`.`id`	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		`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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		`openapi_cqy_record`.`goods_id`	产品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		`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String		`openapi_cqy_record`.`checker_name`	核销人员姓名
order	Order		—
order.id	Long		`openapi_cqy_record`.`id`	id
order.orderId	Long		`openapi_cqy_record`.`order_id`	订单Id，主键
order.merchantId	Long		—	商户Id，merchant表Id
order.shopId	Long		—	商铺Id，shop表Id
order.memberId	Long		—	会员用户Id
order.orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	—	订单类型(枚举:order.OrderType)，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食
order.orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	—	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
order.buyNum	Integer		—	购买份数
order.orderAmount	Integer		—	订单金额(订单原始金额)
order.receivableAmount	Integer		—	应收金额
order.payableAmount	Integer		—	实收金额
order.reducedPrice	Integer		—	优惠金额
order.expressAmount	Integer		—	运费金额
order.discountAmount	Integer		—	折扣金额
order.isDelivery	Integer		—	是否配送(0=否；1=是)
order.payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	—	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
order.orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	—	订单状态(枚举:order.OrderStatus)，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消
order.orderPhone	String		—	下单人手机
order.orderRemark	String		—	订单备注
order.orderTime	Date		—	下单时间
order.orderExpressTime	Date		—	订单失效时间
order.isSendIntegral	Integer		—	订单积分是否已发放(0=否 1=是)
order.isComment	Integer		—	订单是否已经评价(0=否；1=是)
order.isProfitSharing	Integer		—	订单资金是否已冻结(0=已冻结 1=已解冻)
order.isSendCommission	SendCommission	0订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金1是2无佣金	—	订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金
order.icode	String		—	分销邀请码
order.shouldReturnCommission	Integer		—	应返佣金
order.reallyReturnCommission	Integer		—	实返佣金
order.createdBy	String		—	创建人id
order.createdTime	LocalDateTime		—	创建时间
order.updatedBy	String		—	更新人id
order.updatedTime	LocalDateTime		—	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /cqy/queryCqyCheck

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "name": "",
    "checkTimeRange": "2026-01-01 12:00:00",
    "goodsId": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orgId": "",
        "mobile": "13800000000",
        "userName": "",
        "actName": "",
        "couponType": "",
        "couponNumber": "",
        "couponStatus": 0,
        "amount": "",
        "getTime": "2026-01-01 12:00:00",
        "consumeTime": "2026-01-01 12:00:00",
        "orderId": "",
        "goodsId": 1,
        "goodsName": "",
        "createTime": "2026-01-01 12:00:00",
        "updateTime": "2026-01-01 12:00:00",
        "remark": "",
        "checkerId": 1,
        "checkerName": "",
        "order": {
          "id": 1,
          "orderId": 1,
          "merchantId": 1,
          "shopId": 1,
          "memberId": 1,
          "orderType": "1",
          "orderSource": "1",
          "buyNum": 0,
          "orderAmount": 0,
          "receivableAmount": 0,
          "payableAmount": 0,
          "reducedPrice": 0,
          "expressAmount": 0,
          "discountAmount": 0,
          "isDelivery": 0,
          "payStatus": "1",
          "orderStatus": "1",
          "orderPhone": "13800000000",
          "orderRemark": "",
          "orderTime": "2026-01-01 12:00:00",
          "orderExpressTime": "2026-01-01 12:00:00",
          "isSendIntegral": 0,
          "isComment": 0,
          "isProfitSharing": 0,
          "isSendCommission": "0",
          "icode": "",
          "shouldReturnCommission": 0,
          "reallyReturnCommission": 0,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 applyWrapper（openapiCqyRecordService.applyWrapper）；调用 isNotEmpty（StrUtil.isNotEmpty）；分页查询（openapiCqyRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

wrapper.like("user_name", request.getName());
wrapper.eq("goods_id", request.getGoodsId());
return checkList;

前端调用方

writeoff queryCqyCheck exact

POST /cqy/queryOpenapiCqyRecordList 未使用管理后台 #

春秋游记录-列表查询 · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#queryOpenapiCqyRecordList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#queryOpenapiCqyRecordList

转换BeanUtils.map → OpenapiCqyRecordQuery

ServiceOpenapiCqyRecordService#queryList （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectList ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordList
uat	https://dscp-uat.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordList
pro	https://dscp-uat.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCqyRecordListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
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			`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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			`openapi_cqy_record`.`goods_id`	产品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`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiCqyRecordResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`openapi_cqy_record`.`id`	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		`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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		`openapi_cqy_record`.`goods_id`	产品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		`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String		`openapi_cqy_record`.`checker_name`	核销人员姓名
order	Order		—
order.id	Long		`openapi_cqy_record`.`id`	id
order.orderId	Long		`openapi_cqy_record`.`order_id`	订单Id，主键
order.merchantId	Long		—	商户Id，merchant表Id
order.shopId	Long		—	商铺Id，shop表Id
order.memberId	Long		—	会员用户Id
order.orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	—	订单类型(枚举:order.OrderType)，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食
order.orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	—	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
order.buyNum	Integer		—	购买份数
order.orderAmount	Integer		—	订单金额(订单原始金额)
order.receivableAmount	Integer		—	应收金额
order.payableAmount	Integer		—	实收金额
order.reducedPrice	Integer		—	优惠金额
order.expressAmount	Integer		—	运费金额
order.discountAmount	Integer		—	折扣金额
order.isDelivery	Integer		—	是否配送(0=否；1=是)
order.payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	—	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
order.orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	—	订单状态(枚举:order.OrderStatus)，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消
order.orderPhone	String		—	下单人手机
order.orderRemark	String		—	订单备注
order.orderTime	Date		—	下单时间
order.orderExpressTime	Date		—	订单失效时间
order.isSendIntegral	Integer		—	订单积分是否已发放(0=否 1=是)
order.isComment	Integer		—	订单是否已经评价(0=否；1=是)
order.isProfitSharing	Integer		—	订单资金是否已冻结(0=已冻结 1=已解冻)
order.isSendCommission	SendCommission	0订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金1是2无佣金	—	订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金
order.icode	String		—	分销邀请码
order.shouldReturnCommission	Integer		—	应返佣金
order.reallyReturnCommission	Integer		—	实返佣金
order.createdBy	String		—	创建人id
order.createdTime	LocalDateTime		—	创建时间
order.updatedBy	String		—	更新人id
order.updatedTime	LocalDateTime		—	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /cqy/queryOpenapiCqyRecordList

{
  "body": {
    "keywords": "",
    "orgId": "",
    "mobile": "13800000000",
    "userName": "",
    "actName": "",
    "couponType": "",
    "couponNumber": "",
    "couponStatus": 0,
    "amount": "",
    "getTime": "2026-01-01 12:00:00",
    "consumeTime": "2026-01-01 12:00:00",
    "orderId": "",
    "goodsId": 1,
    "goodsName": "",
    "createTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "orgId": "",
      "mobile": "13800000000",
      "userName": "",
      "actName": "",
      "couponType": "",
      "couponNumber": "",
      "couponStatus": 0,
      "amount": "",
      "getTime": "2026-01-01 12:00:00",
      "consumeTime": "2026-01-01 12:00:00",
      "orderId": "",
      "goodsId": 1,
      "goodsName": "",
      "createTime": "2026-01-01 12:00:00",
      "updateTime": "2026-01-01 12:00:00",
      "remark": "",
      "checkerId": 1,
      "checkerName": "",
      "order": {
        "id": 1,
        "orderId": 1,
        "merchantId": 1,
        "shopId": 1,
        "memberId": 1,
        "orderType": "1",
        "orderSource": "1",
        "buyNum": 0,
        "orderAmount": 0,
        "receivableAmount": 0,
        "payableAmount": 0,
        "reducedPrice": 0,
        "expressAmount": 0,
        "discountAmount": 0,
        "isDelivery": 0,
        "payStatus": "1",
        "orderStatus": "1",
        "orderPhone": "13800000000",
        "orderRemark": "",
        "orderTime": "2026-01-01 12:00:00",
        "orderExpressTime": "2026-01-01 12:00:00",
        "isSendIntegral": 0,
        "isComment": 0,
        "isProfitSharing": 0,
        "isSendCommission": "0",
        "icode": "",
        "shouldReturnCommission": 0,
        "reallyReturnCommission": 0,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiCqyRecordService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cqy/queryOpenapiCqyRecordPage 在用管理后台 #

春秋游记录-分页查询 · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#queryOpenapiCqyRecordPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#queryOpenapiCqyRecordPage

转换BeanUtils.map → OpenapiCqyRecordQuery

ServiceOpenapiCqyRecordService#queryPage （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#selectPage ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordPage
uat	https://dscp-uat.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordPage
pro	https://dscp-uat.hn12301.net/manage-api/cqy/queryOpenapiCqyRecordPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCqyRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
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			`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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			`openapi_cqy_record`.`goods_id`	产品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`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiCqyRecordResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`openapi_cqy_record`.`id`	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		`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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		`openapi_cqy_record`.`goods_id`	产品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		`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String		`openapi_cqy_record`.`checker_name`	核销人员姓名
order	Order		—
order.id	Long		`openapi_cqy_record`.`id`	id
order.orderId	Long		`openapi_cqy_record`.`order_id`	订单Id，主键
order.merchantId	Long		—	商户Id，merchant表Id
order.shopId	Long		—	商铺Id，shop表Id
order.memberId	Long		—	会员用户Id
order.orderType	OrderType	1订单类型(枚举:order.OrderType)，1景区套票，2酒店民宿，3餐饮美食，4美食特产，5自驾路线，6非遗专区，7旅游卡2酒店民宿3餐饮美食4美食特产5自驾路线6非遗专区7旅游卡8旅游卡	—	订单类型(枚举:order.OrderType)，1旅游年卡，2美食特产，3生活好物，4自驾路线，5非遗专区，6景区套票，7酒店民宿，8餐饮美食
order.orderSource	OrderSource	1订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP2微信小程序3支付宝小程序4安卓APP5IOSAPP6YOUZHENG7XIANGGONGHUI8XIANGYUEMA+14	—	订单来源(枚举:order.OrderSource)，1H5，2微信小程序，3支付宝小程序，4安卓APP，5IOSAPP
order.buyNum	Integer		—	购买份数
order.orderAmount	Integer		—	订单金额(订单原始金额)
order.receivableAmount	Integer		—	应收金额
order.payableAmount	Integer		—	实收金额
order.reducedPrice	Integer		—	优惠金额
order.expressAmount	Integer		—	运费金额
order.discountAmount	Integer		—	折扣金额
order.isDelivery	Integer		—	是否配送(0=否；1=是)
order.payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	—	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
order.orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	—	订单状态(枚举:order.OrderStatus)，1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消
order.orderPhone	String		—	下单人手机
order.orderRemark	String		—	订单备注
order.orderTime	Date		—	下单时间
order.orderExpressTime	Date		—	订单失效时间
order.isSendIntegral	Integer		—	订单积分是否已发放(0=否 1=是)
order.isComment	Integer		—	订单是否已经评价(0=否；1=是)
order.isProfitSharing	Integer		—	订单资金是否已冻结(0=已冻结 1=已解冻)
order.isSendCommission	SendCommission	0订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金1是2无佣金	—	订单佣金是否已发放(枚举:order.SendCommission)，0=否 1=是 2=无佣金
order.icode	String		—	分销邀请码
order.shouldReturnCommission	Integer		—	应返佣金
order.reallyReturnCommission	Integer		—	实返佣金
order.createdBy	String		—	创建人id
order.createdTime	LocalDateTime		—	创建时间
order.updatedBy	String		—	更新人id
order.updatedTime	LocalDateTime		—	更新时间

示例

请求示例（自动生成，仅结构参考）

POST /cqy/queryOpenapiCqyRecordPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "orgId": "",
    "mobile": "13800000000",
    "userName": "",
    "actName": "",
    "couponType": "",
    "couponNumber": "",
    "couponStatus": 0,
    "amount": "",
    "getTime": "2026-01-01 12:00:00",
    "consumeTime": "2026-01-01 12:00:00",
    "orderId": "",
    "goodsId": 1,
    "goodsName": "",
    "createTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orgId": "",
        "mobile": "13800000000",
        "userName": "",
        "actName": "",
        "couponType": "",
        "couponNumber": "",
        "couponStatus": 0,
        "amount": "",
        "getTime": "2026-01-01 12:00:00",
        "consumeTime": "2026-01-01 12:00:00",
        "orderId": "",
        "goodsId": 1,
        "goodsName": "",
        "createTime": "2026-01-01 12:00:00",
        "updateTime": "2026-01-01 12:00:00",
        "remark": "",
        "checkerId": 1,
        "checkerName": "",
        "order": {
          "id": 1,
          "orderId": 1,
          "merchantId": 1,
          "shopId": 1,
          "memberId": 1,
          "orderType": "1",
          "orderSource": "1",
          "buyNum": 0,
          "orderAmount": 0,
          "receivableAmount": 0,
          "payableAmount": 0,
          "reducedPrice": 0,
          "expressAmount": 0,
          "discountAmount": 0,
          "isDelivery": 0,
          "payStatus": "1",
          "orderStatus": "1",
          "orderPhone": "13800000000",
          "orderRemark": "",
          "orderTime": "2026-01-01 12:00:00",
          "orderExpressTime": "2026-01-01 12:00:00",
          "isSendIntegral": 0,
          "isComment": 0,
          "isProfitSharing": 0,
          "isSendCommission": "0",
          "icode": "",
          "shouldReturnCommission": 0,
          "reallyReturnCommission": 0,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiCqyRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryCqyRecordPage exact

POST /cqy/refund 在用管理后台 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#refundOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表ordermember

ControllerOpenapiCqyRecordController#refundOrder

ServiceOpenapiCqyRecordService#refundCqy （OpenapiCqyRecordServiceImpl）

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

TradeClientService.refund

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/refund
uat	https://dscp-uat.hn12301.net/manage-api/cqy/refund
pro	https://dscp-uat.hn12301.net/manage-api/cqy/refund	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
orderNo	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghResponse　（object）

字段	类型	表 / 列
accessToken	String	—
code	Integer	—
message	String	—
isMember	boolean	—
memberLevelType	String	—

示例

请求示例（自动生成，仅结构参考）

POST /cqy/refund

{
  "body": {
    "orderNo": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "accessToken": "",
    "code": 0,
    "message": "",
    "isMember": false,
    "memberLevelType": ""
  }
}

处理逻辑

逻辑摘要调用 refundCqy（openapiCqyRecordService.refundCqy）

前端调用方

xghmall cqyRefund exact

POST /cqy/refundWx 未使用管理后台 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#refundWx
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表ordermember

ControllerOpenapiCqyRecordController#refundWx

ServiceOpenapiCqyRecordService#refundWx （OpenapiCqyRecordServiceImpl）

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

LockService.tryLockWechatJsapiRefundService.refundLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/refundWx
uat	https://dscp-uat.hn12301.net/manage-api/cqy/refundWx
pro	https://dscp-uat.hn12301.net/manage-api/cqy/refundWx	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
orderNo	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cqy/refundWx

{
  "body": {
    "orderNo": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 refundWx（openapiCqyRecordService.refundWx）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /cqy/statCqyCheck 在用开放/回调 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#statCqyCheck
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#statCqyCheck

MapperOpenapiCqyRecordMapper#statCqyCheck ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/cqy/statCqyCheck
uat	https://dscp-uat.hn12301.net/open-api/cqy/statCqyCheck
pro	https://dscp-uat.hn12301.net/open-api/cqy/statCqyCheck	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ConsumeEndStatRequest

字段	类型	必填	表 / 列	说明
pageNum	Integer	否	—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否	—	每页条数（继承自框架分页基类 AbstractPageRequest）
checkerId	Long		`openapi_cqy_record`.`checker_id`
cardModelId	Long		—
ticketsId	Long		—
goodsId	Long		`openapi_cqy_record`.`goods_id`
dateRange	Date[]		—
statType	Integer		—	1=全部数据 2=按日统计 3=按月统计 4=按年统计

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ConsumeEndStatResponse　（object）

字段	类型	表 / 列
totalTimes	Integer	—
totalTourists	Integer	—
cardCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardCheckPageData[].dateRange	String	—
cardCheckPageData[].totalTimes	Integer	—
cardCheckPageData[].totalTourists	Integer	—
cardAppointmentPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cardAppointmentPageData[].dateRange	String	—
cardAppointmentPageData[].totalTimes	Integer	—
cardAppointmentPageData[].totalTourists	Integer	—
ticketsCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
ticketsCheckPageData[].dateRange	String	—
ticketsCheckPageData[].totalTimes	Integer	—
ticketsCheckPageData[].totalTourists	Integer	—
cqyCheckPageData	PageInfo<ConsumeEndStatCardCheckResponse>	—
cqyCheckPageData[].dateRange	String	—
cqyCheckPageData[].totalTimes	Integer	—
cqyCheckPageData[].totalTourists	Integer	—

示例

请求示例（自动生成，仅结构参考）

POST /cqy/statCqyCheck

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "checkerId": 1,
    "cardModelId": 1,
    "ticketsId": 1,
    "goodsId": 1,
    "dateRange": "2026-01-01 12:00:00",
    "statType": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "totalTimes": 0,
    "totalTourists": 0,
    "cardCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cardAppointmentPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "ticketsCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ],
    "cqyCheckPageData": [
      {
        "dateRange": "2026-01-01 12:00:00",
        "totalTimes": 0,
        "totalTourists": 0
      }
    ]
  }
}

处理逻辑

逻辑摘要调用 statCqyCheck（openapiCqyRecordMapper.statCqyCheck）

内联注释

如果起始索引超出了列表范围，返回空列表

前端调用方

writeoff statCqyCheck exact

POST /cqy/syncCqyRecord 在用管理后台 #

（无摘要） · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#syncCqyRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOpenapiCqyRecordController#syncCqyRecord

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

OpenapiCqyRecordService.syncCoupon

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/syncCqyRecord
uat	https://dscp-uat.hn12301.net/manage-api/cqy/syncCqyRecord
pro	https://dscp-uat.hn12301.net/manage-api/cqy/syncCqyRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CqyThirdRequest

字段	类型	表 / 列	说明
startTime	Date	—	开始时间
endTime	Date	—	结束时间
orgId	String	—	单位ID
realname	String	—	姓名
mobile	String	—	手机号
actName	String	—	活动名称
cardType	String	—	余额券类型
cardNo	String	—	余额券号
flkState	String	—	卡状态
getTime	Date	—
goodsId	Long	—
amount	String	—	累计发放金额
pageNo	Integer	—
pageSize	Integer	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cqy/syncCqyRecord

{
  "body": {
    "startTime": "2026-01-01 12:00:00",
    "endTime": "2026-01-01 12:00:00",
    "orgId": "",
    "realname": "",
    "mobile": "13800000000",
    "actName": "",
    "cardType": "",
    "cardNo": "",
    "flkState": "",
    "getTime": "2026-01-01 12:00:00",
    "goodsId": 1,
    "amount": "",
    "pageNo": 0,
    "pageSize": 0
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 syncCoupon（openapiCqyRecordService.syncCoupon）

前端调用方

dscp-html-manage syncCqyRecord exact

POST /cqy/updateOpenapiCqyRecord 未使用管理后台 #

春秋游记录-更新 · OpenapiCqyRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiCqyRecordController#updateOpenapiCqyRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_cqy_record

ControllerOpenapiCqyRecordController#updateOpenapiCqyRecord

转换BeanUtils.map → OpenapiCqyRecord ⇒ 表 openapi_cqy_record

ServiceOpenapiCqyRecordService#update （OpenapiCqyRecordServiceImpl）

MapperOpenapiCqyRecordMapper#updateById ⇒ 表 openapi_cqy_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/cqy/updateOpenapiCqyRecord
uat	https://dscp-uat.hn12301.net/manage-api/cqy/updateOpenapiCqyRecord
pro	https://dscp-uat.hn12301.net/manage-api/cqy/updateOpenapiCqyRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiCqyRecordUpdateRequest

字段	类型	表 / 列	说明
id	Long	`openapi_cqy_record`.`id`	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	`openapi_cqy_record`.`coupon_status`	券状态 0=领取失败 1=领取成功 2=退票 3=核销成功
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	`openapi_cqy_record`.`goods_id`	产品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	`openapi_cqy_record`.`checker_id`	核销人id
checkerName	String	`openapi_cqy_record`.`checker_name`	核销人员姓名

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /cqy/updateOpenapiCqyRecord

{
  "body": {
    "id": 1,
    "orgId": "",
    "mobile": "13800000000",
    "userName": "",
    "actName": "",
    "couponType": "",
    "couponNumber": "",
    "couponStatus": 0,
    "amount": "",
    "getTime": "2026-01-01 12:00:00",
    "consumeTime": "2026-01-01 12:00:00",
    "orderId": "",
    "goodsId": 1,
    "goodsName": "",
    "createTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiCqyRecordService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiIcbcLogController 0/6 在用

POST /openapi/addOpenapiIcbcLog 未使用管理后台 #

工行-阳明山记录-新增 · OpenapiIcbcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiIcbcLogController#addOpenapiIcbcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_icbc_log

ControllerOpenapiIcbcLogController#addOpenapiIcbcLog

转换BeanUtils.map → OpenapiIcbcLog ⇒ 表 openapi_icbc_log

ServiceOpenapiIcbcLogService#add （OpenapiIcbcLogServiceImpl）

MapperOpenapiIcbcLogMapper#insert ⇒ 表 openapi_icbc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiIcbcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiIcbcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiIcbcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiIcbcLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiIcbcLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiIcbcLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiIcbcLog 未使用管理后台 #

工行-阳明山记录-删除 · OpenapiIcbcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiIcbcLogController#deleteOpenapiIcbcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_icbc_log

ControllerOpenapiIcbcLogController#deleteOpenapiIcbcLog

ServiceOpenapiIcbcLogService#delete （OpenapiIcbcLogServiceImpl）

MapperOpenapiIcbcLogMapper#deleteById ⇒ 表 openapi_icbc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiIcbcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiIcbcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiIcbcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_icbc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiIcbcLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiIcbcLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiIcbcLog 未使用管理后台 #

工行-阳明山记录-详情 · OpenapiIcbcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiIcbcLogController#getOpenapiIcbcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_icbc_log

ControllerOpenapiIcbcLogController#getOpenapiIcbcLog

ServiceOpenapiIcbcLogService#get （OpenapiIcbcLogServiceImpl）

MapperOpenapiIcbcLogMapper#selectById ⇒ 表 openapi_icbc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiIcbcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiIcbcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiIcbcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_icbc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiIcbcLogResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_icbc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiIcbcLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiIcbcLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiIcbcLogList 未使用管理后台 #

工行-阳明山记录-列表查询 · OpenapiIcbcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiIcbcLogController#queryOpenapiIcbcLogList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_icbc_log

ControllerOpenapiIcbcLogController#queryOpenapiIcbcLogList

转换BeanUtils.map → OpenapiIcbcLogQuery

ServiceOpenapiIcbcLogService#queryList （OpenapiIcbcLogServiceImpl）

MapperOpenapiIcbcLogMapper#selectList ⇒ 表 openapi_icbc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiIcbcLogList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiIcbcLogList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiIcbcLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiIcbcLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiIcbcLogResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_icbc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiIcbcLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiIcbcLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiIcbcLogPage 未使用管理后台 #

工行-阳明山记录-分页查询 · OpenapiIcbcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiIcbcLogController#queryOpenapiIcbcLogPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_icbc_log

ControllerOpenapiIcbcLogController#queryOpenapiIcbcLogPage

转换BeanUtils.map → OpenapiIcbcLogQuery

ServiceOpenapiIcbcLogService#queryPage （OpenapiIcbcLogServiceImpl）

MapperOpenapiIcbcLogMapper#selectPage ⇒ 表 openapi_icbc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiIcbcLogPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiIcbcLogPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiIcbcLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiIcbcLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiIcbcLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_icbc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiIcbcLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiIcbcLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiIcbcLog 未使用管理后台 #

工行-阳明山记录-更新 · OpenapiIcbcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiIcbcLogController#updateOpenapiIcbcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_icbc_log

ControllerOpenapiIcbcLogController#updateOpenapiIcbcLog

转换BeanUtils.map → OpenapiIcbcLog ⇒ 表 openapi_icbc_log

ServiceOpenapiIcbcLogService#update （OpenapiIcbcLogServiceImpl）

MapperOpenapiIcbcLogMapper#updateById ⇒ 表 openapi_icbc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiIcbcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiIcbcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiIcbcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiIcbcLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_icbc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiIcbcLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiIcbcLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiLogController 0/6 在用

POST /openapiLog/addOpenapiLog 未使用管理后台 #

第三方接口调用记录了表-新增 · OpenapiLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiLogController#addOpenapiLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_log

ControllerOpenapiLogController#addOpenapiLog

转换BeanUtils.map → OpenapiLog ⇒ 表 openapi_log

ServiceOpenapiLogService#add （OpenapiLogServiceImpl）

MapperOpenapiLogMapper#insert ⇒ 表 openapi_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiLog/addOpenapiLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiLog/addOpenapiLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiLog/addOpenapiLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiLog/addOpenapiLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiLog/deleteOpenapiLog 未使用管理后台 #

第三方接口调用记录了表-删除 · OpenapiLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiLogController#deleteOpenapiLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_log

ControllerOpenapiLogController#deleteOpenapiLog

ServiceOpenapiLogService#delete （OpenapiLogServiceImpl）

MapperOpenapiLogMapper#deleteById ⇒ 表 openapi_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiLog/deleteOpenapiLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiLog/deleteOpenapiLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiLog/deleteOpenapiLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiLog/deleteOpenapiLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiLog/getOpenapiLog 未使用管理后台 #

第三方接口调用记录了表-详情 · OpenapiLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiLogController#getOpenapiLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_log

ControllerOpenapiLogController#getOpenapiLog

ServiceOpenapiLogService#get （OpenapiLogServiceImpl）

MapperOpenapiLogMapper#selectById ⇒ 表 openapi_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiLog/getOpenapiLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiLog/getOpenapiLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiLog/getOpenapiLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiLogResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiLog/getOpenapiLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiLog/queryOpenapiLogList 未使用管理后台 #

第三方接口调用记录了表-列表查询 · OpenapiLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiLogController#queryOpenapiLogList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_log

ControllerOpenapiLogController#queryOpenapiLogList

转换BeanUtils.map → OpenapiLogQuery

ServiceOpenapiLogService#queryList （OpenapiLogServiceImpl）

MapperOpenapiLogMapper#selectList ⇒ 表 openapi_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiLog/queryOpenapiLogList
uat	https://dscp-uat.hn12301.net/manage-api/openapiLog/queryOpenapiLogList
pro	https://dscp-uat.hn12301.net/manage-api/openapiLog/queryOpenapiLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiLogResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiLog/queryOpenapiLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiLog/queryOpenapiLogPage 未使用管理后台 #

第三方接口调用记录了表-分页查询 · OpenapiLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiLogController#queryOpenapiLogPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_log

ControllerOpenapiLogController#queryOpenapiLogPage

转换BeanUtils.map → OpenapiLogQuery

ServiceOpenapiLogService#queryPage （OpenapiLogServiceImpl）

MapperOpenapiLogMapper#selectPage ⇒ 表 openapi_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiLog/queryOpenapiLogPage
uat	https://dscp-uat.hn12301.net/manage-api/openapiLog/queryOpenapiLogPage
pro	https://dscp-uat.hn12301.net/manage-api/openapiLog/queryOpenapiLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapiLog/queryOpenapiLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapiLog/updateOpenapiLog 未使用管理后台 #

第三方接口调用记录了表-更新 · OpenapiLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiLogController#updateOpenapiLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_log

ControllerOpenapiLogController#updateOpenapiLog

转换BeanUtils.map → OpenapiLog ⇒ 表 openapi_log

ServiceOpenapiLogService#update （OpenapiLogServiceImpl）

MapperOpenapiLogMapper#updateById ⇒ 表 openapi_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapiLog/updateOpenapiLog
uat	https://dscp-uat.hn12301.net/manage-api/openapiLog/updateOpenapiLog
pro	https://dscp-uat.hn12301.net/manage-api/openapiLog/updateOpenapiLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapiLog/updateOpenapiLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiNydmOrderController 0/6 在用

POST /openapi/addOpenapiNydmOrder 未使用管理后台 #

南岳大庙订单-新增 · OpenapiNydmOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiNydmOrderController#addOpenapiNydmOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_nydm_order

ControllerOpenapiNydmOrderController#addOpenapiNydmOrder

转换BeanUtils.map → OpenapiNydmOrder ⇒ 表 openapi_nydm_order

ServiceOpenapiNydmOrderService#add （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#insert ⇒ 表 openapi_nydm_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiNydmOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiNydmOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiNydmOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiNydmOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiNydmOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiNydmOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiNydmOrder 未使用管理后台 #

南岳大庙订单-删除 · OpenapiNydmOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiNydmOrderController#deleteOpenapiNydmOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_nydm_order

ControllerOpenapiNydmOrderController#deleteOpenapiNydmOrder

ServiceOpenapiNydmOrderService#delete （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#deleteById ⇒ 表 openapi_nydm_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiNydmOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiNydmOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiNydmOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_nydm_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiNydmOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiNydmOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiNydmOrder 未使用管理后台 #

南岳大庙订单-详情 · OpenapiNydmOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiNydmOrderController#getOpenapiNydmOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_nydm_order

ControllerOpenapiNydmOrderController#getOpenapiNydmOrder

ServiceOpenapiNydmOrderService#get （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#selectById ⇒ 表 openapi_nydm_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiNydmOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiNydmOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiNydmOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_nydm_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiNydmOrderResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_nydm_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiNydmOrder

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiNydmOrderService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiNydmOrderList 未使用管理后台 #

南岳大庙订单-列表查询 · OpenapiNydmOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiNydmOrderController#queryOpenapiNydmOrderList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_nydm_order

ControllerOpenapiNydmOrderController#queryOpenapiNydmOrderList

转换BeanUtils.map → OpenapiNydmOrderQuery

ServiceOpenapiNydmOrderService#queryList （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#selectList ⇒ 表 openapi_nydm_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiNydmOrderList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiNydmOrderList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiNydmOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiNydmOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiNydmOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_nydm_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiNydmOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiNydmOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiNydmOrderPage 未使用管理后台 #

南岳大庙订单-分页查询 · OpenapiNydmOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiNydmOrderController#queryOpenapiNydmOrderPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_nydm_order

ControllerOpenapiNydmOrderController#queryOpenapiNydmOrderPage

转换BeanUtils.map → OpenapiNydmOrderQuery

ServiceOpenapiNydmOrderService#queryPage （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#selectPage ⇒ 表 openapi_nydm_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiNydmOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiNydmOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiNydmOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiNydmOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiNydmOrderResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_nydm_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiNydmOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiNydmOrderService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiNydmOrder 未使用管理后台 #

南岳大庙订单-更新 · OpenapiNydmOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiNydmOrderController#updateOpenapiNydmOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_nydm_order

ControllerOpenapiNydmOrderController#updateOpenapiNydmOrder

转换BeanUtils.map → OpenapiNydmOrder ⇒ 表 openapi_nydm_order

ServiceOpenapiNydmOrderService#update （OpenapiNydmOrderServiceImpl）

MapperOpenapiNydmOrderMapper#updateById ⇒ 表 openapi_nydm_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiNydmOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiNydmOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiNydmOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiNydmOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_nydm_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiNydmOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiNydmOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiPftRecordController 0/6 在用

POST /pft/addOpenapiPftRecord 未使用管理后台 #

票付通记录-新增 · OpenapiPftRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#addOpenapiPftRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pft_record

ControllerOpenapiPftRecordController#addOpenapiPftRecord

转换BeanUtils.map → OpenapiPftRecord ⇒ 表 openapi_pft_record

ServiceOpenapiPftRecordService#add （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#insert ⇒ 表 openapi_pft_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pft/addOpenapiPftRecord
uat	https://dscp-uat.hn12301.net/manage-api/pft/addOpenapiPftRecord
pro	https://dscp-uat.hn12301.net/manage-api/pft/addOpenapiPftRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPftRecordAddRequest

字段	类型	表 / 列	说明
appointId	Long	`openapi_pft_record`.`appoint_id`	名称
tid	String	`openapi_pft_record`.`tid`	门票id
tnum	String	`openapi_pft_record`.`tnum`	购买数量
playtime	String	`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String	`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String	`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String	`openapi_pft_record`.`ordername`	游客姓名
m	String	`openapi_pft_record`.`m`	供应商 id
personid	String	`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String	`openapi_pft_record`.`paymode`	支付方式
tprice	String	`openapi_pft_record`.`tprice`	结算价
series	String	`openapi_pft_record`.`series`	演出信息
remotenum	String	`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String	`openapi_pft_record`.`ordernum`	票付通订单号
code	String	`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String	`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String	`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String	`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date	`openapi_pft_record`.`order_time`	创建日期
updateTime	Date	`openapi_pft_record`.`update_time`	更新时间
remark	String	`openapi_pft_record`.`remark`
checkerId	Long	`openapi_pft_record`.`checker_id`	核销员id
checkerName	String	`openapi_pft_record`.`checker_name`	核销员名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pft/addOpenapiPftRecord

{
  "body": {
    "appointId": 1,
    "tid": "",
    "tnum": "",
    "playtime": "2026-01-01 12:00:00",
    "ordertel": "",
    "contacttel": "",
    "ordername": "",
    "m": "",
    "personid": "",
    "paymode": "",
    "tprice": "",
    "series": "",
    "remotenum": "",
    "ordernum": "",
    "code": "",
    "qrcodeurl": "https://example.com/x.png",
    "qrcodeimg": "https://example.com/x.png",
    "ustatus": "",
    "orderTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiPftRecordService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pft/deleteOpenapiPftRecord 未使用管理后台 #

票付通记录-删除 · OpenapiPftRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#deleteOpenapiPftRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pft_record

ControllerOpenapiPftRecordController#deleteOpenapiPftRecord

ServiceOpenapiPftRecordService#delete （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#deleteById ⇒ 表 openapi_pft_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pft/deleteOpenapiPftRecord
uat	https://dscp-uat.hn12301.net/manage-api/pft/deleteOpenapiPftRecord
pro	https://dscp-uat.hn12301.net/manage-api/pft/deleteOpenapiPftRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_pft_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pft/deleteOpenapiPftRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiPftRecordService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pft/getOpenapiPftRecord 未使用管理后台 #

票付通记录-详情 · OpenapiPftRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#getOpenapiPftRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pft_record

ControllerOpenapiPftRecordController#getOpenapiPftRecord

ServiceOpenapiPftRecordService#get （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#selectById ⇒ 表 openapi_pft_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pft/getOpenapiPftRecord
uat	https://dscp-uat.hn12301.net/manage-api/pft/getOpenapiPftRecord
pro	https://dscp-uat.hn12301.net/manage-api/pft/getOpenapiPftRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_pft_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiPftRecordResponse　（object）

字段	类型	表 / 列	说明
id	Long	`openapi_pft_record`.`id`	id
appointId	Long	`openapi_pft_record`.`appoint_id`
tid	String	`openapi_pft_record`.`tid`	门票id
tnum	String	`openapi_pft_record`.`tnum`	购买数量
playtime	String	`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String	`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String	`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String	`openapi_pft_record`.`ordername`	游客姓名
m	String	`openapi_pft_record`.`m`	供应商 id
personid	String	`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String	`openapi_pft_record`.`paymode`	支付方式
tprice	String	`openapi_pft_record`.`tprice`	结算价
series	String	`openapi_pft_record`.`series`	演出信息
remotenum	String	`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String	`openapi_pft_record`.`ordernum`	票付通订单号
code	String	`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String	`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String	`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String	`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date	`openapi_pft_record`.`order_time`	创建日期
updateTime	Date	`openapi_pft_record`.`update_time`	更新时间
remark	String	`openapi_pft_record`.`remark`
checkerId	Long	`openapi_pft_record`.`checker_id`	核销员id
checkerName	String	`openapi_pft_record`.`checker_name`	核销员名称

示例

请求示例（自动生成，仅结构参考）

POST /pft/getOpenapiPftRecord

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "appointId": 1,
    "tid": "",
    "tnum": "",
    "playtime": "2026-01-01 12:00:00",
    "ordertel": "",
    "contacttel": "",
    "ordername": "",
    "m": "",
    "personid": "",
    "paymode": "",
    "tprice": "",
    "series": "",
    "remotenum": "",
    "ordernum": "",
    "code": "",
    "qrcodeurl": "https://example.com/x.png",
    "qrcodeimg": "https://example.com/x.png",
    "ustatus": "",
    "orderTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

处理逻辑

逻辑摘要查询详情（openapiPftRecordService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pft/queryOpenapiPftRecordList 未使用管理后台 #

票付通记录-列表查询 · OpenapiPftRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#queryOpenapiPftRecordList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pft_record

ControllerOpenapiPftRecordController#queryOpenapiPftRecordList

转换BeanUtils.map → OpenapiPftRecordQuery

ServiceOpenapiPftRecordService#queryList （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#selectList ⇒ 表 openapi_pft_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pft/queryOpenapiPftRecordList
uat	https://dscp-uat.hn12301.net/manage-api/pft/queryOpenapiPftRecordList
pro	https://dscp-uat.hn12301.net/manage-api/pft/queryOpenapiPftRecordList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPftRecordListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
appointId	Long			`openapi_pft_record`.`appoint_id`
tid	String			`openapi_pft_record`.`tid`	门票id
tnum	String			`openapi_pft_record`.`tnum`	购买数量
playtime	String			`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String			`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String			`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String			`openapi_pft_record`.`ordername`	游客姓名
m	String			`openapi_pft_record`.`m`	供应商 id
personid	String			`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String			`openapi_pft_record`.`paymode`	支付方式
tprice	String			`openapi_pft_record`.`tprice`	结算价
series	String			`openapi_pft_record`.`series`	演出信息
remotenum	String			`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String			`openapi_pft_record`.`ordernum`	票付通订单号
code	String			`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String			`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String			`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String			`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date			`openapi_pft_record`.`order_time`	创建日期
updateTime	Date			`openapi_pft_record`.`update_time`	更新时间
remark	String			`openapi_pft_record`.`remark`
checkerId	Long			`openapi_pft_record`.`checker_id`	核销员id
checkerName	String			`openapi_pft_record`.`checker_name`	核销员名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiPftRecordResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`openapi_pft_record`.`id`	id
appointId	Long	`openapi_pft_record`.`appoint_id`
tid	String	`openapi_pft_record`.`tid`	门票id
tnum	String	`openapi_pft_record`.`tnum`	购买数量
playtime	String	`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String	`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String	`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String	`openapi_pft_record`.`ordername`	游客姓名
m	String	`openapi_pft_record`.`m`	供应商 id
personid	String	`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String	`openapi_pft_record`.`paymode`	支付方式
tprice	String	`openapi_pft_record`.`tprice`	结算价
series	String	`openapi_pft_record`.`series`	演出信息
remotenum	String	`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String	`openapi_pft_record`.`ordernum`	票付通订单号
code	String	`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String	`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String	`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String	`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date	`openapi_pft_record`.`order_time`	创建日期
updateTime	Date	`openapi_pft_record`.`update_time`	更新时间
remark	String	`openapi_pft_record`.`remark`
checkerId	Long	`openapi_pft_record`.`checker_id`	核销员id
checkerName	String	`openapi_pft_record`.`checker_name`	核销员名称

示例

请求示例（自动生成，仅结构参考）

POST /pft/queryOpenapiPftRecordList

{
  "body": {
    "keywords": "",
    "appointId": 1,
    "tid": "",
    "tnum": "",
    "playtime": "2026-01-01 12:00:00",
    "ordertel": "",
    "contacttel": "",
    "ordername": "",
    "m": "",
    "personid": "",
    "paymode": "",
    "tprice": "",
    "series": "",
    "remotenum": "",
    "ordernum": "",
    "code": "",
    "qrcodeurl": "https://example.com/x.png",
    "qrcodeimg": "https://example.com/x.png",
    "ustatus": "",
    "orderTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "appointId": 1,
      "tid": "",
      "tnum": "",
      "playtime": "2026-01-01 12:00:00",
      "ordertel": "",
      "contacttel": "",
      "ordername": "",
      "m": "",
      "personid": "",
      "paymode": "",
      "tprice": "",
      "series": "",
      "remotenum": "",
      "ordernum": "",
      "code": "",
      "qrcodeurl": "https://example.com/x.png",
      "qrcodeimg": "https://example.com/x.png",
      "ustatus": "",
      "orderTime": "2026-01-01 12:00:00",
      "updateTime": "2026-01-01 12:00:00",
      "remark": "",
      "checkerId": 1,
      "checkerName": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiPftRecordService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pft/queryOpenapiPftRecordPage 未使用管理后台 #

票付通记录-分页查询 · OpenapiPftRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#queryOpenapiPftRecordPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pft_record

ControllerOpenapiPftRecordController#queryOpenapiPftRecordPage

转换BeanUtils.map → OpenapiPftRecordQuery

ServiceOpenapiPftRecordService#queryPage （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#selectPage ⇒ 表 openapi_pft_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pft/queryOpenapiPftRecordPage
uat	https://dscp-uat.hn12301.net/manage-api/pft/queryOpenapiPftRecordPage
pro	https://dscp-uat.hn12301.net/manage-api/pft/queryOpenapiPftRecordPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPftRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
appointId	Long			`openapi_pft_record`.`appoint_id`
tid	String			`openapi_pft_record`.`tid`	门票id
tnum	String			`openapi_pft_record`.`tnum`	购买数量
playtime	String			`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String			`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String			`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String			`openapi_pft_record`.`ordername`	游客姓名
m	String			`openapi_pft_record`.`m`	供应商 id
personid	String			`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String			`openapi_pft_record`.`paymode`	支付方式
tprice	String			`openapi_pft_record`.`tprice`	结算价
series	String			`openapi_pft_record`.`series`	演出信息
remotenum	String			`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String			`openapi_pft_record`.`ordernum`	票付通订单号
code	String			`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String			`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String			`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String			`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date			`openapi_pft_record`.`order_time`	创建日期
updateTime	Date			`openapi_pft_record`.`update_time`	更新时间
remark	String			`openapi_pft_record`.`remark`
checkerId	Long			`openapi_pft_record`.`checker_id`	核销员id
checkerName	String			`openapi_pft_record`.`checker_name`	核销员名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiPftRecordResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_pft_record`.`id`	id
appointId	Long	`openapi_pft_record`.`appoint_id`
tid	String	`openapi_pft_record`.`tid`	门票id
tnum	String	`openapi_pft_record`.`tnum`	购买数量
playtime	String	`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String	`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String	`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String	`openapi_pft_record`.`ordername`	游客姓名
m	String	`openapi_pft_record`.`m`	供应商 id
personid	String	`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String	`openapi_pft_record`.`paymode`	支付方式
tprice	String	`openapi_pft_record`.`tprice`	结算价
series	String	`openapi_pft_record`.`series`	演出信息
remotenum	String	`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String	`openapi_pft_record`.`ordernum`	票付通订单号
code	String	`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String	`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String	`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String	`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date	`openapi_pft_record`.`order_time`	创建日期
updateTime	Date	`openapi_pft_record`.`update_time`	更新时间
remark	String	`openapi_pft_record`.`remark`
checkerId	Long	`openapi_pft_record`.`checker_id`	核销员id
checkerName	String	`openapi_pft_record`.`checker_name`	核销员名称

示例

请求示例（自动生成，仅结构参考）

POST /pft/queryOpenapiPftRecordPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "appointId": 1,
    "tid": "",
    "tnum": "",
    "playtime": "2026-01-01 12:00:00",
    "ordertel": "",
    "contacttel": "",
    "ordername": "",
    "m": "",
    "personid": "",
    "paymode": "",
    "tprice": "",
    "series": "",
    "remotenum": "",
    "ordernum": "",
    "code": "",
    "qrcodeurl": "https://example.com/x.png",
    "qrcodeimg": "https://example.com/x.png",
    "ustatus": "",
    "orderTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "appointId": 1,
        "tid": "",
        "tnum": "",
        "playtime": "2026-01-01 12:00:00",
        "ordertel": "",
        "contacttel": "",
        "ordername": "",
        "m": "",
        "personid": "",
        "paymode": "",
        "tprice": "",
        "series": "",
        "remotenum": "",
        "ordernum": "",
        "code": "",
        "qrcodeurl": "https://example.com/x.png",
        "qrcodeimg": "https://example.com/x.png",
        "ustatus": "",
        "orderTime": "2026-01-01 12:00:00",
        "updateTime": "2026-01-01 12:00:00",
        "remark": "",
        "checkerId": 1,
        "checkerName": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiPftRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pft/updateOpenapiPftRecord 未使用管理后台 #

票付通记录-更新 · OpenapiPftRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPftRecordController#updateOpenapiPftRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pft_record

ControllerOpenapiPftRecordController#updateOpenapiPftRecord

转换BeanUtils.map → OpenapiPftRecord ⇒ 表 openapi_pft_record

ServiceOpenapiPftRecordService#update （OpenapiPftRecordServiceImpl）

MapperOpenapiPftRecordMapper#updateById ⇒ 表 openapi_pft_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pft/updateOpenapiPftRecord
uat	https://dscp-uat.hn12301.net/manage-api/pft/updateOpenapiPftRecord
pro	https://dscp-uat.hn12301.net/manage-api/pft/updateOpenapiPftRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPftRecordUpdateRequest

字段	类型	表 / 列	说明
id	Long	`openapi_pft_record`.`id`	id
appointId	Long	`openapi_pft_record`.`appoint_id`
tid	String	`openapi_pft_record`.`tid`	门票id
tnum	String	`openapi_pft_record`.`tnum`	购买数量
playtime	String	`openapi_pft_record`.`playtime`	游玩日期格式：Y-m-d
ordertel	String	`openapi_pft_record`.`ordertel`	取票人手机号
contacttel	String	`openapi_pft_record`.`contacttel`	游玩人手机号
ordername	String	`openapi_pft_record`.`ordername`	游客姓名
m	String	`openapi_pft_record`.`m`	供应商 id
personid	String	`openapi_pft_record`.`personid`	游客身份证-证件号 + : + 类型
paymode	String	`openapi_pft_record`.`paymode`	支付方式
tprice	String	`openapi_pft_record`.`tprice`	结算价
series	String	`openapi_pft_record`.`series`	演出信息
remotenum	String	`openapi_pft_record`.`remotenum`	贵方订单号
ordernum	String	`openapi_pft_record`.`ordernum`	票付通订单号
code	String	`openapi_pft_record`.`code`	凭证码/消费码
qrcodeurl	String	`openapi_pft_record`.`qrcodeurl`	订单详情链接
qrcodeimg	String	`openapi_pft_record`.`qrcodeimg`	二维码图片
ustatus	String	`openapi_pft_record`.`ustatus`	订单状态：0=未使用,1=已使用,2=已过期,3=被取消,4=待确认(酒店)，待收货(特产),5=被终端修改,6=被终端撤销,7=部分使用,8=订单完结,9=被删除,11=待出票
orderTime	Date	`openapi_pft_record`.`order_time`	创建日期
updateTime	Date	`openapi_pft_record`.`update_time`	更新时间
remark	String	`openapi_pft_record`.`remark`
checkerId	Long	`openapi_pft_record`.`checker_id`	核销员id
checkerName	String	`openapi_pft_record`.`checker_name`	核销员名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pft/updateOpenapiPftRecord

{
  "body": {
    "id": 1,
    "appointId": 1,
    "tid": "",
    "tnum": "",
    "playtime": "2026-01-01 12:00:00",
    "ordertel": "",
    "contacttel": "",
    "ordername": "",
    "m": "",
    "personid": "",
    "paymode": "",
    "tprice": "",
    "series": "",
    "remotenum": "",
    "ordernum": "",
    "code": "",
    "qrcodeurl": "https://example.com/x.png",
    "qrcodeimg": "https://example.com/x.png",
    "ustatus": "",
    "orderTime": "2026-01-01 12:00:00",
    "updateTime": "2026-01-01 12:00:00",
    "remark": "",
    "checkerId": 1,
    "checkerName": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiPftRecordService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiPinganRecordController 2/6 在用

POST /pingan/addOpenapiPinganRecord 未使用管理后台 #

平安投保记录-新增 · OpenapiPinganRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPinganRecordController#addOpenapiPinganRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pingan_record

ControllerOpenapiPinganRecordController#addOpenapiPinganRecord

转换BeanUtils.map → OpenapiPinganRecord ⇒ 表 openapi_pingan_record

ServiceOpenapiPinganRecordService#add （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#insert ⇒ 表 openapi_pingan_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingan/addOpenapiPinganRecord
uat	https://dscp-uat.hn12301.net/manage-api/pingan/addOpenapiPinganRecord
pro	https://dscp-uat.hn12301.net/manage-api/pingan/addOpenapiPinganRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPinganRecordAddRequest

字段	类型	取值/校验	表 / 列	说明
cardNo	String		`openapi_pingan_record`.`card_no`	名称
name	String		`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`openapi_pingan_record`.`identity_no`	身份证号码
phone	String		`openapi_pingan_record`.`phone`	手机号码
applyNum	String		`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String		`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String		`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String		`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String		`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String		`openapi_pingan_record`.`birthday`	出生年月
sexCode	String		`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String		`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean		`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long		`openapi_pingan_record`.`created_by`	创建人
createdTime	Date		`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long		`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date		`openapi_pingan_record`.`updated_time`	修改时间
remark	String		`openapi_pingan_record`.`remark`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pingan/addOpenapiPinganRecord

{
  "body": {
    "cardNo": "",
    "name": "",
    "idType": "1",
    "identityNo": "",
    "phone": "13800000000",
    "applyNum": "",
    "policyNo": "",
    "applyPolicyNo": "",
    "insuranceBeginDate": "2026-01-01 12:00:00",
    "insuranceEndDate": "2026-01-01 12:00:00",
    "birthday": "",
    "sexCode": "",
    "status": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiPinganRecordService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pingan/deleteOpenapiPinganRecord 未使用管理后台 #

平安投保记录-删除 · OpenapiPinganRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPinganRecordController#deleteOpenapiPinganRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pingan_record

ControllerOpenapiPinganRecordController#deleteOpenapiPinganRecord

ServiceOpenapiPinganRecordService#delete （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#deleteById ⇒ 表 openapi_pingan_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingan/deleteOpenapiPinganRecord
uat	https://dscp-uat.hn12301.net/manage-api/pingan/deleteOpenapiPinganRecord
pro	https://dscp-uat.hn12301.net/manage-api/pingan/deleteOpenapiPinganRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_pingan_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pingan/deleteOpenapiPinganRecord

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiPinganRecordService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pingan/getOpenapiPinganRecord 未使用管理后台 #

平安投保记录-详情 · OpenapiPinganRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPinganRecordController#getOpenapiPinganRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pingan_record

ControllerOpenapiPinganRecordController#getOpenapiPinganRecord

ServiceOpenapiPinganRecordService#get （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#selectById ⇒ 表 openapi_pingan_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingan/getOpenapiPinganRecord
uat	https://dscp-uat.hn12301.net/manage-api/pingan/getOpenapiPinganRecord
pro	https://dscp-uat.hn12301.net/manage-api/pingan/getOpenapiPinganRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_pingan_record`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiPinganRecordResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`openapi_pingan_record`.`id`	id
cardNo	String		`openapi_pingan_record`.`card_no`
name	String		`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`openapi_pingan_record`.`identity_no`	身份证号码
phone	String		`openapi_pingan_record`.`phone`	手机号码
applyNum	String		`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String		`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String		`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String		`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String		`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String		`openapi_pingan_record`.`birthday`	出生年月
sexCode	String		`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String		`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean		`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long		`openapi_pingan_record`.`created_by`	创建人
createdTime	Date		`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long		`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date		`openapi_pingan_record`.`updated_time`	修改时间
remark	String		`openapi_pingan_record`.`remark`

示例

请求示例（自动生成，仅结构参考）

POST /pingan/getOpenapiPinganRecord

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "cardNo": "",
    "name": "",
    "idType": "1",
    "identityNo": "",
    "phone": "13800000000",
    "applyNum": "",
    "policyNo": "",
    "applyPolicyNo": "",
    "insuranceBeginDate": "2026-01-01 12:00:00",
    "insuranceEndDate": "2026-01-01 12:00:00",
    "birthday": "",
    "sexCode": "",
    "status": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

处理逻辑

逻辑摘要查询详情（openapiPinganRecordService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pingan/queryOpenapiPinganRecordList 在用管理后台 #

平安投保记录-列表查询 · OpenapiPinganRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPinganRecordController#queryOpenapiPinganRecordList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pingan_record

ControllerOpenapiPinganRecordController#queryOpenapiPinganRecordList

转换BeanUtils.map → OpenapiPinganRecordQuery

ServiceOpenapiPinganRecordService#queryList （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#selectList ⇒ 表 openapi_pingan_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingan/queryOpenapiPinganRecordList
uat	https://dscp-uat.hn12301.net/manage-api/pingan/queryOpenapiPinganRecordList
pro	https://dscp-uat.hn12301.net/manage-api/pingan/queryOpenapiPinganRecordList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPinganRecordListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字
cardNo	String			`openapi_pingan_record`.`card_no`
name	String			`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType		1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String			`openapi_pingan_record`.`identity_no`	身份证号码
phone	String			`openapi_pingan_record`.`phone`	手机号码
applyNum	String			`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String			`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String			`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String			`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String			`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String			`openapi_pingan_record`.`birthday`	出生年月
sexCode	String			`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String			`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean			`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long			`openapi_pingan_record`.`created_by`	创建人
createdTime	Date			`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long			`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date			`openapi_pingan_record`.`updated_time`	修改时间
remark	String			`openapi_pingan_record`.`remark`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiPinganRecordResponse>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
id	Long		`openapi_pingan_record`.`id`	id
cardNo	String		`openapi_pingan_record`.`card_no`
name	String		`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`openapi_pingan_record`.`identity_no`	身份证号码
phone	String		`openapi_pingan_record`.`phone`	手机号码
applyNum	String		`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String		`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String		`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String		`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String		`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String		`openapi_pingan_record`.`birthday`	出生年月
sexCode	String		`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String		`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean		`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long		`openapi_pingan_record`.`created_by`	创建人
createdTime	Date		`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long		`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date		`openapi_pingan_record`.`updated_time`	修改时间
remark	String		`openapi_pingan_record`.`remark`

示例

请求示例（自动生成，仅结构参考）

POST /pingan/queryOpenapiPinganRecordList

{
  "body": {
    "keywords": "",
    "cardNo": "",
    "name": "",
    "idType": "1",
    "identityNo": "",
    "phone": "13800000000",
    "applyNum": "",
    "policyNo": "",
    "applyPolicyNo": "",
    "insuranceBeginDate": "2026-01-01 12:00:00",
    "insuranceEndDate": "2026-01-01 12:00:00",
    "birthday": "",
    "sexCode": "",
    "status": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "cardNo": "",
      "name": "",
      "idType": "1",
      "identityNo": "",
      "phone": "13800000000",
      "applyNum": "",
      "policyNo": "",
      "applyPolicyNo": "",
      "insuranceBeginDate": "2026-01-01 12:00:00",
      "insuranceEndDate": "2026-01-01 12:00:00",
      "birthday": "",
      "sexCode": "",
      "status": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "remark": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiPinganRecordService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryPinganRecordList exact

POST /pingan/queryOpenapiPinganRecordPage 在用管理后台 #

平安投保记录-分页查询 · OpenapiPinganRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPinganRecordController#queryOpenapiPinganRecordPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pingan_record

ControllerOpenapiPinganRecordController#queryOpenapiPinganRecordPage

转换BeanUtils.map → OpenapiPinganRecordQuery

ServiceOpenapiPinganRecordService#queryPage （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#selectPage ⇒ 表 openapi_pingan_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingan/queryOpenapiPinganRecordPage
uat	https://dscp-uat.hn12301.net/manage-api/pingan/queryOpenapiPinganRecordPage
pro	https://dscp-uat.hn12301.net/manage-api/pingan/queryOpenapiPinganRecordPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPinganRecordPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
cardNo	String			`openapi_pingan_record`.`card_no`
name	String			`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType		1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String			`openapi_pingan_record`.`identity_no`	身份证号码
phone	String			`openapi_pingan_record`.`phone`	手机号码
applyNum	String			`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String			`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String			`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String			`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String			`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String			`openapi_pingan_record`.`birthday`	出生年月
sexCode	String			`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String			`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean			`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long			`openapi_pingan_record`.`created_by`	创建人
createdTime	Date			`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long			`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date			`openapi_pingan_record`.`updated_time`	修改时间
remark	String			`openapi_pingan_record`.`remark`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiPinganRecordResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`openapi_pingan_record`.`id`	id
cardNo	String		`openapi_pingan_record`.`card_no`
name	String		`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`openapi_pingan_record`.`identity_no`	身份证号码
phone	String		`openapi_pingan_record`.`phone`	手机号码
applyNum	String		`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String		`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String		`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String		`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String		`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String		`openapi_pingan_record`.`birthday`	出生年月
sexCode	String		`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String		`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean		`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long		`openapi_pingan_record`.`created_by`	创建人
createdTime	Date		`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long		`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date		`openapi_pingan_record`.`updated_time`	修改时间
remark	String		`openapi_pingan_record`.`remark`

示例

请求示例（自动生成，仅结构参考）

POST /pingan/queryOpenapiPinganRecordPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "cardNo": "",
    "name": "",
    "idType": "1",
    "identityNo": "",
    "phone": "13800000000",
    "applyNum": "",
    "policyNo": "",
    "applyPolicyNo": "",
    "insuranceBeginDate": "2026-01-01 12:00:00",
    "insuranceEndDate": "2026-01-01 12:00:00",
    "birthday": "",
    "sexCode": "",
    "status": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "cardNo": "",
        "name": "",
        "idType": "1",
        "identityNo": "",
        "phone": "13800000000",
        "applyNum": "",
        "policyNo": "",
        "applyPolicyNo": "",
        "insuranceBeginDate": "2026-01-01 12:00:00",
        "insuranceEndDate": "2026-01-01 12:00:00",
        "birthday": "",
        "sexCode": "",
        "status": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "remark": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiPinganRecordService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryPinganRecordPage exact

POST /pingan/updateOpenapiPinganRecord 未使用管理后台 #

平安投保记录-更新 · OpenapiPinganRecordController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPinganRecordController#updateOpenapiPinganRecord
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_pingan_record

ControllerOpenapiPinganRecordController#updateOpenapiPinganRecord

转换BeanUtils.map → OpenapiPinganRecord ⇒ 表 openapi_pingan_record

ServiceOpenapiPinganRecordService#update （OpenapiPinganRecordServiceImpl）

MapperOpenapiPinganRecordMapper#updateById ⇒ 表 openapi_pingan_record

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingan/updateOpenapiPinganRecord
uat	https://dscp-uat.hn12301.net/manage-api/pingan/updateOpenapiPinganRecord
pro	https://dscp-uat.hn12301.net/manage-api/pingan/updateOpenapiPinganRecord	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPinganRecordUpdateRequest

字段	类型	取值/校验	表 / 列	说明
id	Long		`openapi_pingan_record`.`id`	id
cardNo	String		`openapi_pingan_record`.`card_no`
name	String		`openapi_pingan_record`.`name`	持卡人姓名
idType	IdType	1身份证2护照3港澳居民来往内地通行证5驾驶证6居住证7士官证8学生证+1	`openapi_pingan_record`.`id_type`	证件类型(枚举:card.IdType)，1身份证，2护照，3港澳通行证，4台胞证，5驾驶证，6居住证，7士官证，8学生证，9出生证
identityNo	String		`openapi_pingan_record`.`identity_no`	身份证号码
phone	String		`openapi_pingan_record`.`phone`	手机号码
applyNum	String		`openapi_pingan_record`.`apply_num`	商户单号
policyNo	String		`openapi_pingan_record`.`policy_no`	保单号
applyPolicyNo	String		`openapi_pingan_record`.`apply_policy_no`	投保单号
insuranceBeginDate	String		`openapi_pingan_record`.`insurance_begin_date`	保险起期
insuranceEndDate	String		`openapi_pingan_record`.`insurance_end_date`	保险止期
birthday	String		`openapi_pingan_record`.`birthday`	出生年月
sexCode	String		`openapi_pingan_record`.`sex_code`	非身份证时必填(F-女 M-男)
status	String		`openapi_pingan_record`.`status`	订单状态：BE:待审批，B1：待审核，BH：待验车，B2：待缴费，B3：待承保，B5 ：已承保
isDeleted	Boolean		`openapi_pingan_record`.`is_deleted`	是否删除
createdBy	Long		`openapi_pingan_record`.`created_by`	创建人
createdTime	Date		`openapi_pingan_record`.`created_time`	创建时间
updatedBy	Long		`openapi_pingan_record`.`updated_by`	修改人
updatedTime	Date		`openapi_pingan_record`.`updated_time`	修改时间
remark	String		`openapi_pingan_record`.`remark`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pingan/updateOpenapiPinganRecord

{
  "body": {
    "id": 1,
    "cardNo": "",
    "name": "",
    "idType": "1",
    "identityNo": "",
    "phone": "13800000000",
    "applyNum": "",
    "policyNo": "",
    "applyPolicyNo": "",
    "insuranceBeginDate": "2026-01-01 12:00:00",
    "insuranceEndDate": "2026-01-01 12:00:00",
    "birthday": "",
    "sexCode": "",
    "status": "",
    "isDeleted": false,
    "createdBy": 0,
    "createdTime": "2026-01-01 12:00:00",
    "updatedBy": 0,
    "updatedTime": "2026-01-01 12:00:00",
    "remark": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiPinganRecordService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiPlatformInfoController 0/6 在用

POST /openapi/addOpenapiPlatformInfo 未使用管理后台 #

开放接口接入方信息-新增 · OpenapiPlatformInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPlatformInfoController#addOpenapiPlatformInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_platform_info

ControllerOpenapiPlatformInfoController#addOpenapiPlatformInfo

转换BeanUtils.map → OpenapiPlatformInfo ⇒ 表 openapi_platform_info

ServiceOpenapiPlatformInfoService#add （OpenapiPlatformInfoServiceImpl）

MapperOpenapiPlatformInfoMapper#insert ⇒ 表 openapi_platform_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiPlatformInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiPlatformInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiPlatformInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPlatformInfoAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiPlatformInfo

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiPlatformInfoService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiPlatformInfo 未使用管理后台 #

开放接口接入方信息-删除 · OpenapiPlatformInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPlatformInfoController#deleteOpenapiPlatformInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_platform_info

ControllerOpenapiPlatformInfoController#deleteOpenapiPlatformInfo

ServiceOpenapiPlatformInfoService#delete （OpenapiPlatformInfoServiceImpl）

MapperOpenapiPlatformInfoMapper#deleteById ⇒ 表 openapi_platform_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiPlatformInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiPlatformInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiPlatformInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_platform_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiPlatformInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiPlatformInfoService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiPlatformInfo 未使用管理后台 #

开放接口接入方信息-详情 · OpenapiPlatformInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPlatformInfoController#getOpenapiPlatformInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_platform_info

ControllerOpenapiPlatformInfoController#getOpenapiPlatformInfo

ServiceOpenapiPlatformInfoService#get （OpenapiPlatformInfoServiceImpl）

MapperOpenapiPlatformInfoMapper#selectById ⇒ 表 openapi_platform_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiPlatformInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiPlatformInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiPlatformInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_platform_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiPlatformInfoResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_platform_info`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiPlatformInfo

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiPlatformInfoService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiPlatformInfoList 未使用管理后台 #

开放接口接入方信息-列表查询 · OpenapiPlatformInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPlatformInfoController#queryOpenapiPlatformInfoList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_platform_info

ControllerOpenapiPlatformInfoController#queryOpenapiPlatformInfoList

转换BeanUtils.map → OpenapiPlatformInfoQuery

ServiceOpenapiPlatformInfoService#queryList （OpenapiPlatformInfoServiceImpl）

MapperOpenapiPlatformInfoMapper#selectList ⇒ 表 openapi_platform_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiPlatformInfoList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiPlatformInfoList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiPlatformInfoList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPlatformInfoListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiPlatformInfoResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_platform_info`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiPlatformInfoList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiPlatformInfoService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiPlatformInfoPage 未使用管理后台 #

开放接口接入方信息-分页查询 · OpenapiPlatformInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPlatformInfoController#queryOpenapiPlatformInfoPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_platform_info

ControllerOpenapiPlatformInfoController#queryOpenapiPlatformInfoPage

转换BeanUtils.map → OpenapiPlatformInfoQuery

ServiceOpenapiPlatformInfoService#queryPage （OpenapiPlatformInfoServiceImpl）

MapperOpenapiPlatformInfoMapper#selectPage ⇒ 表 openapi_platform_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiPlatformInfoPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiPlatformInfoPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiPlatformInfoPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPlatformInfoPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiPlatformInfoResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_platform_info`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiPlatformInfoPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiPlatformInfoService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiPlatformInfo 未使用管理后台 #

开放接口接入方信息-更新 · OpenapiPlatformInfoController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiPlatformInfoController#updateOpenapiPlatformInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_platform_info

ControllerOpenapiPlatformInfoController#updateOpenapiPlatformInfo

转换BeanUtils.map → OpenapiPlatformInfo ⇒ 表 openapi_platform_info

ServiceOpenapiPlatformInfoService#update （OpenapiPlatformInfoServiceImpl）

MapperOpenapiPlatformInfoMapper#updateById ⇒ 表 openapi_platform_info

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiPlatformInfo
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiPlatformInfo
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiPlatformInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiPlatformInfoUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_platform_info`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiPlatformInfo

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiPlatformInfoService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiSskCardController 0/6 在用

POST /openapi/addOpenapiSskCard 未使用管理后台 #

三省卡电子卡表-新增 · OpenapiSskCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskCardController#addOpenapiSskCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_card

ControllerOpenapiSskCardController#addOpenapiSskCard

转换BeanUtils.map → OpenapiSskCard ⇒ 表 openapi_ssk_card

ServiceOpenapiSskCardService#add （OpenapiSskCardServiceImpl）

MapperOpenapiSskCardMapper#insert ⇒ 表 openapi_ssk_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiSskCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiSskCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiSskCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskCardAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiSskCard

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiSskCardService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiSskCard 未使用管理后台 #

三省卡电子卡表-删除 · OpenapiSskCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskCardController#deleteOpenapiSskCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_card

ControllerOpenapiSskCardController#deleteOpenapiSskCard

ServiceOpenapiSskCardService#delete （OpenapiSskCardServiceImpl）

MapperOpenapiSskCardMapper#deleteById ⇒ 表 openapi_ssk_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiSskCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiSskCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiSskCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ssk_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiSskCard

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiSskCardService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiSskCard 未使用管理后台 #

三省卡电子卡表-详情 · OpenapiSskCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskCardController#getOpenapiSskCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_card

ControllerOpenapiSskCardController#getOpenapiSskCard

ServiceOpenapiSskCardService#get （OpenapiSskCardServiceImpl）

MapperOpenapiSskCardMapper#selectById ⇒ 表 openapi_ssk_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiSskCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiSskCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiSskCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ssk_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiSskCardResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ssk_card`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiSskCard

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiSskCardService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiSskCardList 未使用管理后台 #

三省卡电子卡表-列表查询 · OpenapiSskCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskCardController#queryOpenapiSskCardList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_card

ControllerOpenapiSskCardController#queryOpenapiSskCardList

转换BeanUtils.map → OpenapiSskCardQuery

ServiceOpenapiSskCardService#queryList （OpenapiSskCardServiceImpl）

MapperOpenapiSskCardMapper#selectList ⇒ 表 openapi_ssk_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiSskCardList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskCardList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskCardList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskCardListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiSskCardResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_ssk_card`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiSskCardList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiSskCardService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiSskCardPage 未使用管理后台 #

三省卡电子卡表-分页查询 · OpenapiSskCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskCardController#queryOpenapiSskCardPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_card

ControllerOpenapiSskCardController#queryOpenapiSskCardPage

转换BeanUtils.map → OpenapiSskCardQuery

ServiceOpenapiSskCardService#queryPage （OpenapiSskCardServiceImpl）

MapperOpenapiSskCardMapper#selectPage ⇒ 表 openapi_ssk_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiSskCardPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskCardPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskCardPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskCardPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiSskCardResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_ssk_card`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiSskCardPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiSskCardService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiSskCard 未使用管理后台 #

三省卡电子卡表-更新 · OpenapiSskCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskCardController#updateOpenapiSskCard
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_card

ControllerOpenapiSskCardController#updateOpenapiSskCard

转换BeanUtils.map → OpenapiSskCard ⇒ 表 openapi_ssk_card

ServiceOpenapiSskCardService#update （OpenapiSskCardServiceImpl）

MapperOpenapiSskCardMapper#updateById ⇒ 表 openapi_ssk_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiSskCard
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiSskCard
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiSskCard	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskCardUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ssk_card`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiSskCard

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiSskCardService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiSskUserController 0/6 在用

POST /openapi/addOpenapiSskUser 未使用管理后台 #

三省卡用户表-新增 · OpenapiSskUserController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskUserController#addOpenapiSskUser
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_user

ControllerOpenapiSskUserController#addOpenapiSskUser

转换BeanUtils.map → OpenapiSskUser ⇒ 表 openapi_ssk_user

ServiceOpenapiSskUserService#add （OpenapiSskUserServiceImpl）

MapperOpenapiSskUserMapper#insert ⇒ 表 openapi_ssk_user

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiSskUser
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiSskUser
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiSskUser	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskUserAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			`openapi_ssk_user`.`name`	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiSskUser

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiSskUserService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiSskUser 未使用管理后台 #

三省卡用户表-删除 · OpenapiSskUserController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskUserController#deleteOpenapiSskUser
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_user

ControllerOpenapiSskUserController#deleteOpenapiSskUser

ServiceOpenapiSskUserService#delete （OpenapiSskUserServiceImpl）

MapperOpenapiSskUserMapper#deleteById ⇒ 表 openapi_ssk_user

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiSskUser
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiSskUser
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiSskUser	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ssk_user`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiSskUser

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiSskUserService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiSskUser 未使用管理后台 #

三省卡用户表-详情 · OpenapiSskUserController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskUserController#getOpenapiSskUser
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_user

ControllerOpenapiSskUserController#getOpenapiSskUser

ServiceOpenapiSskUserService#get （OpenapiSskUserServiceImpl）

MapperOpenapiSskUserMapper#selectById ⇒ 表 openapi_ssk_user

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiSskUser
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiSskUser
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiSskUser	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ssk_user`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiSskUserResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ssk_user`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiSskUser

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiSskUserService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiSskUserList 未使用管理后台 #

三省卡用户表-列表查询 · OpenapiSskUserController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskUserController#queryOpenapiSskUserList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_user

ControllerOpenapiSskUserController#queryOpenapiSskUserList

转换BeanUtils.map → OpenapiSskUserQuery

ServiceOpenapiSskUserService#queryList （OpenapiSskUserServiceImpl）

MapperOpenapiSskUserMapper#selectList ⇒ 表 openapi_ssk_user

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiSskUserList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskUserList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskUserList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskUserListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiSskUserResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_ssk_user`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiSskUserList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiSskUserService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiSskUserPage 未使用管理后台 #

三省卡用户表-分页查询 · OpenapiSskUserController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskUserController#queryOpenapiSskUserPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_user

ControllerOpenapiSskUserController#queryOpenapiSskUserPage

转换BeanUtils.map → OpenapiSskUserQuery

ServiceOpenapiSskUserService#queryPage （OpenapiSskUserServiceImpl）

MapperOpenapiSskUserMapper#selectPage ⇒ 表 openapi_ssk_user

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiSskUserPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskUserPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiSskUserPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskUserPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiSskUserResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_ssk_user`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiSskUserPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiSskUserService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiSskUser 未使用管理后台 #

三省卡用户表-更新 · OpenapiSskUserController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiSskUserController#updateOpenapiSskUser
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ssk_user

ControllerOpenapiSskUserController#updateOpenapiSskUser

转换BeanUtils.map → OpenapiSskUser ⇒ 表 openapi_ssk_user

ServiceOpenapiSskUserService#update （OpenapiSskUserServiceImpl）

MapperOpenapiSskUserMapper#updateById ⇒ 表 openapi_ssk_user

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiSskUser
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiSskUser
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiSskUser	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiSskUserUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ssk_user`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiSskUser

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiSskUserService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiTgyOrderController 0/6 在用

POST /openapi/addOpenapiTgyOrder 未使用管理后台 #

铜官窑订单表-新增 · OpenapiTgyOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTgyOrderController#addOpenapiTgyOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tgy_order

ControllerOpenapiTgyOrderController#addOpenapiTgyOrder

转换BeanUtils.map → OpenapiTgyOrder ⇒ 表 openapi_tgy_order

ServiceOpenapiTgyOrderService#add （OpenapiTgyOrderServiceImpl）

MapperOpenapiTgyOrderMapper#insert ⇒ 表 openapi_tgy_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiTgyOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiTgyOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiTgyOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTgyOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiTgyOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiTgyOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiTgyOrder 未使用管理后台 #

铜官窑订单表-删除 · OpenapiTgyOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTgyOrderController#deleteOpenapiTgyOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tgy_order

ControllerOpenapiTgyOrderController#deleteOpenapiTgyOrder

ServiceOpenapiTgyOrderService#delete （OpenapiTgyOrderServiceImpl）

MapperOpenapiTgyOrderMapper#deleteById ⇒ 表 openapi_tgy_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiTgyOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiTgyOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiTgyOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_tgy_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiTgyOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiTgyOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiTgyOrder 未使用管理后台 #

铜官窑订单表-详情 · OpenapiTgyOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTgyOrderController#getOpenapiTgyOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tgy_order

ControllerOpenapiTgyOrderController#getOpenapiTgyOrder

ServiceOpenapiTgyOrderService#get （OpenapiTgyOrderServiceImpl）

MapperOpenapiTgyOrderMapper#selectById ⇒ 表 openapi_tgy_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiTgyOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiTgyOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiTgyOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_tgy_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiTgyOrderResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_tgy_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiTgyOrder

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiTgyOrderService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiTgyOrderList 未使用管理后台 #

铜官窑订单表-列表查询 · OpenapiTgyOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTgyOrderController#queryOpenapiTgyOrderList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tgy_order

ControllerOpenapiTgyOrderController#queryOpenapiTgyOrderList

转换BeanUtils.map → OpenapiTgyOrderQuery

ServiceOpenapiTgyOrderService#queryList （OpenapiTgyOrderServiceImpl）

MapperOpenapiTgyOrderMapper#selectList ⇒ 表 openapi_tgy_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiTgyOrderList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTgyOrderList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTgyOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTgyOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiTgyOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_tgy_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiTgyOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiTgyOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiTgyOrderPage 未使用管理后台 #

铜官窑订单表-分页查询 · OpenapiTgyOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTgyOrderController#queryOpenapiTgyOrderPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tgy_order

ControllerOpenapiTgyOrderController#queryOpenapiTgyOrderPage

转换BeanUtils.map → OpenapiTgyOrderQuery

ServiceOpenapiTgyOrderService#queryPage （OpenapiTgyOrderServiceImpl）

MapperOpenapiTgyOrderMapper#selectPage ⇒ 表 openapi_tgy_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiTgyOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTgyOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTgyOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTgyOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiTgyOrderResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_tgy_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiTgyOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiTgyOrderService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiTgyOrder 未使用管理后台 #

铜官窑订单表-更新 · OpenapiTgyOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTgyOrderController#updateOpenapiTgyOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tgy_order

ControllerOpenapiTgyOrderController#updateOpenapiTgyOrder

转换BeanUtils.map → OpenapiTgyOrder ⇒ 表 openapi_tgy_order

ServiceOpenapiTgyOrderService#update （OpenapiTgyOrderServiceImpl）

MapperOpenapiTgyOrderMapper#updateById ⇒ 表 openapi_tgy_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiTgyOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiTgyOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiTgyOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTgyOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_tgy_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiTgyOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiTgyOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiTicketCodePoolController 4/4 在用

POST /openapi/ticketCodePool/import 在用管理后台 #

（无摘要） · OpenapiTicketCodePoolController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTicketCodePoolController#importTicketCodes
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ticket_code_pool

ControllerOpenapiTicketCodePoolController#importTicketCodes

MapperOpenapiTicketCodePoolMapper#insert ⇒ 表 openapi_ticket_code_pool

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/ticketCodePool/import
uat	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/import
pro	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/import	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	file	MultipartFile	是		—

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　Integer　（scalar）

标量/Map/外部类型：Integer

示例

请求示例（自动生成，仅结构参考）

POST /openapi/ticketCodePool/import?file=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": 0
}

处理逻辑

逻辑摘要调用 isBlank（StrUtil.isBlank）；调用 isNotBlank（StrUtil.isNotBlank）；新增（ticketCodePoolMapper.insert）

内联注释

xuchao: 数值解析带行号提示
xuchao: 解析售票日期和有效期至（C2 修复）
xuchao: 批量插入（I4 修复），每 500 条一批

前端调用方

dscp-html-manage importTicketCodePool exact

POST /openapi/ticketCodePool/page 在用管理后台 #

（无摘要） · OpenapiTicketCodePoolController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTicketCodePoolController#queryPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointmentopenapi_ticket_code_pool

ControllerOpenapiTicketCodePoolController#queryPage

MapperCardAppointmentMapper#selectList ⇒ 表 card_appointment

MapperOpenapiTicketCodePoolMapper#selectPage ⇒ 表 openapi_ticket_code_pool

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/ticketCodePool/page
uat	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/page
pro	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/page	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　Map<String, Object>

请求体类型：Map<String, Object>（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　Page<OpenapiTicketCodePool>　（object）

标量/Map/外部类型：Page<OpenapiTicketCodePool>

示例

请求示例（自动生成，仅结构参考）

POST /openapi/ticketCodePool/page

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": ""
}

处理逻辑

逻辑摘要调用 isNotBlank（StrUtil.isNotBlank）；列表查询（cardAppointmentMapper.selectList）；分页查询（ticketCodePoolMapper.selectPage）

内联注释

xuchao: @TableLogic 自动追加 is_deleted=0，无需手动添加
xuchao: 按预约卡号过滤，通过 card_appointment 表反查 appointmentId
xuchao: 无匹配时传入不可能命中的 id，确保查询结果为空

前端调用方

dscp-html-manage queryTicketCodePoolPage exact

POST /openapi/ticketCodePool/stats 在用管理后台 #

（无摘要） · OpenapiTicketCodePoolController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTicketCodePoolController#stats
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ticket_code_pool

ControllerOpenapiTicketCodePoolController#stats

MapperOpenapiTicketCodePoolMapper#selectCount ⇒ 表 openapi_ticket_code_pool

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/ticketCodePool/stats
uat	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/stats
pro	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/stats	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTicketCodePool

字段	类型	表 / 列	说明
id	Long	`openapi_ticket_code_pool`.`id`
skuId	Long	`openapi_ticket_code_pool`.`sku_id`
ticketCode	String	`openapi_ticket_code_pool`.`ticket_code`	验票码
ticketCodeNo	String	`openapi_ticket_code_pool`.`ticket_code_no`	代码
ticketNumber	String	`openapi_ticket_code_pool`.`ticket_number`	号码
ticketName	String	`openapi_ticket_code_pool`.`ticket_name`	票名
amount	BigDecimal	`openapi_ticket_code_pool`.`amount`	金额
peopleCount	Integer	`openapi_ticket_code_pool`.`people_count`	人数
saleTime	Date	`openapi_ticket_code_pool`.`sale_time`	售票日期
validUntil	Date	`openapi_ticket_code_pool`.`valid_until`	有效期至
ticketType	String	`openapi_ticket_code_pool`.`ticket_type`	票种类型
status	Integer	`openapi_ticket_code_pool`.`status`	0未使用 1已占用
appointmentId	Long	`openapi_ticket_code_pool`.`appointment_id`	预约单id
usedTime	Date	`openapi_ticket_code_pool`.`used_time`	占用时间
createdTime	Date	`openapi_ticket_code_pool`.`created_time`
updatedTime	Date	`openapi_ticket_code_pool`.`updated_time`
isDeleted	Boolean	`openapi_ticket_code_pool`.`is_deleted`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　Map<String, Long>　（map）

标量/Map/外部类型：Map<String, Long>

示例

请求示例（自动生成，仅结构参考）

POST /openapi/ticketCodePool/stats

{
  "body": {
    "id": 1,
    "skuId": 1,
    "ticketCode": "",
    "ticketCodeNo": "",
    "ticketNumber": "",
    "ticketName": "",
    "amount": 0,
    "peopleCount": 0,
    "saleTime": "2026-01-01 12:00:00",
    "validUntil": "2026-01-01 12:00:00",
    "ticketType": "",
    "status": 0,
    "appointmentId": 1,
    "usedTime": "2026-01-01 12:00:00",
    "createdTime": "2026-01-01 12:00:00",
    "updatedTime": "2026-01-01 12:00:00",
    "isDeleted": false
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {}
}

处理逻辑

逻辑摘要调用 selectCount（ticketCodePoolMapper.selectCount）

内联注释

xuchao: @TableLogic 自动追加 is_deleted=0

前端调用方

dscp-html-manage getTicketCodePoolStats exact

GET /openapi/ticketCodePool/template 在用管理后台 #

（无摘要） · OpenapiTicketCodePoolController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTicketCodePoolController#downloadTemplate
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	GET

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

调用链路（控制器方法内未解析到 Service/Mapper 调用，可能为接口声明或简单转发）

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/ticketCodePool/template
uat	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/template
pro	https://dscp-uat.hn12301.net/manage-api/openapi/ticketCodePool/template	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

GET /openapi/ticketCodePool/template

响应示例

（void，无响应体）

处理逻辑

逻辑摘要见下方调用链

前端调用方

dscp-html-manage downloadTicketCodePoolTemplate exact

OpenapiTstcOrderController 0/6 在用

POST /openapi/addOpenapiTstcOrder 未使用管理后台 #

天时同城订单信息表-新增 · OpenapiTstcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTstcOrderController#addOpenapiTstcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tstc_order

ControllerOpenapiTstcOrderController#addOpenapiTstcOrder

转换BeanUtils.map → OpenapiTstcOrder ⇒ 表 openapi_tstc_order

ServiceOpenapiTstcOrderService#add （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#insert ⇒ 表 openapi_tstc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiTstcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiTstcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiTstcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTstcOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiTstcOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiTstcOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiTstcOrder 未使用管理后台 #

天时同城订单信息表-删除 · OpenapiTstcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTstcOrderController#deleteOpenapiTstcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tstc_order

ControllerOpenapiTstcOrderController#deleteOpenapiTstcOrder

ServiceOpenapiTstcOrderService#delete （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#deleteById ⇒ 表 openapi_tstc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiTstcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiTstcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiTstcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_tstc_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiTstcOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiTstcOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiTstcOrder 未使用管理后台 #

天时同城订单信息表-详情 · OpenapiTstcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTstcOrderController#getOpenapiTstcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tstc_order

ControllerOpenapiTstcOrderController#getOpenapiTstcOrder

ServiceOpenapiTstcOrderService#get （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#selectById ⇒ 表 openapi_tstc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiTstcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiTstcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiTstcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_tstc_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiTstcOrderResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_tstc_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiTstcOrder

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiTstcOrderService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiTstcOrderList 未使用管理后台 #

天时同城订单信息表-列表查询 · OpenapiTstcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTstcOrderController#queryOpenapiTstcOrderList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tstc_order

ControllerOpenapiTstcOrderController#queryOpenapiTstcOrderList

转换BeanUtils.map → OpenapiTstcOrderQuery

ServiceOpenapiTstcOrderService#queryList （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#selectList ⇒ 表 openapi_tstc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiTstcOrderList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTstcOrderList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTstcOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTstcOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiTstcOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_tstc_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiTstcOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiTstcOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiTstcOrderPage 未使用管理后台 #

天时同城订单信息表-分页查询 · OpenapiTstcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTstcOrderController#queryOpenapiTstcOrderPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tstc_order

ControllerOpenapiTstcOrderController#queryOpenapiTstcOrderPage

转换BeanUtils.map → OpenapiTstcOrderQuery

ServiceOpenapiTstcOrderService#queryPage （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#selectPage ⇒ 表 openapi_tstc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiTstcOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTstcOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiTstcOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTstcOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiTstcOrderResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_tstc_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiTstcOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiTstcOrderService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiTstcOrder 未使用管理后台 #

天时同城订单信息表-更新 · OpenapiTstcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiTstcOrderController#updateOpenapiTstcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_tstc_order

ControllerOpenapiTstcOrderController#updateOpenapiTstcOrder

转换BeanUtils.map → OpenapiTstcOrder ⇒ 表 openapi_tstc_order

ServiceOpenapiTstcOrderService#update （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#updateById ⇒ 表 openapi_tstc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiTstcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiTstcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiTstcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiTstcOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_tstc_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiTstcOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiTstcOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiXcLogController 0/6 在用

POST /openapi/addOpenapiXcLog 未使用管理后台 #

秀川提现记录表-新增 · OpenapiXcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXcLogController#addOpenapiXcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xc_log

ControllerOpenapiXcLogController#addOpenapiXcLog

转换BeanUtils.map → OpenapiXcLog ⇒ 表 openapi_xc_log

ServiceOpenapiXcLogService#add （OpenapiXcLogServiceImpl）

MapperOpenapiXcLogMapper#insert ⇒ 表 openapi_xc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiXcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiXcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiXcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXcLogAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			`openapi_xc_log`.`name`	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiXcLog

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiXcLogService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiXcLog 未使用管理后台 #

秀川提现记录表-删除 · OpenapiXcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXcLogController#deleteOpenapiXcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xc_log

ControllerOpenapiXcLogController#deleteOpenapiXcLog

ServiceOpenapiXcLogService#delete （OpenapiXcLogServiceImpl）

MapperOpenapiXcLogMapper#deleteById ⇒ 表 openapi_xc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiXcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiXcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiXcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_xc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiXcLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiXcLogService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiXcLog 未使用管理后台 #

秀川提现记录表-详情 · OpenapiXcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXcLogController#getOpenapiXcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xc_log

ControllerOpenapiXcLogController#getOpenapiXcLog

ServiceOpenapiXcLogService#get （OpenapiXcLogServiceImpl）

MapperOpenapiXcLogMapper#selectById ⇒ 表 openapi_xc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiXcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiXcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiXcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_xc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiXcLogResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_xc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiXcLog

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiXcLogService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiXcLogList 未使用管理后台 #

秀川提现记录表-列表查询 · OpenapiXcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXcLogController#queryOpenapiXcLogList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xc_log

ControllerOpenapiXcLogController#queryOpenapiXcLogList

转换BeanUtils.map → OpenapiXcLogQuery

ServiceOpenapiXcLogService#queryList （OpenapiXcLogServiceImpl）

MapperOpenapiXcLogMapper#selectList ⇒ 表 openapi_xc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiXcLogList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXcLogList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXcLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXcLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiXcLogResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_xc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiXcLogList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiXcLogService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiXcLogPage 未使用管理后台 #

秀川提现记录表-分页查询 · OpenapiXcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXcLogController#queryOpenapiXcLogPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xc_log

ControllerOpenapiXcLogController#queryOpenapiXcLogPage

转换BeanUtils.map → OpenapiXcLogQuery

ServiceOpenapiXcLogService#queryPage （OpenapiXcLogServiceImpl）

MapperOpenapiXcLogMapper#selectPage ⇒ 表 openapi_xc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiXcLogPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXcLogPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXcLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXcLogPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiXcLogResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_xc_log`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiXcLogPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiXcLogService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiXcLog 未使用管理后台 #

秀川提现记录表-更新 · OpenapiXcLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXcLogController#updateOpenapiXcLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xc_log

ControllerOpenapiXcLogController#updateOpenapiXcLog

转换BeanUtils.map → OpenapiXcLog ⇒ 表 openapi_xc_log

ServiceOpenapiXcLogService#update （OpenapiXcLogServiceImpl）

MapperOpenapiXcLogMapper#updateById ⇒ 表 openapi_xc_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiXcLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiXcLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiXcLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXcLogUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_xc_log`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiXcLog

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiXcLogService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiXghPurchageController 1/7 在用

POST /openapi/addOpenapiXghPurchage 未使用管理后台 #

湘工惠采购单位信息-新增 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#addOpenapiXghPurchage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#addOpenapiXghPurchage

转换BeanUtils.map → OpenapiXghPurchage ⇒ 表 openapi_xgh_purchage

ServiceOpenapiXghPurchageService#add （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#insert ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiXghPurchage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiXghPurchage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiXghPurchage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXghPurchageAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			`openapi_xgh_purchage`.`name`	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiXghPurchage

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiXghPurchageService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiXghPurchage 未使用管理后台 #

湘工惠采购单位信息-删除 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#deleteOpenapiXghPurchage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#deleteOpenapiXghPurchage

ServiceOpenapiXghPurchageService#delete （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#deleteById ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiXghPurchage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiXghPurchage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiXghPurchage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_xgh_purchage`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiXghPurchage

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiXghPurchageService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

ANY /openapi/exportOpenapiXghPurchageList 未使用管理后台 #

导出湘工惠采购单位信息 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#exportOpenapiXghPurchageList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	ANY

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#exportOpenapiXghPurchageList

转换BeanUtils.map → OpenapiXghPurchageQuery

ServiceOpenapiXghPurchageService#queryList （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#selectList ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/exportOpenapiXghPurchageList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/exportOpenapiXghPurchageList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/exportOpenapiXghPurchageList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HttpServletResponse

请求体类型：HttpServletResponse（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

ANY /openapi/exportOpenapiXghPurchageList

响应示例

（void，无响应体）

处理逻辑

逻辑摘要列表查询（openapiXghPurchageService.queryList）；调用 write（ExcelUtils.write）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

组装导出数据
序号

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiXghPurchage 未使用管理后台 #

湘工惠采购单位信息-详情 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#getOpenapiXghPurchage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#getOpenapiXghPurchage

ServiceOpenapiXghPurchageService#get （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#selectById ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiXghPurchage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiXghPurchage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiXghPurchage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_xgh_purchage`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiXghPurchageResponse　（object）

字段	类型	表 / 列	说明
id	Long	`openapi_xgh_purchage`.`id`	id
operatorMobile	String	`openapi_xgh_purchage`.`operator_mobile`
name	String	`openapi_xgh_purchage`.`name`	名称
shuihao	String	`openapi_xgh_purchage`.`shuihao`	税号
contact	String	`openapi_xgh_purchage`.`contact`	联系人
contactMobile	String	`openapi_xgh_purchage`.`contact_mobile`	联系人手机号
purchageNum	Integer	`openapi_xgh_purchage`.`purchage_num`	采购数量
status	Integer	`openapi_xgh_purchage`.`status`	状态 0=禁用 1=正常
addDate	Date	`openapi_xgh_purchage`.`add_date`	添加时间
address	String	`openapi_xgh_purchage`.`address`	地址

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiXghPurchage

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "operatorMobile": "13800000000",
    "name": "",
    "shuihao": "",
    "contact": "",
    "contactMobile": "13800000000",
    "purchageNum": 0,
    "status": 0,
    "addDate": "2026-01-01 12:00:00",
    "address": ""
  }
}

处理逻辑

逻辑摘要查询详情（openapiXghPurchageService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiXghPurchageList 未使用管理后台 #

湘工惠采购单位信息-列表查询 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#queryOpenapiXghPurchageList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#queryOpenapiXghPurchageList

转换BeanUtils.map → OpenapiXghPurchageQuery

ServiceOpenapiXghPurchageService#queryList （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#selectList ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiXghPurchageList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXghPurchageList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXghPurchageList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXghPurchageListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiXghPurchageResponse>　（list）

字段	类型	表 / 列	说明
[ ]	array	—	列表，元素结构见下
id	Long	`openapi_xgh_purchage`.`id`	id
operatorMobile	String	`openapi_xgh_purchage`.`operator_mobile`
name	String	`openapi_xgh_purchage`.`name`	名称
shuihao	String	`openapi_xgh_purchage`.`shuihao`	税号
contact	String	`openapi_xgh_purchage`.`contact`	联系人
contactMobile	String	`openapi_xgh_purchage`.`contact_mobile`	联系人手机号
purchageNum	Integer	`openapi_xgh_purchage`.`purchage_num`	采购数量
status	Integer	`openapi_xgh_purchage`.`status`	状态 0=禁用 1=正常
addDate	Date	`openapi_xgh_purchage`.`add_date`	添加时间
address	String	`openapi_xgh_purchage`.`address`	地址

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiXghPurchageList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1,
      "operatorMobile": "13800000000",
      "name": "",
      "shuihao": "",
      "contact": "",
      "contactMobile": "13800000000",
      "purchageNum": 0,
      "status": 0,
      "addDate": "2026-01-01 12:00:00",
      "address": ""
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiXghPurchageService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiXghPurchagePage 在用管理后台 #

湘工惠采购单位信息-分页查询 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#queryOpenapiXghPurchagePage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#queryOpenapiXghPurchagePage

转换BeanUtils.map → OpenapiXghPurchageQuery

ServiceOpenapiXghPurchageService#queryPage （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#selectPage ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiXghPurchagePage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXghPurchagePage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXghPurchagePage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXghPurchagePageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字
contact	String			`openapi_xgh_purchage`.`contact`
contactMobile	String			`openapi_xgh_purchage`.`contact_mobile`	联系人手机号
name	String			`openapi_xgh_purchage`.`name`	名称
addDateRange	Date[]	否	可选(@MvcOptional)	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiXghPurchageResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_xgh_purchage`.`id`	id
operatorMobile	String	`openapi_xgh_purchage`.`operator_mobile`
name	String	`openapi_xgh_purchage`.`name`	名称
shuihao	String	`openapi_xgh_purchage`.`shuihao`	税号
contact	String	`openapi_xgh_purchage`.`contact`	联系人
contactMobile	String	`openapi_xgh_purchage`.`contact_mobile`	联系人手机号
purchageNum	Integer	`openapi_xgh_purchage`.`purchage_num`	采购数量
status	Integer	`openapi_xgh_purchage`.`status`	状态 0=禁用 1=正常
addDate	Date	`openapi_xgh_purchage`.`add_date`	添加时间
address	String	`openapi_xgh_purchage`.`address`	地址

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiXghPurchagePage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": "",
    "contact": "",
    "contactMobile": "13800000000",
    "name": "",
    "addDateRange": "2026-01-01 12:00:00"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "operatorMobile": "13800000000",
        "name": "",
        "shuihao": "",
        "contact": "",
        "contactMobile": "13800000000",
        "purchageNum": 0,
        "status": 0,
        "addDate": "2026-01-01 12:00:00",
        "address": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiXghPurchageService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

dscp-html-manage queryOpenapiXghPurchagePage exact

POST /openapi/updateOpenapiXghPurchage 未使用管理后台 #

湘工惠采购单位信息-更新 · OpenapiXghPurchageController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXghPurchageController#updateOpenapiXghPurchage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerOpenapiXghPurchageController#updateOpenapiXghPurchage

转换BeanUtils.map → OpenapiXghPurchage ⇒ 表 openapi_xgh_purchage

ServiceOpenapiXghPurchageService#update （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#updateById ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiXghPurchage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiXghPurchage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiXghPurchage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXghPurchageUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_xgh_purchage`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiXghPurchage

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiXghPurchageService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiXjhlcOrderController 0/6 在用

POST /openapi/addOpenapiXjhlcOrder 未使用管理后台 #

雪域水寨记录-新增 · OpenapiXjhlcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXjhlcOrderController#addOpenapiXjhlcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xjhlc_order

ControllerOpenapiXjhlcOrderController#addOpenapiXjhlcOrder

转换BeanUtils.map → OpenapiXjhlcOrder ⇒ 表 openapi_xjhlc_order

ServiceOpenapiXjhlcOrderService#add （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#insert ⇒ 表 openapi_xjhlc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiXjhlcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiXjhlcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiXjhlcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXjhlcOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiXjhlcOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiXjhlcOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiXjhlcOrder 未使用管理后台 #

雪域水寨记录-删除 · OpenapiXjhlcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXjhlcOrderController#deleteOpenapiXjhlcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xjhlc_order

ControllerOpenapiXjhlcOrderController#deleteOpenapiXjhlcOrder

ServiceOpenapiXjhlcOrderService#delete （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#deleteById ⇒ 表 openapi_xjhlc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiXjhlcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiXjhlcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiXjhlcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_xjhlc_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiXjhlcOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiXjhlcOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiXjhlcOrder 未使用管理后台 #

雪域水寨记录-详情 · OpenapiXjhlcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXjhlcOrderController#getOpenapiXjhlcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xjhlc_order

ControllerOpenapiXjhlcOrderController#getOpenapiXjhlcOrder

ServiceOpenapiXjhlcOrderService#get （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#selectById ⇒ 表 openapi_xjhlc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiXjhlcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiXjhlcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiXjhlcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_xjhlc_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiXjhlcOrderResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_xjhlc_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiXjhlcOrder

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiXjhlcOrderService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiXjhlcOrderList 未使用管理后台 #

雪域水寨记录-列表查询 · OpenapiXjhlcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXjhlcOrderController#queryOpenapiXjhlcOrderList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xjhlc_order

ControllerOpenapiXjhlcOrderController#queryOpenapiXjhlcOrderList

转换BeanUtils.map → OpenapiXjhlcOrderQuery

ServiceOpenapiXjhlcOrderService#queryList （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#selectList ⇒ 表 openapi_xjhlc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiXjhlcOrderList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXjhlcOrderList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXjhlcOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXjhlcOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiXjhlcOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_xjhlc_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiXjhlcOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiXjhlcOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiXjhlcOrderPage 未使用管理后台 #

雪域水寨记录-分页查询 · OpenapiXjhlcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXjhlcOrderController#queryOpenapiXjhlcOrderPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xjhlc_order

ControllerOpenapiXjhlcOrderController#queryOpenapiXjhlcOrderPage

转换BeanUtils.map → OpenapiXjhlcOrderQuery

ServiceOpenapiXjhlcOrderService#queryPage （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#selectPage ⇒ 表 openapi_xjhlc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiXjhlcOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXjhlcOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiXjhlcOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXjhlcOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiXjhlcOrderResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_xjhlc_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiXjhlcOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiXjhlcOrderService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiXjhlcOrder 未使用管理后台 #

雪域水寨记录-更新 · OpenapiXjhlcOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiXjhlcOrderController#updateOpenapiXjhlcOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xjhlc_order

ControllerOpenapiXjhlcOrderController#updateOpenapiXjhlcOrder

转换BeanUtils.map → OpenapiXjhlcOrder ⇒ 表 openapi_xjhlc_order

ServiceOpenapiXjhlcOrderService#update （OpenapiXjhlcOrderServiceImpl）

MapperOpenapiXjhlcOrderMapper#updateById ⇒ 表 openapi_xjhlc_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiXjhlcOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiXjhlcOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiXjhlcOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiXjhlcOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_xjhlc_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiXjhlcOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiXjhlcOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiYbxOrderController 0/6 在用

POST /openapi/addOpenapiYbxOrder 未使用管理后台 #

游宝星订单表-新增 · OpenapiYbxOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxOrderController#addOpenapiYbxOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_order

ControllerOpenapiYbxOrderController#addOpenapiYbxOrder

转换BeanUtils.map → OpenapiYbxOrder ⇒ 表 openapi_ybx_order

ServiceOpenapiYbxOrderService#add （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#insert ⇒ 表 openapi_ybx_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiYbxOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiYbxOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiYbxOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxOrderAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiYbxOrder

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiYbxOrderService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiYbxOrder 未使用管理后台 #

游宝星订单表-删除 · OpenapiYbxOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxOrderController#deleteOpenapiYbxOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_order

ControllerOpenapiYbxOrderController#deleteOpenapiYbxOrder

ServiceOpenapiYbxOrderService#delete （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#deleteById ⇒ 表 openapi_ybx_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiYbxOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiYbxOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiYbxOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ybx_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiYbxOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiYbxOrderService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiYbxOrder 未使用管理后台 #

游宝星订单表-详情 · OpenapiYbxOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxOrderController#getOpenapiYbxOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_order

ControllerOpenapiYbxOrderController#getOpenapiYbxOrder

ServiceOpenapiYbxOrderService#get （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#selectById ⇒ 表 openapi_ybx_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiYbxOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiYbxOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiYbxOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ybx_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiYbxOrderResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ybx_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiYbxOrder

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiYbxOrderService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiYbxOrderList 未使用管理后台 #

游宝星订单表-列表查询 · OpenapiYbxOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxOrderController#queryOpenapiYbxOrderList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_order

ControllerOpenapiYbxOrderController#queryOpenapiYbxOrderList

转换BeanUtils.map → OpenapiYbxOrderQuery

ServiceOpenapiYbxOrderService#queryList （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#selectList ⇒ 表 openapi_ybx_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiYbxOrderList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxOrderList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxOrderList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxOrderListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiYbxOrderResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_ybx_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiYbxOrderList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiYbxOrderService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiYbxOrderPage 未使用管理后台 #

游宝星订单表-分页查询 · OpenapiYbxOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxOrderController#queryOpenapiYbxOrderPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_order

ControllerOpenapiYbxOrderController#queryOpenapiYbxOrderPage

转换BeanUtils.map → OpenapiYbxOrderQuery

ServiceOpenapiYbxOrderService#queryPage （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#selectPage ⇒ 表 openapi_ybx_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiYbxOrderPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxOrderPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxOrderPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxOrderPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiYbxOrderResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_ybx_order`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiYbxOrderPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiYbxOrderService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiYbxOrder 未使用管理后台 #

游宝星订单表-更新 · OpenapiYbxOrderController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxOrderController#updateOpenapiYbxOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_order

ControllerOpenapiYbxOrderController#updateOpenapiYbxOrder

转换BeanUtils.map → OpenapiYbxOrder ⇒ 表 openapi_ybx_order

ServiceOpenapiYbxOrderService#update （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#updateById ⇒ 表 openapi_ybx_order

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiYbxOrder
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiYbxOrder
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiYbxOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxOrderUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ybx_order`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiYbxOrder

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiYbxOrderService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

OpenapiYbxTicketController 0/6 在用

POST /openapi/addOpenapiYbxTicket 未使用管理后台 #

游宝星门票表-新增 · OpenapiYbxTicketController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxTicketController#addOpenapiYbxTicket
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_ticket

ControllerOpenapiYbxTicketController#addOpenapiYbxTicket

转换BeanUtils.map → OpenapiYbxTicket ⇒ 表 openapi_ybx_ticket

ServiceOpenapiYbxTicketService#add （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#insert ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addOpenapiYbxTicket
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiYbxTicket
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addOpenapiYbxTicket	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxTicketAddRequest

字段	类型	必填	取值/校验	表 / 列	说明
name	String			—	名称

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/addOpenapiYbxTicket

{
  "body": {
    "name": ""
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要新增（openapiYbxTicketService.add）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteOpenapiYbxTicket 未使用管理后台 #

游宝星门票表-删除 · OpenapiYbxTicketController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxTicketController#deleteOpenapiYbxTicket
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_ticket

ControllerOpenapiYbxTicketController#deleteOpenapiYbxTicket

ServiceOpenapiYbxTicketService#delete （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#deleteById ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteOpenapiYbxTicket
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiYbxTicket
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteOpenapiYbxTicket	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ybx_ticket`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/deleteOpenapiYbxTicket

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要删除（openapiYbxTicketService.delete）

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getOpenapiYbxTicket 未使用管理后台 #

游宝星门票表-详情 · OpenapiYbxTicketController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxTicketController#getOpenapiYbxTicket
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_ticket

ControllerOpenapiYbxTicketController#getOpenapiYbxTicket

ServiceOpenapiYbxTicketService#get （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#selectById ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getOpenapiYbxTicket
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiYbxTicket
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getOpenapiYbxTicket	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long	是	必填	`openapi_ybx_ticket`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiYbxTicketResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ybx_ticket`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/getOpenapiYbxTicket

{
  "body": {
    "id": 1
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1
  }
}

处理逻辑

逻辑摘要查询详情（openapiYbxTicketService.get）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiYbxTicketList 未使用管理后台 #

游宝星门票表-列表查询 · OpenapiYbxTicketController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxTicketController#queryOpenapiYbxTicketList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_ticket

ControllerOpenapiYbxTicketController#queryOpenapiYbxTicketList

转换BeanUtils.map → OpenapiYbxTicketQuery

ServiceOpenapiYbxTicketService#queryList （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#selectList ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiYbxTicketList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxTicketList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxTicketList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxTicketListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<OpenapiYbxTicketResponse>　（list）

字段	类型	必填	取值/校验	表 / 列	说明
[ ]	array			—	列表，元素结构见下
id	Long			`openapi_ybx_ticket`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiYbxTicketList

{
  "body": {
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "id": 1
    }
  ]
}

处理逻辑

逻辑摘要列表查询（openapiYbxTicketService.queryList）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryOpenapiYbxTicketPage 未使用管理后台 #

游宝星门票表-分页查询 · OpenapiYbxTicketController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxTicketController#queryOpenapiYbxTicketPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_ticket

ControllerOpenapiYbxTicketController#queryOpenapiYbxTicketPage

转换BeanUtils.map → OpenapiYbxTicketQuery

ServiceOpenapiYbxTicketService#queryPage （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#selectPage ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryOpenapiYbxTicketPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxTicketPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryOpenapiYbxTicketPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxTicketPageRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
keywords	String	否	可选(@MvcOptional)	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<OpenapiYbxTicketResponse>　（page）

字段	类型	表 / 列	说明
list / records	array	—	分页列表，元素结构见下
total	long	—	总条数（PageInfo）
id	Long	`openapi_ybx_ticket`.`id`	id

示例

请求示例（自动生成，仅结构参考）

POST /openapi/queryOpenapiYbxTicketPage

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "keywords": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要分页查询（openapiYbxTicketService.queryPage）；入参与返回值经 BeanUtils 做对象/分页映射

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateOpenapiYbxTicket 未使用管理后台 #

游宝星门票表-更新 · OpenapiYbxTicketController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenapiYbxTicketController#updateOpenapiYbxTicket
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_ticket

ControllerOpenapiYbxTicketController#updateOpenapiYbxTicket

转换BeanUtils.map → OpenapiYbxTicket ⇒ 表 openapi_ybx_ticket

ServiceOpenapiYbxTicketService#update （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#updateById ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateOpenapiYbxTicket
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiYbxTicket
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateOpenapiYbxTicket	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　OpenapiYbxTicketUpdateRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			`openapi_ybx_ticket`.`id`	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /openapi/updateOpenapiYbxTicket

{
  "body": {
    "id": 1
  }
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要更新（openapiYbxTicketService.update）；入参与返回值经 BeanUtils 做对象/分页映射

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

PingXiangController 2/5 在用

POST /pingXiang/login 在用开放/回调 #

（无摘要） · PingXiangController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.PingXiangController#cibLogin
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member

ControllerPingXiangController#cibLogin

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

RedisCacheService.getMemberService.getMemberRedisCacheService.delete

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/pingXiang/login
uat	https://dscp-uat.hn12301.net/open-api/pingXiang/login
pro	https://dscp-uat.hn12301.net/open-api/pingXiang/login	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CibLoginRequest

字段	类型	必填	取值/校验	表 / 列	说明
mobile	String	是	必填	`member`.`mobile`	手机号
password	String	是	必填	`member`.`password`	密码
verifyCode	String	是	必填	—	验证码

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	—
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /pingXiang/login

{
  "body": {
    "mobile": "13800000000",
    "password": "",
    "verifyCode": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要查询详情（redisCacheService.get）；查询详情（authService.getAuthValue）；调用 isBlank（StrUtil.isBlank）

内联注释

1. 验证短信验证码
String cachedCode = (String) authService.getAuthValue(cacheKey);
查询用户信息
验证通过后删除缓存中的验证码，防止重复使用
返回成功响应

前端调用方

hhrs Login exact

POST /pingXiang/refund 未使用管理后台 #

（无摘要） · PingXiangController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.PingXiangController#refund
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表ordermember

ControllerPingXiangController#refund

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

LockService.tryLockPxPayProperties.getCardRefundCallbackUrlPingXiangPayService.refundRefundService.createLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/pingXiang/refund
uat	https://dscp-uat.hn12301.net/manage-api/pingXiang/refund
pro	https://dscp-uat.hn12301.net/manage-api/pingXiang/refund	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	orderNo	String	是		—

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

void —— 无返回数据

示例

请求示例（自动生成，仅结构参考）

POST /pingXiang/refund?orderNo=…

响应示例

（void，无响应体）

处理逻辑

逻辑摘要调用 tryLock（lockService.tryLock）；查询详情（orderService.get）；查询详情（memberService.get）

内联注释

查询订单状态
1. 立即检查状态
退款成功处理逻辑

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pingXiang/sendLoginVerifyCode 在用开放/回调 #

（无摘要） · PingXiangController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.PingXiangController#sendVerifyCode
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表sms_log

ControllerPingXiangController#sendVerifyCode

ServiceSmsLogService#add （SmsLogServiceImpl）

MapperSmsLogMapper#insert ⇒ 表 sms_log

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 4

CacheService.putIfAbsentRedisCacheService.putSendSmsService.sendVerifyCodeSmsService.sendSms

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/pingXiang/sendLoginVerifyCode
uat	https://dscp-uat.hn12301.net/open-api/pingXiang/sendLoginVerifyCode
pro	https://dscp-uat.hn12301.net/open-api/pingXiang/sendLoginVerifyCode	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　VerifyCodeSendRequest

字段	类型	必填	取值/校验	表 / 列	说明
smsType	SmsType		1兴业银行激活平台登录2兴业银行激活平台激活3兴业银行H5登录99未知	`sms_log`.`sms_type`	发送验证码类型
mobile	String			—	手机号

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　OpenapiResponse　（object）

字段	类型	表 / 列
code	Integer	`sms_log`.`code`
msg	String	—
data	Object	—

示例

请求示例（自动生成，仅结构参考）

POST /pingXiang/sendLoginVerifyCode

{
  "body": {
    "smsType": "1",
    "mobile": "13800000000"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": 0,
    "msg": "",
    "data": ""
  }
}

处理逻辑

逻辑摘要调用 putIfAbsent（cacheService.putIfAbsent）；调用 randomNumbers（RandomUtil.randomNumbers）；调用 put（redisCacheService.put）

内联注释

查询是否可发送
生成随机验证码
验证码放入session缓存
发送短信
记录短信发送日志 - 使用现有的SmsLog

前端调用方

hhrs SendVerifyCode exact

POST /pingXiang/wePay/appointmentNotify 未使用开放/回调 #

平祥-微信支付回调（预约支付结果） · PingXiangController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.PingXiangController#appointmentNotify
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerPingXiangController#appointmentNotify

ServicepingXiangPayService#payCallback

ServicecardAppointmentPaymentService#get

MapperCardAppointmentPaymentMapper#get ⇒ 表 card_appointment_payment

ServicecardAppointmentPaymentService#update

MapperCardAppointmentPaymentMapper#update ⇒ 表 card_appointment_payment

ServicecardBagService#handlerAppoint

ServicecardBagService#refundAppointmentOrder

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/pingXiang/wePay/appointmentNotify
uat	https://dscp-uat.hn12301.net/open-api/pingXiang/wePay/appointmentNotify
pro	https://dscp-uat.hn12301.net/open-api/pingXiang/wePay/appointmentNotify	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

无（该方法不从请求体取参）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

（无请求体）

响应示例

（void，无响应体）

处理逻辑

逻辑摘要pingXiangPayService.payCallback；lockService.tryLock；cardAppointmentPaymentService.get；cardAppointmentPaymentService.update；cardBagService.handlerAppoint；cardBagService.refundAppointmentOrder；lockService.unlock（辅助：lockService.tryLock、lockService.unlock）；完整实现见源码 PingXiangController#appointmentNotify

内联注释

查询订单
判断订单状态
更新订单信息
调用预约接口
预约失败退款退款

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /pingXiang/wePay/appointmentRefundNotify 未使用开放/回调 #

平祥-微信支付回调（预约退款结果） · PingXiangController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.PingXiangController#appointmentRefundNotify
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表card_appointment_payment

ControllerPingXiangController#appointmentRefundNotify

ServicepingXiangPayService#refundCallback

ServicecardAppointmentPaymentService#get

MapperCardAppointmentPaymentMapper#get ⇒ 表 card_appointment_payment

ServicecardAppointmentPaymentService#update

MapperCardAppointmentPaymentMapper#update ⇒ 表 card_appointment_payment

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/pingXiang/wePay/appointmentRefundNotify
uat	https://dscp-uat.hn12301.net/open-api/pingXiang/wePay/appointmentRefundNotify
pro	https://dscp-uat.hn12301.net/open-api/pingXiang/wePay/appointmentRefundNotify	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

无（该方法不从请求体取参）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

（无请求体）

响应示例

（void，无响应体）

处理逻辑

逻辑摘要pingXiangPayService.refundCallback；lockService.tryLock；cardAppointmentPaymentService.get；cardAppointmentPaymentService.update；lockService.unlock（辅助：lockService.tryLock、lockService.unlock）；完整实现见源码 PingXiangController#appointmentRefundNotify

内联注释

查询订单
判断订单状态
更新订单信息

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

TstcController 0/1 在用

POST /tstc/refund 未使用管理后台 #

（无摘要） · TstcController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.TstcController#refundOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表orderopenapi_tstc_orderafter_salesorder_after_sales_operationlog

ControllerTstcController#refundOrder

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOpenapiTstcOrderService#queryList （OpenapiTstcOrderServiceImpl）

MapperOpenapiTstcOrderMapper#selectList ⇒ 表 openapi_tstc_order

ServiceOrderPaymentService#wechatRefund （OrderPaymentServiceImpl）

ServiceAfterSalesService#update （AfterSalesServiceImpl）

MapperAfterSalesMapper#updateById ⇒ 表 after_sales

ServiceOrderAfterSalesOperationlogService#add （OrderAfterSalesOperationlogServiceImpl）

MapperOrderAfterSalesOperationlogMapper#insert ⇒ 表 order_after_sales_operationlog

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 5

OrderService.mustGetPayBackProperties.getCardRefundCallbackUrlWechatJsapiRefundService.refundChaosTransactionTemplate.executeSessionUserService.getSessionId

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/tstc/refund
uat	https://dscp-uat.hn12301.net/manage-api/tstc/refund
pro	https://dscp-uat.hn12301.net/manage-api/tstc/refund	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
orderNo	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghResponse　（object）

字段	类型	表 / 列
accessToken	String	—
code	Integer	`openapi_tstc_order`.`code`
message	String	—
isMember	boolean	—
memberLevelType	String	—

示例

请求示例（自动生成，仅结构参考）

POST /tstc/refund

{
  "body": {
    "orderNo": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "accessToken": "",
    "code": 0,
    "message": "",
    "isMember": false,
    "memberLevelType": ""
  }
}

处理逻辑

逻辑摘要查询详情（orderService.get）；列表查询（openapiTstcOrderService.queryList）；调用 ordersRefund（TstcService.ordersRefund）

内联注释

先向天时同城退款
"data":{"orders_log_id":"2512221036590654455","refund_result":"3"}
退单结果：2申请退单成功等待审核，3直接退单成功(同意退，无需审核)，4拒绝退单。注意：返回结果不是审核中时不会进行异步退单结果通知

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

XghController 12/12 在用

POST /xgh/addPurchase 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#addPurchase
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_xgh_purchage

ControllerXghController#addPurchase

ServiceXghService#addPurchase （XghServiceImpl）

转换BeanUtils.map → OpenapiXghPurchage ⇒ 表 openapi_xgh_purchage

ServiceOpenapiXghPurchageService#add （OpenapiXghPurchageServiceImpl）

MapperOpenapiXghPurchageMapper#insert ⇒ 表 openapi_xgh_purchage

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/addPurchase
uat	https://dscp-uat.hn12301.net/open-api/xgh/addPurchase
pro	https://dscp-uat.hn12301.net/open-api/xgh/addPurchase	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　XghAddPurchageRequest

字段	类型	表 / 列	说明
operatorMobile	String	`openapi_xgh_purchage`.`operator_mobile`
name	String	`openapi_xgh_purchage`.`name`	名称
address	String	`openapi_xgh_purchage`.`address`
shuihao	String	`openapi_xgh_purchage`.`shuihao`	税号
contact	String	`openapi_xgh_purchage`.`contact`	联系人
contactMobile	String	`openapi_xgh_purchage`.`contact_mobile`
purchageNum	Integer	`openapi_xgh_purchage`.`purchage_num`	采购数量

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghResponse　（object）

字段	类型	表 / 列
accessToken	String	—
code	Integer	—
message	String	—
isMember	boolean	—
memberLevelType	String	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/addPurchase

{
  "body": {
    "operatorMobile": "13800000000",
    "name": "",
    "address": "",
    "shuihao": "",
    "contact": "",
    "contactMobile": "13800000000",
    "purchageNum": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "accessToken": "",
    "code": 0,
    "message": "",
    "isMember": false,
    "memberLevelType": ""
  }
}

处理逻辑

逻辑摘要新增（xghService.addPurchase）

前端调用方

xghmall addPurchase exact

POST /xgh/cardModelDetail 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#cardModelDetail
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goods_infoskuopenapi_channel_rule

ControllerXghController#cardModelDetail

ServiceXghService#cardModelDetail （XghServiceImpl）

ServiceGoodsInfoService#get （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectById ⇒ 表 goods_info

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceOpenapiChannelRuleService#get （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectById ⇒ 表 openapi_channel_rule

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

GoodsCache.getCardModelCache.getShopCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/cardModelDetail
uat	https://dscp-uat.hn12301.net/open-api/xgh/cardModelDetail
pro	https://dscp-uat.hn12301.net/open-api/xgh/cardModelDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	goodsId	String	是		`sku`.`goods_id`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ChannelCardDetail　（object）

字段	类型	取值/校验	表 / 列	说明
cardModel	CardModel		—
cardModel.id	Long		`goods_info`.`id`	旅游卡种ID，主键
cardModel.name	String		—	卡种名称
cardModel.grade	ModelGrade	11一类卡，2二类卡，3公式卡2二类卡3公式卡	—	卡种等级(枚举:card.ModelGrade)，1一类卡，2二类卡
cardModel.cardModelType	CardModelType	1省级旅游卡2市州旅游卡	—	卡种类型(枚举:card.CardModelType)，1省级旅游卡，2市州旅游卡
cardModel.code	Integer		—	卡种编号: 2 位数，从10 开始。10、11、12、顺序编号。
cardModel.merchantId	Long		`sku`.`merchant_id`	所属商户
cardModel.shopId	Long		`sku`.`shop_id`	所属商铺，关联商铺表id
cardModel.shopName	String		—	所属商铺名称
cardModel.channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_rule`.`channel`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
cardModel.thirdId	String		—	第三方id
cardModel.price	Integer		`openapi_channel_rule`.`price`	卡种售价
cardModel.expireDate	Date		`goods_info`.`expire_date`	失效日期
cardModel.publishDate	Date		—	发行日期
cardModel.isFace	Boolean		—	是否需要人脸
cardModel.isActiveCode	Boolean		—	是否需要激活码
cardModel.isRefresh	Boolean		—	二维码是否刷新
cardModel.propagateStyle	String		—	宣传卡样url地址
cardModel.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
cardModel.propagateVid	String		—	宣传视频url地址
cardModel.description	String		—	图文详情
cardModel.isDeleted	Boolean		`goods_info`.`is_deleted`	是否删除
cardModel.createdBy	Long		`goods_info`.`created_by`	创建人id
cardModel.createdTime	Date		`goods_info`.`created_time`	创建时间
cardModel.updatedBy	Long		`goods_info`.`updated_by`	更新人id
cardModel.updatedTime	Date		`goods_info`.`updated_time`	修改时间
goods	Goods		—
goods.id	Long		`goods_info`.`id`	商品id，主键
goods.merchantId	Long		`sku`.`merchant_id`	所属商户id，关联merchant表id
goods.shopId	Long		`sku`.`shop_id`	所属商铺id
goods.name	String		—	商品名称
goods.cardModelId	Long		`openapi_channel_rule`.`card_model_id`	旅游卡ID，关联旅游卡表id
goods.mainPic	String		—	商品主图
goods.typeId	String		`openapi_channel_rule`.`type_id`	商品大类
goods.subTypeId	String		—	商品小类
goods.grade	String		—	商品等级
goods.status	GoodsStatus	1已上架2编辑中3已下架	`openapi_channel_rule`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
goods.qrcode	String		—	商品二维码
goods.isDeleted	Boolean		`goods_info`.`is_deleted`	是否删除
goods.createdBy	Long		`goods_info`.`created_by`	创建人
goods.createdTime	Date		`goods_info`.`created_time`	创建时间
goods.updatedBy	Long		`goods_info`.`updated_by`	修改人
goods.updatedTime	Date		`goods_info`.`updated_time`	修改时间
goods.thirdId	String		—	第三方id
goods.thirdName	String		—	第三方名称
goodsInfo	GoodsInfo		—
goodsInfo.id	Long		`goods_info`.`id`	商品id，主键
goodsInfo.shortName	String		`goods_info`.`short_name`	商品简称
goodsInfo.weight	Integer		`goods_info`.`weight`	商品权重
goodsInfo.tags	String		`goods_info`.`tags`	商品标签
goodsInfo.businessTime	String		`goods_info`.`business_time`	营业时间
goodsInfo.recommendReason	String		`goods_info`.`recommend_reason`	推荐理由
goodsInfo.introduction	String		`goods_info`.`introduction`	简介
goodsInfo.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
goodsInfo.video	String		`goods_info`.`video`	宣传视频url地址
goodsInfo.notice	String		`goods_info`.`notice`	购买须知
goodsInfo.tips	String		`goods_info`.`tips`	温馨提示
goodsInfo.expireDate	Date		`goods_info`.`expire_date`
goodsInfo.isRefund	Boolean		`goods_info`.`is_refund`
goodsInfo.isDeleted	Boolean		`goods_info`.`is_deleted`	是否删除
goodsInfo.createdBy	String		`goods_info`.`created_by`	创建人id
goodsInfo.createdTime	LocalDateTime		`goods_info`.`created_time`	创建时间
goodsInfo.updatedBy	String		`goods_info`.`updated_by`	更新人id
goodsInfo.updatedTime	LocalDateTime		`goods_info`.`updated_time`	更新时间
sku	List<Sku>		—
sku[].id	Long		`goods_info`.`id`	商品skuID，主键
sku[].merchantId	Long		`sku`.`merchant_id`	所属商户id
sku[].shopId	Long		`sku`.`shop_id`	所属商铺id
sku[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
sku[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
sku[].skuName	String		`sku`.`sku_name`	sku名称
sku[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
sku[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
sku[].costPrice	Integer		`sku`.`cost_price`	商品成本价
sku[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
sku[].stock	Integer		`sku`.`stock`	库存数量
sku[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
sku[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
sku[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
sku[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
sku[].commission	Integer		`sku`.`commission`	分销佣金
sku[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
sku[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
sku[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
sku[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
sku[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
sku[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
sku[].isDeleted	Boolean		`goods_info`.`is_deleted`	是否删除
sku[].createdBy	String		`goods_info`.`created_by`	创建人id
sku[].createdTime	Date		`goods_info`.`created_time`	创建时间
sku[].updatedBy	String		`goods_info`.`updated_by`	更新人id
sku[].updatedTime	Date		`goods_info`.`updated_time`	修改时间
shop	Shop		—
shop.id	Long		`goods_info`.`id`	商铺id，主键
shop.merchantId	Long		`sku`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		—	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		`openapi_channel_rule`.`type_id`	商铺大类
shop.subTypeId	Long		—	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`openapi_channel_rule`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		—	省id
shop.cityId	String		—	市id
shop.districtId	String		—	区县id
shop.address	String		—	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		`goods_info`.`introduction`	简介
shop.businessTime	String		`goods_info`.`business_time`	营业时间
shop.tags	String		`goods_info`.`tags`	商铺标签
shop.mainPic	String		—	景区主图url地址
shop.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
shop.video	String		`goods_info`.`video`	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		—	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		`goods_info`.`tips`	温馨提示
shop.isDeleted	Boolean		`goods_info`.`is_deleted`	是否删除
shop.createdBy	String		`goods_info`.`created_by`	创建人id
shop.createdTime	Date		`goods_info`.`created_time`	创建时间
shop.updatedBy	String		`goods_info`.`updated_by`	更新人id
shop.updatedTime	Date		`goods_info`.`updated_time`	修改时间
shop.thirdId	String		—
shop.thirdName	String		—
salesNum	Integer		—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/cardModelDetail?goodsId=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "cardModel": {
      "id": 1,
      "name": "",
      "grade": "1",
      "cardModelType": "1",
      "code": 0,
      "merchantId": 1,
      "shopId": 1,
      "shopName": "",
      "channel": "1",
      "thirdId": "",
      "price": 0,
      "expireDate": "2026-01-01 12:00:00",
      "publishDate": "2026-01-01 12:00:00",
      "isFace": false,
      "isActiveCode": false,
      "isRefresh": false,
      "propagateStyle": "",
      "propagatePic": "https://example.com/x.png",
      "propagateVid": "",
      "description": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00"
    },
    "goods": {
      "id": 1,
      "merchantId": 1,
      "shopId": 1,
      "name": "",
      "cardModelId": 1,
      "mainPic": "https://example.com/x.png",
      "typeId": "",
      "subTypeId": "",
      "grade": "",
      "status": "1",
      "qrcode": "",
      "isDeleted": false,
      "createdBy": 0,
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": 0,
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    },
    "goodsInfo": {
      "id": 1,
      "shortName": "",
      "weight": 0,
      "tags": "",
      "businessTime": "2026-01-01 12:00:00",
      "recommendReason": "",
      "introduction": "",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "notice": "",
      "tips": "",
      "expireDate": "2026-01-01 12:00:00",
      "isRefund": false,
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00"
    },
    "sku": [
      {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "goodsId": 1,
        "goodsChannelId": 1,
        "skuName": "",
        "showPrice": 0,
        "buyPrice": 0,
        "costPrice": 0,
        "buyCount": 0,
        "stock": 0,
        "isLogistic": false,
        "carriageId": 1,
        "mold": "1",
        "isDistributes": false,
        "commission": 0,
        "isPreferential": false,
        "isUseScore": false,
        "isAddScore": false,
        "useScoreRate": 0,
        "addScoreRate": 0,
        "cardNum": 0,
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      }
    ],
    "shop": {
      "id": 1,
      "merchantId": 1,
      "merchantType": "1",
      "name": "",
      "logo": "",
      "typeId": 1,
      "subTypeId": 1,
      "status": "1",
      "provinceId": "",
      "cityId": "",
      "districtId": "",
      "address": "",
      "mobile": "13800000000",
      "linkman": "",
      "linkphone": "13800000000",
      "manager": "",
      "level": "",
      "lng": "",
      "lat": "",
      "introduction": "",
      "businessTime": "2026-01-01 12:00:00",
      "tags": "",
      "mainPic": "https://example.com/x.png",
      "propagatePic": "https://example.com/x.png",
      "video": "",
      "poster": "",
      "propagateContent": "",
      "description": "",
      "ticketInfo": "",
      "trafficInfo": "",
      "tips": "",
      "isDeleted": false,
      "createdBy": "",
      "createdTime": "2026-01-01 12:00:00",
      "updatedBy": "2026-01-01 12:00:00",
      "updatedTime": "2026-01-01 12:00:00",
      "thirdId": "",
      "thirdName": ""
    },
    "salesNum": 0
  }
}

处理逻辑

逻辑摘要调用 cardModelDetail（xghService.cardModelDetail）

前端调用方

xghmall cardModelDetail exact

POST /xgh/createOrder 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#createOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表ordermemberorder_goodscard_model_ruleorder_operatelogcard_stock

ControllerXghController#createOrder

ServiceXghService#createOrder （XghServiceImpl）

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceOrderService#queryList （OrderServiceImpl）

MapperOrderMapper#selectList ⇒ 表 order

ServiceOrderGoodsService#queryList （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#selectList ⇒ 表 order_goods

ServiceCardModelRuleService#get （CardModelRuleServiceImpl）

MapperCardModelRuleMapper#selectById ⇒ 表 card_model_rule

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

ServiceCardService#addCardOrder （CardServiceImpl）

转换BeanUtils.map → OrderOperatelog ⇒ 表 order_operatelog

MapperCardStockService.getMapper#selectList ⇒ 表 card_stock

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 14

SkuCache.getLockService.tryLockCardModelCache.getMemberService.getOpenapiChannelRuleService.getOrderService.maxOrderIdChaosTransactionTemplate.executePromotionCouponService.getCouponPromotionCouponService.useCouponOrderService.addGoodsCache.getOrderGoodsService.addOrderOperatelogService.addLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/createOrder
uat	https://dscp-uat.hn12301.net/open-api/xgh/createOrder
pro	https://dscp-uat.hn12301.net/open-api/xgh/createOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ChannelCreateOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
cardModleId	Long	是	必填	—
buyNum	Integer	是	必填	`order`.`buy_num`	购买份数
skuId	Long	是	必填	—	SKUID
mobile	String	是	必填	`member`.`mobile`
couponId	Long			—	券id
userId	String			—
certNo	String			—
realName	String			—
phone	String			—
certId	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ChannelPrePayResponse　（object）

字段	类型	表 / 列	说明
outTradeNo	String	—	我方交易号
tradeNo	String	—	第三方交易号
flag	Boolean	—
payUrl	String	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/createOrder

{
  "body": {
    "cardModleId": 1,
    "buyNum": 0,
    "skuId": 1,
    "mobile": "13800000000",
    "couponId": 1,
    "userId": "",
    "certNo": "",
    "realName": "",
    "phone": "13800000000",
    "certId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "outTradeNo": "",
    "tradeNo": "",
    "flag": false,
    "payUrl": "https://example.com/x.png"
  }
}

处理逻辑

逻辑摘要调用 canOrderOrOperate（DateUtils.canOrderOrOperate）；调用 canOrderOrOperateMsg（DateUtils.canOrderOrOperateMsg）；创建（xghService.createOrder）

内联注释

throw ChaosRes.SYS_FAIL.toException("制卡中");
}
if (!DateUtils.canOrderOrOperate()) {
throw ChaosRes.SYS_FAIL.toException(DateUtils.canOrderOrOperateMsg());
throw ChaosRes.SYS_FAIL.toException("系统升级中，预计22:00完成。请稍后再试！");

前端调用方

xghmall createOrder exact

POST /xgh/getOrder 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#getOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表orderopenapi_channel_card

ControllerXghController#getOrder

ServiceZfbCardService#getOrder （ZfbCardServiceImpl）

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOpenapiChannelCardService#queryList （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#selectList ⇒ 表 openapi_channel_card

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

OrderGoodsService.mustGetGoodsCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/getOrder
uat	https://dscp-uat.hn12301.net/open-api/xgh/getOrder
pro	https://dscp-uat.hn12301.net/open-api/xgh/getOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	orderId	String	是		`order`.`order_id`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　CardOrderResponse　（object）

字段	类型	取值/校验	表 / 列	说明
id	Long		`order`.`id`	主键
orderId	Long		`order`.`order_id`	订单Id，主键
orderName	String		—	订单旅游卡（商品）名称
orderPic	String		—	订单旅游卡（商品）主图
buyNum	Integer		`order`.`buy_num`	购买份数
goodsAmount	Integer		—	商品金额
payableAmount	Integer		`order`.`payable_amount`	实收金额
payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`order`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	`order`.`order_status`	订单状态
orderTime	Date		`order`.`order_time`	下单时间
payTime	Date		—	支付时间
cardNum	String		—	卡号

示例

请求示例（自动生成，仅结构参考）

POST /xgh/getOrder?orderId=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "id": 1,
    "orderId": 1,
    "orderName": "",
    "orderPic": "https://example.com/x.png",
    "buyNum": 0,
    "goodsAmount": 0,
    "payableAmount": 0,
    "payStatus": "1",
    "orderStatus": "1",
    "orderTime": "2026-01-01 12:00:00",
    "payTime": "2026-01-01 12:00:00",
    "cardNum": ""
  }
}

处理逻辑

逻辑摘要查询详情（zfbService.getOrder）

前端调用方

xghmall queryOrder exact

POST /xgh/getUserInfo 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#getUserInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member

ControllerXghController#getUserInfo

ServiceXghService#getUserInfo （XghServiceImpl）

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/getUserInfo
uat	https://dscp-uat.hn12301.net/open-api/xgh/getUserInfo
pro	https://dscp-uat.hn12301.net/open-api/xgh/getUserInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	xghAuthCode	String			—
query	certNo	String			—

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghUserInfo　（object）

字段	类型	表 / 列
userId	String	—
phone	String	—
openId	String	`member`.`open_id`
isMember	Boolean	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/getUserInfo?xghAuthCode=…&certNo=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "userId": "",
    "phone": "13800000000",
    "openId": "",
    "isMember": false
  }
}

处理逻辑

逻辑摘要查询详情（xghService.getUserInfo）

前端调用方

xghmall getUserInfo exact

POST /xgh/isXghCouponMember 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#isXghCouponMember
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerXghController#isXghCouponMember

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

XghService.isXghCouponMember

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/isXghCouponMember
uat	https://dscp-uat.hn12301.net/open-api/xgh/isXghCouponMember
pro	https://dscp-uat.hn12301.net/open-api/xgh/isXghCouponMember	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　XghIsMemberRequest

字段	类型	必填	取值/校验	表 / 列	说明
phone	String			—
xghUserId	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghResponse　（object）

字段	类型	表 / 列
accessToken	String	—
code	Integer	—
message	String	—
isMember	boolean	—
memberLevelType	String	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/isXghCouponMember

{
  "body": {
    "phone": "13800000000",
    "xghUserId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "accessToken": "",
    "code": 0,
    "message": "",
    "isMember": false,
    "memberLevelType": ""
  }
}

处理逻辑

逻辑摘要调用 isXghCouponMember（xghService.isXghCouponMember）

前端调用方

xghmall isXghCouponMember exact

POST /xgh/isXghMember 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#isXghMember
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerXghController#isXghMember

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

XghService.isXghMember

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/isXghMember
uat	https://dscp-uat.hn12301.net/open-api/xgh/isXghMember
pro	https://dscp-uat.hn12301.net/open-api/xgh/isXghMember	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　XghIsMemberRequest

字段	类型	必填	取值/校验	表 / 列	说明
phone	String			—
xghUserId	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghResponse　（object）

字段	类型	表 / 列
accessToken	String	—
code	Integer	—
message	String	—
isMember	boolean	—
memberLevelType	String	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/isXghMember

{
  "body": {
    "phone": "13800000000",
    "xghUserId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "accessToken": "",
    "code": 0,
    "message": "",
    "isMember": false,
    "memberLevelType": ""
  }
}

处理逻辑

逻辑摘要调用 isXghMember（xghService.isXghMember）

前端调用方

xghmall isXghMember exact

POST /xgh/listOrder 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#listOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表orderopenapi_channel_card

ControllerXghController#listOrder

ServiceZfbCardService#listOrder （ZfbCardServiceImpl）

转换BeanUtils.map → OrderQuery

ServiceOrderService#queryPage （OrderServiceImpl）

MapperOrderMapper#selectPage ⇒ 表 order

ServiceOpenapiChannelCardService#queryList （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#selectList ⇒ 表 openapi_channel_card

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

OrderGoodsService.mustGetGoodsCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/listOrder
uat	https://dscp-uat.hn12301.net/open-api/xgh/listOrder
pro	https://dscp-uat.hn12301.net/open-api/xgh/listOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbListOrderRequest

字段	类型	必填	取值/校验	表 / 列	说明
pageNum	Integer	否		—	页码（继承自框架分页基类 AbstractPageRequest）
pageSize	Integer	否		—	每页条数（继承自框架分页基类 AbstractPageRequest）
orderPhone	String			`order`.`order_phone`
orderStatus	OrderStatus		1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	`order`.`order_status`

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　PageInfo<CardOrderResponse>　（page）

字段	类型	取值/校验	表 / 列	说明
list / records	array		—	分页列表，元素结构见下
total	long		—	总条数（PageInfo）
id	Long		`order`.`id`	主键
orderId	Long		`order`.`order_id`	订单Id，主键
orderName	String		—	订单旅游卡（商品）名称
orderPic	String		—	订单旅游卡（商品）主图
buyNum	Integer		`order`.`buy_num`	购买份数
goodsAmount	Integer		—	商品金额
payableAmount	Integer		`order`.`payable_amount`	实收金额
payStatus	PayStatus	1支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款2已支付3已退款4退款失败5退款中6退款申请	`order`.`pay_status`	支付状态(枚举:order.PayStatus)，1=待支付 2=已支付 3=已退款
orderStatus	OrderStatus	1订单状态(枚举:order.OrderStatus)，1=待确认 2=已支付 2=待发货 3=已发货 4=已完成 5=已取消CONFIRM(2, "已支付"),2CONFIRM(2, "已支付"),3已发货4已完成5已取消6退款中7已退款+1	`order`.`order_status`	订单状态
orderTime	Date		`order`.`order_time`	下单时间
payTime	Date		—	支付时间
cardNum	String		—	卡号

示例

请求示例（自动生成，仅结构参考）

POST /xgh/listOrder

{
  "body": {
    "pageNum": 0,
    "pageSize": 0,
    "orderPhone": "13800000000",
    "orderStatus": "1"
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "records": [
      {
        "id": 1,
        "orderId": 1,
        "orderName": "",
        "orderPic": "https://example.com/x.png",
        "buyNum": 0,
        "goodsAmount": 0,
        "payableAmount": 0,
        "payStatus": "1",
        "orderStatus": "1",
        "orderTime": "2026-01-01 12:00:00",
        "payTime": "2026-01-01 12:00:00",
        "cardNum": ""
      }
    ],
    "total": 0
  }
}

处理逻辑

逻辑摘要调用 listOrder（zfbService.listOrder）

前端调用方

xghmall listOrder exact

POST /xgh/listProduct 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#listProduct
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_ruleskugoods_info

ControllerXghController#listProduct

ServiceXghService#listProduct （XghServiceImpl）

ServiceOpenapiChannelRuleService#queryList （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectList ⇒ 表 openapi_channel_rule

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceGoodsInfoService#get （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectById ⇒ 表 goods_info

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

GoodsCache.getCardModelCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/listProduct
uat	https://dscp-uat.hn12301.net/open-api/xgh/listProduct
pro	https://dscp-uat.hn12301.net/open-api/xgh/listProduct	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<ChannelCardModelInfo>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
goods	Goods		—
goods.id	Long		`openapi_channel_rule`.`id`	商品id，主键
goods.merchantId	Long		`sku`.`merchant_id`	所属商户id，关联merchant表id
goods.shopId	Long		`sku`.`shop_id`	所属商铺id
goods.name	String		—	商品名称
goods.cardModelId	Long		`openapi_channel_rule`.`card_model_id`	旅游卡ID，关联旅游卡表id
goods.mainPic	String		—	商品主图
goods.typeId	String		`openapi_channel_rule`.`type_id`	商品大类
goods.subTypeId	String		—	商品小类
goods.grade	String		—	商品等级
goods.status	GoodsStatus	1已上架2编辑中3已下架	`openapi_channel_rule`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
goods.qrcode	String		—	商品二维码
goods.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
goods.createdBy	Long		`sku`.`created_by`	创建人
goods.createdTime	Date		`sku`.`created_time`	创建时间
goods.updatedBy	Long		`sku`.`updated_by`	修改人
goods.updatedTime	Date		`sku`.`updated_time`	修改时间
goods.thirdId	String		—	第三方id
goods.thirdName	String		—	第三方名称
cardModel	CardModel		—
cardModel.id	Long		`openapi_channel_rule`.`id`	旅游卡种ID，主键
cardModel.name	String		—	卡种名称
cardModel.grade	ModelGrade	11一类卡，2二类卡，3公式卡2二类卡3公式卡	—	卡种等级(枚举:card.ModelGrade)，1一类卡，2二类卡
cardModel.cardModelType	CardModelType	1省级旅游卡2市州旅游卡	—	卡种类型(枚举:card.CardModelType)，1省级旅游卡，2市州旅游卡
cardModel.code	Integer		—	卡种编号: 2 位数，从10 开始。10、11、12、顺序编号。
cardModel.merchantId	Long		`sku`.`merchant_id`	所属商户
cardModel.shopId	Long		`sku`.`shop_id`	所属商铺，关联商铺表id
cardModel.shopName	String		—	所属商铺名称
cardModel.channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_rule`.`channel`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
cardModel.thirdId	String		—	第三方id
cardModel.price	Integer		`openapi_channel_rule`.`price`	卡种售价
cardModel.expireDate	Date		`goods_info`.`expire_date`	失效日期
cardModel.publishDate	Date		—	发行日期
cardModel.isFace	Boolean		—	是否需要人脸
cardModel.isActiveCode	Boolean		—	是否需要激活码
cardModel.isRefresh	Boolean		—	二维码是否刷新
cardModel.propagateStyle	String		—	宣传卡样url地址
cardModel.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
cardModel.propagateVid	String		—	宣传视频url地址
cardModel.description	String		—	图文详情
cardModel.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
cardModel.createdBy	Long		`sku`.`created_by`	创建人id
cardModel.createdTime	Date		`sku`.`created_time`	创建时间
cardModel.updatedBy	Long		`sku`.`updated_by`	更新人id
cardModel.updatedTime	Date		`sku`.`updated_time`	修改时间
goodsInfo	GoodsInfo		—
goodsInfo.id	Long		`openapi_channel_rule`.`id`	商品id，主键
goodsInfo.shortName	String		`goods_info`.`short_name`	商品简称
goodsInfo.weight	Integer		`goods_info`.`weight`	商品权重
goodsInfo.tags	String		`goods_info`.`tags`	商品标签
goodsInfo.businessTime	String		`goods_info`.`business_time`	营业时间
goodsInfo.recommendReason	String		`goods_info`.`recommend_reason`	推荐理由
goodsInfo.introduction	String		`goods_info`.`introduction`	简介
goodsInfo.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
goodsInfo.video	String		`goods_info`.`video`	宣传视频url地址
goodsInfo.notice	String		`goods_info`.`notice`	购买须知
goodsInfo.tips	String		`goods_info`.`tips`	温馨提示
goodsInfo.expireDate	Date		`goods_info`.`expire_date`
goodsInfo.isRefund	Boolean		`goods_info`.`is_refund`
goodsInfo.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
goodsInfo.createdBy	String		`sku`.`created_by`	创建人id
goodsInfo.createdTime	LocalDateTime		`sku`.`created_time`	创建时间
goodsInfo.updatedBy	String		`sku`.`updated_by`	更新人id
goodsInfo.updatedTime	LocalDateTime		`sku`.`updated_time`	更新时间
cardModelType	Integer		—
modelName	String		—
salesNum	Integer		—
skuList	List<Sku>		—
skuList[].id	Long		`openapi_channel_rule`.`id`	商品skuID，主键
skuList[].merchantId	Long		`sku`.`merchant_id`	所属商户id
skuList[].shopId	Long		`sku`.`shop_id`	所属商铺id
skuList[].goodsId	Long		`openapi_channel_rule`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
skuList[].skuName	String		`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer		`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer		`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer		`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
skuList[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
skuList[].isDeleted	Boolean		`sku`.`is_deleted`	是否删除
skuList[].createdBy	String		`sku`.`created_by`	创建人id
skuList[].createdTime	Date		`sku`.`created_time`	创建时间
skuList[].updatedBy	String		`sku`.`updated_by`	更新人id
skuList[].updatedTime	Date		`sku`.`updated_time`	修改时间
createDate	Date		—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/listProduct

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "goods": {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "name": "",
        "cardModelId": 1,
        "mainPic": "https://example.com/x.png",
        "typeId": "",
        "subTypeId": "",
        "grade": "",
        "status": "1",
        "qrcode": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      },
      "cardModel": {
        "id": 1,
        "name": "",
        "grade": "1",
        "cardModelType": "1",
        "code": 0,
        "merchantId": 1,
        "shopId": 1,
        "shopName": "",
        "channel": "1",
        "thirdId": "",
        "price": 0,
        "expireDate": "2026-01-01 12:00:00",
        "publishDate": "2026-01-01 12:00:00",
        "isFace": false,
        "isActiveCode": false,
        "isRefresh": false,
        "propagateStyle": "",
        "propagatePic": "https://example.com/x.png",
        "propagateVid": "",
        "description": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      },
      "goodsInfo": {
        "id": 1,
        "shortName": "",
        "weight": 0,
        "tags": "",
        "businessTime": "2026-01-01 12:00:00",
        "recommendReason": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "notice": "",
        "tips": "",
        "expireDate": "2026-01-01 12:00:00",
        "isRefund": false,
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      },
      "cardModelType": 0,
      "modelName": "",
      "salesNum": 0,
      "skuList": [
        {
          "id": 1,
          "merchantId": 1,
          "shopId": 1,
          "goodsId": 1,
          "goodsChannelId": 1,
          "skuName": "",
          "showPrice": 0,
          "buyPrice": 0,
          "costPrice": 0,
          "buyCount": 0,
          "stock": 0,
          "isLogistic": false,
          "carriageId": 1,
          "mold": "1",
          "isDistributes": false,
          "commission": 0,
          "isPreferential": false,
          "isUseScore": false,
          "isAddScore": false,
          "useScoreRate": 0,
          "addScoreRate": 0,
          "cardNum": 0,
          "isDeleted": false,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ],
      "createDate": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要调用 listProduct（xghService.listProduct）

前端调用方

xghmall listProduct exact

POST /xgh/prepay 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#prepay
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表order_goods

ControllerXghController#prepay

ServiceXghService#prepay （XghServiceImpl）

ServiceOrderGoodsService#get （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#selectById ⇒ 表 order_goods

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 10

LockService.tryLockOrderService.mustGetGoodsCache.getCardModelCache.getCardService.getCardOrderOrderService.getOrderPaymentService.getOrderGoodsService.getGoodsCache.getLockService.unlock

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/prepay
uat	https://dscp-uat.hn12301.net/open-api/xgh/prepay
pro	https://dscp-uat.hn12301.net/open-api/xgh/prepay	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ChannelPrePayRequest

字段	类型	必填	取值/校验	表 / 列	说明
openId	String			—
orderNo	String	是	必填	—	商户订单号
amount	Long	是	必填	—	订单金额，单位为分
description	String			—	商品描述
userId	String			—
type	Integer			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ChannelPrePayResponse　（object）

字段	类型	表 / 列	说明
outTradeNo	String	—	我方交易号
tradeNo	String	—	第三方交易号
flag	Boolean	—
payUrl	String	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/prepay

{
  "body": {
    "openId": "",
    "orderNo": "",
    "amount": 0,
    "description": "",
    "userId": "",
    "type": 0
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "outTradeNo": "",
    "tradeNo": "",
    "flag": false,
    "payUrl": "https://example.com/x.png"
  }
}

处理逻辑

逻辑摘要调用 prepay（xghService.prepay）

前端调用方

xghmall prepay exact

POST /xgh/recommendProduct 在用开放/回调 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#recommendProduct
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_ruleskugoods_info

ControllerXghController#recommendProduct

ServiceXghService#listProduct （XghServiceImpl）

ServiceOpenapiChannelRuleService#queryList （OpenapiChannelRuleServiceImpl）

MapperOpenapiChannelRuleMapper#selectList ⇒ 表 openapi_channel_rule

ServiceSkuService#get （SkuServiceImpl）

MapperSkuMapper#selectById ⇒ 表 sku

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceGoodsInfoService#get （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectById ⇒ 表 goods_info

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

GoodsCache.getCardModelCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/xgh/recommendProduct
uat	https://dscp-uat.hn12301.net/open-api/xgh/recommendProduct
pro	https://dscp-uat.hn12301.net/open-api/xgh/recommendProduct	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<ChannelCardModelInfo>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
goods	Goods		—
goods.id	Long		`openapi_channel_rule`.`id`	商品id，主键
goods.merchantId	Long		`sku`.`merchant_id`	所属商户id，关联merchant表id
goods.shopId	Long		`sku`.`shop_id`	所属商铺id
goods.name	String		—	商品名称
goods.cardModelId	Long		`openapi_channel_rule`.`card_model_id`	旅游卡ID，关联旅游卡表id
goods.mainPic	String		—	商品主图
goods.typeId	String		`openapi_channel_rule`.`type_id`	商品大类
goods.subTypeId	String		—	商品小类
goods.grade	String		—	商品等级
goods.status	GoodsStatus	1已上架2编辑中3已下架	`openapi_channel_rule`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
goods.qrcode	String		—	商品二维码
goods.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
goods.createdBy	Long		`sku`.`created_by`	创建人
goods.createdTime	Date		`sku`.`created_time`	创建时间
goods.updatedBy	Long		`sku`.`updated_by`	修改人
goods.updatedTime	Date		`sku`.`updated_time`	修改时间
goods.thirdId	String		—	第三方id
goods.thirdName	String		—	第三方名称
cardModel	CardModel		—
cardModel.id	Long		`openapi_channel_rule`.`id`	旅游卡种ID，主键
cardModel.name	String		—	卡种名称
cardModel.grade	ModelGrade	11一类卡，2二类卡，3公式卡2二类卡3公式卡	—	卡种等级(枚举:card.ModelGrade)，1一类卡，2二类卡
cardModel.cardModelType	CardModelType	1省级旅游卡2市州旅游卡	—	卡种类型(枚举:card.CardModelType)，1省级旅游卡，2市州旅游卡
cardModel.code	Integer		—	卡种编号: 2 位数，从10 开始。10、11、12、顺序编号。
cardModel.merchantId	Long		`sku`.`merchant_id`	所属商户
cardModel.shopId	Long		`sku`.`shop_id`	所属商铺，关联商铺表id
cardModel.shopName	String		—	所属商铺名称
cardModel.channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_rule`.`channel`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
cardModel.thirdId	String		—	第三方id
cardModel.price	Integer		`openapi_channel_rule`.`price`	卡种售价
cardModel.expireDate	Date		`goods_info`.`expire_date`	失效日期
cardModel.publishDate	Date		—	发行日期
cardModel.isFace	Boolean		—	是否需要人脸
cardModel.isActiveCode	Boolean		—	是否需要激活码
cardModel.isRefresh	Boolean		—	二维码是否刷新
cardModel.propagateStyle	String		—	宣传卡样url地址
cardModel.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
cardModel.propagateVid	String		—	宣传视频url地址
cardModel.description	String		—	图文详情
cardModel.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
cardModel.createdBy	Long		`sku`.`created_by`	创建人id
cardModel.createdTime	Date		`sku`.`created_time`	创建时间
cardModel.updatedBy	Long		`sku`.`updated_by`	更新人id
cardModel.updatedTime	Date		`sku`.`updated_time`	修改时间
goodsInfo	GoodsInfo		—
goodsInfo.id	Long		`openapi_channel_rule`.`id`	商品id，主键
goodsInfo.shortName	String		`goods_info`.`short_name`	商品简称
goodsInfo.weight	Integer		`goods_info`.`weight`	商品权重
goodsInfo.tags	String		`goods_info`.`tags`	商品标签
goodsInfo.businessTime	String		`goods_info`.`business_time`	营业时间
goodsInfo.recommendReason	String		`goods_info`.`recommend_reason`	推荐理由
goodsInfo.introduction	String		`goods_info`.`introduction`	简介
goodsInfo.propagatePic	String		`goods_info`.`propagate_pic`	宣传图片url地址
goodsInfo.video	String		`goods_info`.`video`	宣传视频url地址
goodsInfo.notice	String		`goods_info`.`notice`	购买须知
goodsInfo.tips	String		`goods_info`.`tips`	温馨提示
goodsInfo.expireDate	Date		`goods_info`.`expire_date`
goodsInfo.isRefund	Boolean		`goods_info`.`is_refund`
goodsInfo.isDeleted	Boolean		`sku`.`is_deleted`	是否删除
goodsInfo.createdBy	String		`sku`.`created_by`	创建人id
goodsInfo.createdTime	LocalDateTime		`sku`.`created_time`	创建时间
goodsInfo.updatedBy	String		`sku`.`updated_by`	更新人id
goodsInfo.updatedTime	LocalDateTime		`sku`.`updated_time`	更新时间
cardModelType	Integer		—
modelName	String		—
salesNum	Integer		—
skuList	List<Sku>		—
skuList[].id	Long		`openapi_channel_rule`.`id`	商品skuID，主键
skuList[].merchantId	Long		`sku`.`merchant_id`	所属商户id
skuList[].shopId	Long		`sku`.`shop_id`	所属商铺id
skuList[].goodsId	Long		`openapi_channel_rule`.`goods_id`	商品ID，关联商品表id
skuList[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
skuList[].skuName	String		`sku`.`sku_name`	sku名称
skuList[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
skuList[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
skuList[].costPrice	Integer		`sku`.`cost_price`	商品成本价
skuList[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
skuList[].stock	Integer		`sku`.`stock`	库存数量
skuList[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
skuList[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
skuList[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
skuList[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
skuList[].commission	Integer		`sku`.`commission`	分销佣金
skuList[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
skuList[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
skuList[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
skuList[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
skuList[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
skuList[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
skuList[].isDeleted	Boolean		`sku`.`is_deleted`	是否删除
skuList[].createdBy	String		`sku`.`created_by`	创建人id
skuList[].createdTime	Date		`sku`.`created_time`	创建时间
skuList[].updatedBy	String		`sku`.`updated_by`	更新人id
skuList[].updatedTime	Date		`sku`.`updated_time`	修改时间
createDate	Date		—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/recommendProduct

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "goods": {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "name": "",
        "cardModelId": 1,
        "mainPic": "https://example.com/x.png",
        "typeId": "",
        "subTypeId": "",
        "grade": "",
        "status": "1",
        "qrcode": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      },
      "cardModel": {
        "id": 1,
        "name": "",
        "grade": "1",
        "cardModelType": "1",
        "code": 0,
        "merchantId": 1,
        "shopId": 1,
        "shopName": "",
        "channel": "1",
        "thirdId": "",
        "price": 0,
        "expireDate": "2026-01-01 12:00:00",
        "publishDate": "2026-01-01 12:00:00",
        "isFace": false,
        "isActiveCode": false,
        "isRefresh": false,
        "propagateStyle": "",
        "propagatePic": "https://example.com/x.png",
        "propagateVid": "",
        "description": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      },
      "goodsInfo": {
        "id": 1,
        "shortName": "",
        "weight": 0,
        "tags": "",
        "businessTime": "2026-01-01 12:00:00",
        "recommendReason": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "notice": "",
        "tips": "",
        "expireDate": "2026-01-01 12:00:00",
        "isRefund": false,
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      },
      "cardModelType": 0,
      "modelName": "",
      "salesNum": 0,
      "skuList": [
        {
          "id": 1,
          "merchantId": 1,
          "shopId": 1,
          "goodsId": 1,
          "goodsChannelId": 1,
          "skuName": "",
          "showPrice": 0,
          "buyPrice": 0,
          "costPrice": 0,
          "buyCount": 0,
          "stock": 0,
          "isLogistic": false,
          "carriageId": 1,
          "mold": "1",
          "isDistributes": false,
          "commission": 0,
          "isPreferential": false,
          "isUseScore": false,
          "isAddScore": false,
          "useScoreRate": 0,
          "addScoreRate": 0,
          "cardNum": 0,
          "isDeleted": false,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ],
      "createDate": "2026-01-01 12:00:00"
    }
  ]
}

处理逻辑

逻辑摘要调用 listProduct（xghService.listProduct）；调用 randomCommon（NumberUtil.randomCommon）

前端调用方

xghmall recommendProduct exact

POST /xgh/refund 在用管理后台 #

（无摘要） · XghController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.XghController#refund
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表orderorder_goodsmemberorder_paymentopenapi_channel_order

ControllerXghController#refund

ServiceXghService#refund （XghServiceImpl）

ServiceOrderService#get （OrderServiceImpl）

MapperOrderMapper#selectById ⇒ 表 order

ServiceOrderGoodsService#get （OrderGoodsServiceImpl）

MapperOrderGoodsMapper#selectById ⇒ 表 order_goods

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceOrderService#update （OrderServiceImpl）

MapperOrderMapper#updateById ⇒ 表 order

ServiceOrderPaymentService#get （OrderPaymentServiceImpl）

MapperOrderPaymentMapper#selectById ⇒ 表 order_payment

ServiceOpenapiChannelOrderService#get （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#selectById ⇒ 表 openapi_channel_order

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 2

GoodsCache.getCardModelCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/xgh/refund
uat	https://dscp-uat.hn12301.net/manage-api/xgh/refund
pro	https://dscp-uat.hn12301.net/manage-api/xgh/refund	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	orderNo	String	是		`openapi_channel_order`.`order_no`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　XghResponse　（object）

字段	类型	表 / 列
accessToken	String	—
code	Integer	—
message	String	—
isMember	boolean	—
memberLevelType	String	—

示例

请求示例（自动生成，仅结构参考）

POST /xgh/refund?orderNo=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "accessToken": "",
    "code": 0,
    "message": "",
    "isMember": false,
    "memberLevelType": ""
  }
}

处理逻辑

逻辑摘要调用 refund（xghService.refund）

前端调用方

dscp-html-manage refundXghOrder exact

YouBaoXingController 1/1 在用

POST /ybx/getQrByApi 在用开放/回调 #

（无摘要） · YouBaoXingController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.YouBaoXingController#getQrByApi
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_ybx_orderopenapi_ybx_ticket

ControllerYouBaoXingController#getQrByApi

ServiceYouBaoXingService#getQrByApi （YouBaoXingServiceImpl）

ServiceOpenapiYbxOrderService#get （OpenapiYbxOrderServiceImpl）

MapperOpenapiYbxOrderMapper#selectById ⇒ 表 openapi_ybx_order

ServiceOpenapiYbxTicketService#queryList （OpenapiYbxTicketServiceImpl）

MapperOpenapiYbxTicketMapper#selectList ⇒ 表 openapi_ybx_ticket

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/ybx/getQrByApi
uat	https://dscp-uat.hn12301.net/open-api/ybx/getQrByApi
pro	https://dscp-uat.hn12301.net/open-api/ybx/getQrByApi	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　YbxQrRequest

字段	类型	表 / 列
orderid	String	`openapi_ybx_order`.`orderid`
ticketcode	String	—
orderId	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　YbxQrResponse　（object）

字段	类型	必填	取值/校验	表 / 列	说明
qrBase64	String			—

示例

请求示例（自动生成，仅结构参考）

POST /ybx/getQrByApi

{
  "body": {
    "orderid": "",
    "ticketcode": "",
    "orderId": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "qrBase64": ""
  }
}

处理逻辑

逻辑摘要查询详情（youBaoXingService.getQrByApi）

前端调用方

xghmall getQrByApi exact

ZfbCardController 5/5 在用

POST /zfb/auth 在用开放/回调 #

（无摘要） · ZfbCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.ZfbCardController#auth
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member

ControllerZfbCardController#auth

ServiceZfbCardService#auth （ZfbCardServiceImpl）

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#add （MemberServiceImpl）

MapperMemberMapper#insert ⇒ 表 member

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/zfb/auth
uat	https://dscp-uat.hn12301.net/open-api/zfb/auth
pro	https://dscp-uat.hn12301.net/open-api/zfb/auth	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	code	String	是		—

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　AlipaySystemOauthTokenResponse　（object）

标量/Map/外部类型：AlipaySystemOauthTokenResponse

示例

请求示例（自动生成，仅结构参考）

POST /zfb/auth?code=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": ""
}

处理逻辑

逻辑摘要调用 auth（zfbService.auth）

前端调用方

xghmall CodeAuth exact

POST /zfb/cardModelDetails 在用开放/回调 #

（无摘要） · ZfbCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.ZfbCardController#cardModelDetails
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表goodscard_modelgoods_infoskugoods_channel

ControllerZfbCardController#cardModelDetails

ServiceZfbCardService#productDetail （ZfbCardServiceImpl）

ServiceGoodsService#get （GoodsServiceImpl）

MapperGoodsMapper#selectById ⇒ 表 goods

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceGoodsInfoService#get （GoodsInfoServiceImpl）

MapperGoodsInfoMapper#selectById ⇒ 表 goods_info

ServiceSkuService#queryList （SkuServiceImpl）

MapperSkuMapper#selectList ⇒ 表 sku

ServiceGoodsChannelService#get （GoodsChannelServiceImpl）

MapperGoodsChannelMapper#selectById ⇒ 表 goods_channel

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 3

GoodsCache.getCardModelCache.getShopCache.get

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/zfb/cardModelDetails
uat	https://dscp-uat.hn12301.net/open-api/zfb/cardModelDetails
pro	https://dscp-uat.hn12301.net/open-api/zfb/cardModelDetails	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	goodsIds	List<String>	是		—

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　List<ZfbCardDetail>　（list）

字段	类型	取值/校验	表 / 列	说明
[ ]	array		—	列表，元素结构见下
cardModel	CardModel		—
cardModel.id	Long		`goods`.`id`	旅游卡种ID，主键
cardModel.name	String		`goods`.`name`	卡种名称
cardModel.grade	ModelGrade	11一类卡，2二类卡，3公式卡2二类卡3公式卡	`goods`.`grade`	卡种等级(枚举:card.ModelGrade)，1一类卡，2二类卡
cardModel.cardModelType	CardModelType	1省级旅游卡2市州旅游卡	`card_model`.`card_model_type`	卡种类型(枚举:card.CardModelType)，1省级旅游卡，2市州旅游卡
cardModel.code	Integer		`card_model`.`code`	卡种编号: 2 位数，从10 开始。10、11、12、顺序编号。
cardModel.merchantId	Long		`goods`.`merchant_id`	所属商户
cardModel.shopId	Long		`goods`.`shop_id`	所属商铺，关联商铺表id
cardModel.shopName	String		`card_model`.`shop_name`	所属商铺名称
cardModel.channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`card_model`.`channel`	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
cardModel.thirdId	String		`goods`.`third_id`	第三方id
cardModel.price	Integer		`card_model`.`price`	卡种售价
cardModel.expireDate	Date		`card_model`.`expire_date`	失效日期
cardModel.publishDate	Date		`card_model`.`publish_date`	发行日期
cardModel.isFace	Boolean		`card_model`.`is_face`	是否需要人脸
cardModel.isActiveCode	Boolean		`card_model`.`is_active_code`	是否需要激活码
cardModel.isRefresh	Boolean		`card_model`.`is_refresh`	二维码是否刷新
cardModel.propagateStyle	String		`card_model`.`propagate_style`	宣传卡样url地址
cardModel.propagatePic	String		`card_model`.`propagate_pic`	宣传图片url地址
cardModel.propagateVid	String		`card_model`.`propagate_vid`	宣传视频url地址
cardModel.description	String		`card_model`.`description`	图文详情
cardModel.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
cardModel.createdBy	Long		`goods`.`created_by`	创建人id
cardModel.createdTime	Date		`goods`.`created_time`	创建时间
cardModel.updatedBy	Long		`goods`.`updated_by`	更新人id
cardModel.updatedTime	Date		`goods`.`updated_time`	修改时间
goods	Goods		—
goods.id	Long		`goods`.`id`	商品id，主键
goods.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
goods.shopId	Long		`goods`.`shop_id`	所属商铺id
goods.name	String		`goods`.`name`	商品名称
goods.cardModelId	Long		`goods`.`card_model_id`	旅游卡ID，关联旅游卡表id
goods.mainPic	String		`goods`.`main_pic`	商品主图
goods.typeId	String		`goods`.`type_id`	商品大类
goods.subTypeId	String		`goods`.`sub_type_id`	商品小类
goods.grade	String		`goods`.`grade`	商品等级
goods.status	GoodsStatus	1已上架2编辑中3已下架	`goods`.`status`	商品状态(枚举:GoodsStatus)，1正常，2编辑中，3已下架
goods.qrcode	String		`goods`.`qrcode`	商品二维码
goods.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
goods.createdBy	Long		`goods`.`created_by`	创建人
goods.createdTime	Date		`goods`.`created_time`	创建时间
goods.updatedBy	Long		`goods`.`updated_by`	修改人
goods.updatedTime	Date		`goods`.`updated_time`	修改时间
goods.thirdId	String		`goods`.`third_id`	第三方id
goods.thirdName	String		`goods`.`third_name`	第三方名称
goodsInfo	GoodsInfo		—
goodsInfo.id	Long		`goods`.`id`	商品id，主键
goodsInfo.shortName	String		`goods_info`.`short_name`	商品简称
goodsInfo.weight	Integer		`goods_info`.`weight`	商品权重
goodsInfo.tags	String		`goods_info`.`tags`	商品标签
goodsInfo.businessTime	String		`goods_info`.`business_time`	营业时间
goodsInfo.recommendReason	String		`goods_info`.`recommend_reason`	推荐理由
goodsInfo.introduction	String		`goods_info`.`introduction`	简介
goodsInfo.propagatePic	String		`card_model`.`propagate_pic`	宣传图片url地址
goodsInfo.video	String		`goods_info`.`video`	宣传视频url地址
goodsInfo.notice	String		`goods_info`.`notice`	购买须知
goodsInfo.tips	String		`goods_info`.`tips`	温馨提示
goodsInfo.expireDate	Date		`card_model`.`expire_date`
goodsInfo.isRefund	Boolean		`goods_info`.`is_refund`
goodsInfo.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
goodsInfo.createdBy	String		`goods`.`created_by`	创建人id
goodsInfo.createdTime	LocalDateTime		`goods`.`created_time`	创建时间
goodsInfo.updatedBy	String		`goods`.`updated_by`	更新人id
goodsInfo.updatedTime	LocalDateTime		`goods`.`updated_time`	更新时间
sku	List<Sku>		—
sku[].id	Long		`goods`.`id`	商品skuID，主键
sku[].merchantId	Long		`goods`.`merchant_id`	所属商户id
sku[].shopId	Long		`goods`.`shop_id`	所属商铺id
sku[].goodsId	Long		`sku`.`goods_id`	商品ID，关联商品表id
sku[].goodsChannelId	Long		`sku`.`goods_channel_id`	关联商品渠道id
sku[].skuName	String		`sku`.`sku_name`	sku名称
sku[].showPrice	Integer		`sku`.`show_price`	商品挂牌价
sku[].buyPrice	Integer		`sku`.`buy_price`	商品实际售价
sku[].costPrice	Integer		`sku`.`cost_price`	商品成本价
sku[].buyCount	Integer		`sku`.`buy_count`	单次可购买数量
sku[].stock	Integer		`sku`.`stock`	库存数量
sku[].isLogistic	Boolean		`sku`.`is_logistic`	是否需要物流
sku[].carriageId	Long		`sku`.`carriage_id`	物流模版ID，关联carriage表id
sku[].mold	GoodsMold	1实物商品2虚拟商品3电子卡券	`sku`.`mold`	商品状态(枚举:merchant.goodsMold)，1实物商品，2虚拟商品，3电子卡券
sku[].isDistributes	Boolean		`sku`.`is_distributes`	是否可分销
sku[].commission	Integer		`sku`.`commission`	分销佣金
sku[].isPreferential	Boolean		`sku`.`is_preferential`	是否可使用优惠券
sku[].isUseScore	Boolean		`sku`.`is_use_score`	是否可使用积分抵扣
sku[].isAddScore	Boolean		`sku`.`is_add_score`	购买后是否产生积分
sku[].useScoreRate	BigDecimal		`sku`.`use_score_rate`	抵扣积分倍率
sku[].addScoreRate	BigDecimal		`sku`.`add_score_rate`	产生积分倍率
sku[].cardNum	Integer		`sku`.`card_num`	发卡数量，仅旅游卡商品
sku[].isDeleted	Boolean		`goods`.`is_deleted`	是否删除
sku[].createdBy	String		`goods`.`created_by`	创建人id
sku[].createdTime	Date		`goods`.`created_time`	创建时间
sku[].updatedBy	String		`goods`.`updated_by`	更新人id
sku[].updatedTime	Date		`goods`.`updated_time`	修改时间
shop	Shop		—
shop.id	Long		`goods`.`id`	商铺id，主键
shop.merchantId	Long		`goods`.`merchant_id`	所属商户id，关联merchant表id
shop.merchantType	MerchantType	1供应商2分销商3发卡商4其他5酒店6第三方	—	商户类型(枚举:merchant.MerchantType)
shop.name	String		`goods`.`name`	商铺名称
shop.logo	String		—	商铺LOGO图片url地址
shop.typeId	Long		`goods`.`type_id`	商铺大类
shop.subTypeId	Long		`goods`.`sub_type_id`	商铺小类ID
shop.status	ShopStatus	1正常运营2审核中3暂停运营4已关店	`goods`.`status`	商铺状态(枚举:ShopStatus)，1正常运营，2审核中，3暂停运营，4已关店
shop.provinceId	String		—	省id
shop.cityId	String		—	市id
shop.districtId	String		—	区县id
shop.address	String		—	商铺地址
shop.mobile	String		—	客服电话
shop.linkman	String		—	商户联系人
shop.linkphone	String		—	商户联系人手机
shop.manager	String		—	专属客户经理
shop.level	String		—	等级
shop.lng	String		—	经度
shop.lat	String		—	纬度
shop.introduction	String		`goods_info`.`introduction`	简介
shop.businessTime	String		`goods_info`.`business_time`	营业时间
shop.tags	String		`goods_info`.`tags`	商铺标签
shop.mainPic	String		`goods`.`main_pic`	景区主图url地址
shop.propagatePic	String		`card_model`.`propagate_pic`	宣传图片url地址
shop.video	String		`goods_info`.`video`	景区视频url地址
shop.poster	String		—	分享海报url地址
shop.propagateContent	String		—	宣传语
shop.description	String		`card_model`.`description`	图文详情
shop.ticketInfo	String		—	门票信息
shop.trafficInfo	String		—	交通信息
shop.tips	String		`goods_info`.`tips`	温馨提示
shop.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
shop.createdBy	String		`goods`.`created_by`	创建人id
shop.createdTime	Date		`goods`.`created_time`	创建时间
shop.updatedBy	String		`goods`.`updated_by`	更新人id
shop.updatedTime	Date		`goods`.`updated_time`	修改时间
shop.thirdId	String		`goods`.`third_id`
shop.thirdName	String		`goods`.`third_name`
goodsChannel	GoodsChannel		—
goodsChannel.id	Long		`goods`.`id`
goodsChannel.goodsChannelName	String		`goods_channel`.`goods_channel_name`	商品渠道名称
goodsChannel.goodsId	Long		`sku`.`goods_id`	商品id(关联goods表id)
goodsChannel.skuId	Long		`goods_channel`.`sku_id`	关联skuId
goodsChannel.merchantId	Long		`goods`.`merchant_id`	商品所属商户id
goodsChannel.shopId	Long		`goods`.`shop_id`	商品所属商铺id
goodsChannel.channelMerchantId	Long		`goods_channel`.`channel_merchant_id`	渠道商户id
goodsChannel.channelShopId	Long		`goods_channel`.`channel_shop_id`	渠道商铺id
goodsChannel.originGoodsId	Long		`goods_channel`.`origin_goods_id`	源头商品id
goodsChannel.originSkuId	Long		`goods_channel`.`origin_sku_id`	源头skuId
goodsChannel.maxSalesPrice	Integer		`goods_channel`.`max_sales_price`	最大销售价格
goodsChannel.minSalesPrice	Integer		`goods_channel`.`min_sales_price`	最小销售价格/分
goodsChannel.stock	Integer		`sku`.`stock`	初始库存
goodsChannel.introduction	String		`goods_info`.`introduction`	资源说明
goodsChannel.remark	String		`goods_channel`.`remark`	备注
goodsChannel.status	GoodsChannelStatus	1已上架2编辑中3已下架	`goods`.`status`	状态(枚举:GoodsChannelStatus)，1已上架，2编辑中，3已下架
goodsChannel.isDeleted	Boolean		`goods`.`is_deleted`	是否删除
goodsChannel.createdBy	String		`goods`.`created_by`	创建人id
goodsChannel.createdTime	Date		`goods`.`created_time`
goodsChannel.updatedBy	String		`goods`.`updated_by`	更新人id
goodsChannel.updatedTime	Date		`goods`.`updated_time`
salesNum	Integer		—

示例

请求示例（自动生成，仅结构参考）

POST /zfb/cardModelDetails?goodsIds=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": [
    {
      "cardModel": {
        "id": 1,
        "name": "",
        "grade": "1",
        "cardModelType": "1",
        "code": 0,
        "merchantId": 1,
        "shopId": 1,
        "shopName": "",
        "channel": "1",
        "thirdId": "",
        "price": 0,
        "expireDate": "2026-01-01 12:00:00",
        "publishDate": "2026-01-01 12:00:00",
        "isFace": false,
        "isActiveCode": false,
        "isRefresh": false,
        "propagateStyle": "",
        "propagatePic": "https://example.com/x.png",
        "propagateVid": "",
        "description": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00"
      },
      "goods": {
        "id": 1,
        "merchantId": 1,
        "shopId": 1,
        "name": "",
        "cardModelId": 1,
        "mainPic": "https://example.com/x.png",
        "typeId": "",
        "subTypeId": "",
        "grade": "",
        "status": "1",
        "qrcode": "",
        "isDeleted": false,
        "createdBy": 0,
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": 0,
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      },
      "goodsInfo": {
        "id": 1,
        "shortName": "",
        "weight": 0,
        "tags": "",
        "businessTime": "2026-01-01 12:00:00",
        "recommendReason": "",
        "introduction": "",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "notice": "",
        "tips": "",
        "expireDate": "2026-01-01 12:00:00",
        "isRefund": false,
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      },
      "sku": [
        {
          "id": 1,
          "merchantId": 1,
          "shopId": 1,
          "goodsId": 1,
          "goodsChannelId": 1,
          "skuName": "",
          "showPrice": 0,
          "buyPrice": 0,
          "costPrice": 0,
          "buyCount": 0,
          "stock": 0,
          "isLogistic": false,
          "carriageId": 1,
          "mold": "1",
          "isDistributes": false,
          "commission": 0,
          "isPreferential": false,
          "isUseScore": false,
          "isAddScore": false,
          "useScoreRate": 0,
          "addScoreRate": 0,
          "cardNum": 0,
          "isDeleted": false,
          "createdBy": "",
          "createdTime": "2026-01-01 12:00:00",
          "updatedBy": "2026-01-01 12:00:00",
          "updatedTime": "2026-01-01 12:00:00"
        }
      ],
      "shop": {
        "id": 1,
        "merchantId": 1,
        "merchantType": "1",
        "name": "",
        "logo": "",
        "typeId": 1,
        "subTypeId": 1,
        "status": "1",
        "provinceId": "",
        "cityId": "",
        "districtId": "",
        "address": "",
        "mobile": "13800000000",
        "linkman": "",
        "linkphone": "13800000000",
        "manager": "",
        "level": "",
        "lng": "",
        "lat": "",
        "introduction": "",
        "businessTime": "2026-01-01 12:00:00",
        "tags": "",
        "mainPic": "https://example.com/x.png",
        "propagatePic": "https://example.com/x.png",
        "video": "",
        "poster": "",
        "propagateContent": "",
        "description": "",
        "ticketInfo": "",
        "trafficInfo": "",
        "tips": "",
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00",
        "thirdId": "",
        "thirdName": ""
      },
      "goodsChannel": {
        "id": 1,
        "goodsChannelName": "",
        "goodsId": 1,
        "skuId": 1,
        "merchantId": 1,
        "shopId": 1,
        "channelMerchantId": 1,
        "channelShopId": 1,
        "originGoodsId": 1,
        "originSkuId": 1,
        "maxSalesPrice": 0,
        "minSalesPrice": 0,
        "stock": 0,
        "introduction": "",
        "remark": "",
        "status": "1",
        "isDeleted": false,
        "createdBy": "",
        "createdTime": "2026-01-01 12:00:00",
        "updatedBy": "2026-01-01 12:00:00",
        "updatedTime": "2026-01-01 12:00:00"
      },
      "salesNum": 0
    }
  ]
}

处理逻辑

逻辑摘要调用 productDetail（zfbService.productDetail）

前端调用方

xghmall cardModelDetails exact

POST /zfb/getPhone 在用开放/回调 #

（无摘要） · ZfbCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.ZfbCardController#getPhone
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member

ControllerZfbCardController#getPhone

ServiceZfbCardService#getPhone （ZfbCardServiceImpl）

ServiceMemberService#get （MemberServiceImpl）

MapperMemberMapper#selectById ⇒ 表 member

ServiceMemberService#update （MemberServiceImpl）

MapperMemberMapper#updateById ⇒ 表 member

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/zfb/getPhone
uat	https://dscp-uat.hn12301.net/open-api/zfb/getPhone
pro	https://dscp-uat.hn12301.net/open-api/zfb/getPhone	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	encryptContent	String	是		—
query	openId	String	是		`member`.`open_id`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　UserAliSecretInfoDTO　（object）

字段	类型	表 / 列
code	String	—
msg	String	—
mobile	String	`member`.`mobile`

示例

请求示例（自动生成，仅结构参考）

POST /zfb/getPhone?encryptContent=…&openId=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "code": "",
    "msg": "",
    "mobile": "13800000000"
  }
}

处理逻辑

逻辑摘要查询详情（zfbService.getPhone）

前端调用方

xghmall Phone exact

POST /zfb/getQrCode 在用开放/回调 #

（无摘要） · ZfbCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.ZfbCardController#getQrCode
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerZfbCardController#getQrCode

其它依赖（权限 / 会话 / 缓存 / 校验等，不直接读写业务表）· 1

ZfbCardService.getQrCode

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/zfb/getQrCode
uat	https://dscp-uat.hn12301.net/open-api/zfb/getQrCode
pro	https://dscp-uat.hn12301.net/open-api/zfb/getQrCode	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　ZfbQrCodeRequest

字段	类型	表 / 列
urlParam	String	—
queryParam	String	—
describe	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　AlipayOpenAppQrcodeCreateResponse　（object）

标量/Map/外部类型：AlipayOpenAppQrcodeCreateResponse

示例

请求示例（自动生成，仅结构参考）

POST /zfb/getQrCode

{
  "body": {
    "urlParam": "https://example.com/x.png",
    "queryParam": "",
    "describe": ""
  }
}

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": ""
}

处理逻辑

逻辑摘要查询详情（zfbService.getQrCode）

前端调用方

xghmall QrCode exact

POST /zfb/queryZfbzdOrder 在用开放/回调 #

支付宝阵地订单查询卡号接口 · ZfbCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.ZfbCardController#queryZfbzdOrder
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表openapi_channel_orderopenapi_channel_cardcard_model

ControllerZfbCardController#queryZfbzdOrder

ServiceZfbCardService#queryZfbzdOrder （ZfbCardServiceImpl）

ServiceOpenapiChannelOrderService#get （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#selectById ⇒ 表 openapi_channel_order

ServiceOpenapiChannelCardService#queryList （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#selectList ⇒ 表 openapi_channel_card

ServiceCardModelService#get （CardModelServiceImpl）

MapperCardModelMapper#selectById ⇒ 表 card_model

ServiceZfbCardService#refund （ZfbCardServiceImpl）

ServiceOpenapiChannelOrderService#update （OpenapiChannelOrderServiceImpl）

MapperOpenapiChannelOrderMapper#updateById ⇒ 表 openapi_channel_order

ServiceOpenapiChannelCardService#update （OpenapiChannelCardServiceImpl）

MapperOpenapiChannelCardMapper#updateById ⇒ 表 openapi_channel_card

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/zfb/queryZfbzdOrder
uat	https://dscp-uat.hn12301.net/open-api/zfb/queryZfbzdOrder
pro	https://dscp-uat.hn12301.net/open-api/zfb/queryZfbzdOrder	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

位置	名称	类型	必填	取值/校验	表 / 列	说明
query	orderNo	String			`openapi_channel_order`.`order_no`

请求参数 · Body

请求体类型：—（未在仓库索引到该 DTO 源码，无法展开字段；可能位于依赖 jar 或为 Map/基础类型）

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　ZfbzdOrderQueryResponse　（object）

字段	类型	取值/校验	表 / 列
typeId	String		`openapi_channel_order`.`type_id`
mobile	String		`openapi_channel_order`.`mobile`
cardNoList	List<String>		—
orderNo	String		`openapi_channel_order`.`order_no`
modelName	String		—
channel	ChannelType	1北京卡管理系统2三省卡系统3数字平台4质惠游5支付宝6兴业银行7湘工惠8湘约码+8	`openapi_channel_order`.`channel`

示例

请求示例（自动生成，仅结构参考）

POST /zfb/queryZfbzdOrder?orderNo=…

响应示例

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "typeId": "",
    "mobile": "13800000000",
    "cardNoList": "",
    "orderNo": "",
    "modelName": "",
    "channel": "1"
  }
}

处理逻辑

逻辑摘要调用 queryZfbzdOrder（zfbService.queryZfbzdOrder）；调用 refund（zfbService.refund）

内联注释

return zfbService.refund(request);

前端调用方

xghmall queryZfbzdOrder exact

HhCardLogController 0/6 在用

POST /openapi/queryHhCardLogPage 未使用管理后台 #

怀化社保卡记录表-分页查询 · HhCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HhCardLogController#queryHhCardLogPage
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHhCardLogController#queryHhCardLogPage

ServicehhCardLogService#queryPage

MapperHhCardLogMapper#queryPage ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryHhCardLogPage
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryHhCardLogPage
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryHhCardLogPage	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HhCardLogPageRequest

字段	类型	表 / 列	说明
pageNo	Integer	—	当前页面
pageSize	Integer	—	每页记录数
orderBy	String	—	排序语句
keywords	String	—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HhCardLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	—	id
thirdOrderNo	String	—
thirdUnitId	String	—	第三方单位id
thirdUnitName	String	—	第三方单位名称
machineNo	String	—	设备号
name	String	—	姓名
idCard	String	—	身份证号码
phone	String	—	手机号
payAmount	String	—	金额
logType	Integer	—	记录类型 1=入园核销
logLabel	Integer	—	记录类别
status	Integer	—	状态
useDate	Date	—
isDeleted	Boolean	—	是否删除
createdTime	Date	—	创建时间
updatedTime	Date	—	修改时间
params	String	—
result	String	—

示例

请求示例

{
  "pageNo": 0,
  "pageSize": 0,
  "orderBy": "",
  "keywords": ""
}

响应示例

{
  "id": 0,
  "thirdOrderNo": "",
  "thirdUnitId": "",
  "thirdUnitName": "",
  "machineNo": "",
  "name": "",
  "idCard": "",
  "phone": "",
  "payAmount": "",
  "logType": 0,
  "logLabel": 0,
  "status": 0,
  "useDate": "",
  "isDeleted": false,
  "createdTime": "",
  "updatedTime": "",
  "params": "",
  "result": ""
}

处理逻辑

逻辑摘要hhCardLogService.queryPage；完整实现见源码 HhCardLogController#queryHhCardLogPage

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/queryHhCardLogList 未使用管理后台 #

怀化社保卡记录表-列表查询 · HhCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HhCardLogController#queryHhCardLogList
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHhCardLogController#queryHhCardLogList

ServicehhCardLogService#queryList

MapperHhCardLogMapper#queryList ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/queryHhCardLogList
uat	https://dscp-uat.hn12301.net/manage-api/openapi/queryHhCardLogList
pro	https://dscp-uat.hn12301.net/manage-api/openapi/queryHhCardLogList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HhCardLogListRequest

字段	类型	必填	取值/校验	表 / 列	说明
keywords	String			—	关键字

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HhCardLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	—	id
thirdOrderNo	String	—
thirdUnitId	String	—	第三方单位id
thirdUnitName	String	—	第三方单位名称
machineNo	String	—	设备号
name	String	—	姓名
idCard	String	—	身份证号码
phone	String	—	手机号
payAmount	String	—	金额
logType	Integer	—	记录类型 1=入园核销
logLabel	Integer	—	记录类别
status	Integer	—	状态
useDate	Date	—
isDeleted	Boolean	—	是否删除
createdTime	Date	—	创建时间
updatedTime	Date	—	修改时间
params	String	—
result	String	—

示例

请求示例

{
  "keywords": ""
}

响应示例

{
  "id": 0,
  "thirdOrderNo": "",
  "thirdUnitId": "",
  "thirdUnitName": "",
  "machineNo": "",
  "name": "",
  "idCard": "",
  "phone": "",
  "payAmount": "",
  "logType": 0,
  "logLabel": 0,
  "status": 0,
  "useDate": "",
  "isDeleted": false,
  "createdTime": "",
  "updatedTime": "",
  "params": "",
  "result": ""
}

处理逻辑

逻辑摘要hhCardLogService.queryList；完整实现见源码 HhCardLogController#queryHhCardLogList

内联注释

设置其他查询条件

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/addHhCardLog 未使用管理后台 #

怀化社保卡记录表-新增 · HhCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HhCardLogController#addHhCardLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHhCardLogController#addHhCardLog

ServicehhCardLogService#add

MapperHhCardLogMapper#add ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/addHhCardLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/addHhCardLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/addHhCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HhCardLogAddRequest

字段	类型	表 / 列	说明
thirdOrderNo	String	—	名称
thirdUnitId	String	—	第三方单位id
thirdUnitName	String	—	第三方单位名称
machineNo	String	—	设备号
name	String	—	姓名
idCard	String	—	身份证号码
phone	String	—	手机号
payAmount	String	—	金额
logType	Integer	—	记录类型 1=入园核销
logLabel	Integer	—	记录类别
status	Integer	—	状态
useDate	Date	—
isDeleted	Boolean	—	是否删除
params	String	—
result	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "thirdOrderNo": "",
  "thirdUnitId": "",
  "thirdUnitName": "",
  "machineNo": "",
  "name": "",
  "idCard": "",
  "phone": "",
  "payAmount": "",
  "logType": 0,
  "logLabel": 0,
  "status": 0,
  "useDate": "",
  "isDeleted": false,
  "params": "",
  "result": ""
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要hhCardLogService.add；完整实现见源码 HhCardLogController#addHhCardLog

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/updateHhCardLog 未使用管理后台 #

怀化社保卡记录表-更新 · HhCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HhCardLogController#updateHhCardLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHhCardLogController#updateHhCardLog

ServicehhCardLogService#update

MapperHhCardLogMapper#update ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/updateHhCardLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/updateHhCardLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/updateHhCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HhCardLogUpdateRequest

字段	类型	表 / 列	说明
id	Long	—	id
thirdOrderNo	String	—
thirdUnitId	String	—	第三方单位id
thirdUnitName	String	—	第三方单位名称
machineNo	String	—	设备号
name	String	—	姓名
idCard	String	—	身份证号码
phone	String	—	手机号
payAmount	String	—	金额
logType	Integer	—	记录类型 1=入园核销
logLabel	Integer	—	记录类别
status	Integer	—	状态
useDate	Date	—
isDeleted	Boolean	—	是否删除
params	String	—
result	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "id": 0,
  "thirdOrderNo": "",
  "thirdUnitId": "",
  "thirdUnitName": "",
  "machineNo": "",
  "name": "",
  "idCard": "",
  "phone": "",
  "payAmount": "",
  "logType": 0,
  "logLabel": 0,
  "status": 0,
  "useDate": "",
  "isDeleted": false,
  "params": "",
  "result": ""
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要hhCardLogService.update；完整实现见源码 HhCardLogController#updateHhCardLog

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/getHhCardLog 未使用管理后台 #

怀化社保卡记录表-详情 · HhCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HhCardLogController#getHhCardLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHhCardLogController#getHhCardLog

ServicehhCardLogService#get

MapperHhCardLogMapper#get ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/getHhCardLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/getHhCardLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/getHhCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			—	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　HhCardLogResponse　（object）

字段	类型	表 / 列	说明
id	Long	—	id
thirdOrderNo	String	—
thirdUnitId	String	—	第三方单位id
thirdUnitName	String	—	第三方单位名称
machineNo	String	—	设备号
name	String	—	姓名
idCard	String	—	身份证号码
phone	String	—	手机号
payAmount	String	—	金额
logType	Integer	—	记录类型 1=入园核销
logLabel	Integer	—	记录类别
status	Integer	—	状态
useDate	Date	—
isDeleted	Boolean	—	是否删除
createdTime	Date	—	创建时间
updatedTime	Date	—	修改时间
params	String	—
result	String	—

示例

请求示例

{
  "id": 0
}

响应示例

{
  "id": 0,
  "thirdOrderNo": "",
  "thirdUnitId": "",
  "thirdUnitName": "",
  "machineNo": "",
  "name": "",
  "idCard": "",
  "phone": "",
  "payAmount": "",
  "logType": 0,
  "logLabel": 0,
  "status": 0,
  "useDate": "",
  "isDeleted": false,
  "createdTime": "",
  "updatedTime": "",
  "params": "",
  "result": ""
}

处理逻辑

逻辑摘要hhCardLogService.get；完整实现见源码 HhCardLogController#getHhCardLog

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /openapi/deleteHhCardLog 未使用管理后台 #

怀化社保卡记录表-删除 · HhCardLogController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HhCardLogController#deleteHhCardLog
所属模块	开放接口/对接 `openapi`
暴露渠道	管理后台（@Route 注解；决定 URL 前缀与可访问端）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHhCardLogController#deleteHhCardLog

ServicehhCardLogService#delete

MapperHhCardLogMapper#delete ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/manage-api/openapi/deleteHhCardLog
uat	https://dscp-uat.hn12301.net/manage-api/openapi/deleteHhCardLog
pro	https://dscp-uat.hn12301.net/manage-api/openapi/deleteHhCardLog	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　IdRequest

字段	类型	必填	取值/校验	表 / 列	说明
id	Long			—	id

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "id": 0
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要hhCardLogService.delete；完整实现见源码 HhCardLogController#deleteHhCardLog

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

HuaiHuaController 1/2 在用

POST /hhService/tokenDecode 在用开放/回调 #

银联小程序token解码获取用户信息 · HuaiHuaController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HuaiHuaController#tokenDecode
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerHuaiHuaController#tokenDecode

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hhService/tokenDecode
uat	https://dscp-uat.hn12301.net/open-api/hhService/tokenDecode
pro	https://dscp-uat.hn12301.net/open-api/hhService/tokenDecode	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HhUnionTokenDecodeRequest

字段	类型	必填	取值/校验	表 / 列	说明
token	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　JSONObject

透传/非结构化对象，以实际返回为准

示例

请求示例

{
  "token": ""
}

响应示例

{ }　// JSONObject

处理逻辑

逻辑摘要（无显式下游调用，逻辑在方法体内）；完整实现见源码 HuaiHuaController#tokenDecode

前端调用方

hhrs tokenDecode exact

POST /hhService/thirdNotify 未使用开放/回调 #

怀化人社-第三方通知回调（上报） · HuaiHuaController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.HuaiHuaController#thirdNotify
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表hh_card_log

ControllerHuaiHuaController#thirdNotify

ServicehhCardLogService#add

MapperHhCardLogMapper#add ⇒ 表 hh_card_log

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/hhService/thirdNotify
uat	https://dscp-uat.hn12301.net/open-api/hhService/thirdNotify
pro	https://dscp-uat.hn12301.net/open-api/hhService/thirdNotify	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　HhThirdNotifyRequest

字段	类型	表 / 列	说明
thirdOrderNo	String	—	第三方记录编号
thirdUnitId	String	—	第三方单位id
thirdUnitName	String	—	第三方单位名称
machineNo	String	—	设备号
name	String	—	姓名
idCard	String	—	身份证号码
phone	String	—	手机号
payAmount	String	—	金额
useDate	Date	—	使用时间
logType	Integer	—	1=入园 2=预约
sign	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构

（void，无响应体）

示例

请求示例

{
  "thirdOrderNo": "",
  "thirdUnitId": "",
  "thirdUnitName": "",
  "machineNo": "",
  "name": "",
  "idCard": "",
  "phone": "",
  "payAmount": "",
  "useDate": "",
  "logType": 0,
  "sign": ""
}

响应示例

（void，无响应体）

处理逻辑

逻辑摘要hhCardLogService.add；完整实现见源码 HuaiHuaController#thirdNotify

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

MeiKeController 1/1 在用

POST /meike/getUserInfo 在用开放/回调 #

美科-订单解码获取用户信息 · MeiKeController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.MeiKeController#getUserInfo
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表member

ControllerMeiKeController#getUserInfo

ServicememberService#get

MapperMemberMapper#get ⇒ 表 member

ServicememberService#add

MapperMemberMapper#add ⇒ 表 member

ServicememberService#update

MapperMemberMapper#update ⇒ 表 member

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/meike/getUserInfo
uat	https://dscp-uat.hn12301.net/open-api/meike/getUserInfo
pro	https://dscp-uat.hn12301.net/open-api/meike/getUserInfo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　MeiKeUserInfoRequest

字段	类型	必填	取值/校验	表 / 列	说明
code	String			—
openId	String			—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　MeiKeUserInfo　（object）

字段	类型	表 / 列
phone	String	—
openId	String	—
isSubscribe	String	—
channel	String	—

示例

请求示例

{
  "code": "",
  "openId": ""
}

响应示例

{
  "phone": "",
  "openId": "",
  "isSubscribe": "",
  "channel": ""
}

处理逻辑

逻辑摘要memberService.get；memberService.add；memberService.update；完整实现见源码 MeiKeController#getUserInfo

内联注释

.mobile(userInfo.getPhone())

前端调用方

zhy-h5 getUserInfo exact

OpenApiCardController 1/4 在用

POST /card/queryCardModelList 未使用开放/回调 #

开放-卡种列表查询 · OpenApiCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenApiCardController#queryCardModelList
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOpenApiCardController#queryCardModelList

ServiceopenApiCardService#queryCardModelList

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/card/queryCardModelList
uat	https://dscp-uat.hn12301.net/open-api/card/queryCardModelList
pro	https://dscp-uat.hn12301.net/open-api/card/queryCardModelList	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　QueryCardModelRequest

字段	类型	表 / 列
appId	String	—
pageNo	Integer	—
pageSize	Integer	—
sign	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　CardModelListResponse　（object）

字段	类型	表 / 列	说明
id	Long	—	旅游卡种ID，主键
name	String	—	卡种名称
code	Integer	—	卡种编号
grade	ModelGrade	—	卡种等级(枚举:card.ModelGrade)，1一类卡，2二类卡
cardModelType	CardModelType	—	卡种类型(枚举:card.CardModelType)，1省级旅游卡，2市州旅游卡
merchantId	Long	—	所属商户
shopId	Long	—	所属商铺，关联商铺表id
shopName	String	—	所属商铺
channel	ChannelType	—	所属渠道(枚举:checker.ChannelType)，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
price	Integer	—	卡种售价
publishDate	Date	—	发行日期
isFace	Boolean	—	是否需要人脸
isActiveCode	Boolean	—	是否需要激活码
isRefresh	Boolean	—	二维码是否刷新
propagateStyle	String	—	宣传卡样url地址
propagatePic	String	—	宣传图片url地址
propagateVid	String	—	宣传视频url地址
description	String	—	图文详情
resourceCount	Long	—	资源数量
validType	String	—	有效期方式
validDate	Integer	—	有效期（月）
activeDays	Integer	—	购买后多少天自动激活；0表示不自动激活
modelGrade	String	—	卡种等级
channelType	String	—	渠道
createdTime	Date	—	创建时间

嵌套　ModelGrade　（ModelGrade）

字段	类型	必填	取值/校验	表 / 列	说明
value	Integer			—	卡种等级
desc	String			—

嵌套　CardModelType　（CardModelType）

字段	类型	必填	取值/校验	表 / 列	说明
value	Integer			—	卡种类型，1省级旅游卡，2市州旅游卡
desc	String			—

嵌套　ChannelType　（ChannelType）

字段	类型	必填	取值/校验	表 / 列	说明
value	Integer			—	ChannelType
desc	String			—

示例

请求示例

{
  "appId": "",
  "pageNo": 0,
  "pageSize": 0,
  "sign": ""
}

响应示例

{
  "id": 0,
  "name": "",
  "code": 0,
  "grade": {
    "value": 0,
    "desc": ""
  },
  "cardModelType": {
    "value": 0,
    "desc": ""
  },
  "merchantId": 0,
  "shopId": 0,
  "shopName": "",
  "channel": {
    "value": 0,
    "desc": ""
  },
  "price": 0,
  "publishDate": "",
  "isFace": false,
  "isActiveCode": false,
  "isRefresh": false,
  "propagateStyle": "",
  "propagatePic": "",
  "propagateVid": "",
  "description": "",
  "resourceCount": 0,
  "validType": "",
  "validDate": 0,
  "activeDays": 0,
  "modelGrade": "",
  "channelType": "",
  "createdTime": ""
}

处理逻辑

逻辑摘要openApiCardService.queryCardModelList；完整实现见源码 OpenApiCardController#queryCardModelList

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /card/cardModelDetail 未使用开放/回调 #

开放-卡种详情查询 · OpenApiCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenApiCardController#cardModelDetail
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOpenApiCardController#cardModelDetail

ServiceopenApiCardService#cardModelDetail

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/card/cardModelDetail
uat	https://dscp-uat.hn12301.net/open-api/card/cardModelDetail
pro	https://dscp-uat.hn12301.net/open-api/card/cardModelDetail	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　CardModelDetailRequest

字段	类型	表 / 列
appId	String	—
cardModelId	Long	—
sign	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　CardModelDetailResponse

空占位响应类（字段未定义，结构以实际返回为准）

示例

请求示例

{
  "appId": "",
  "cardModelId": 0,
  "sign": ""
}

响应示例

{ }　// CardModelDetailResponse

处理逻辑

逻辑摘要openApiCardService.cardModelDetail；完整实现见源码 OpenApiCardController#cardModelDetail

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /card/sendWithNo 未使用开放/回调 #

开放-发卡（sendWithNo，返回发卡回执） · OpenApiCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenApiCardController#sendWithNo
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOpenApiCardController#sendWithNo

ServiceopenApiCardService#sendWithNo

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/card/sendWithNo
uat	https://dscp-uat.hn12301.net/open-api/card/sendWithNo
pro	https://dscp-uat.hn12301.net/open-api/card/sendWithNo	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SendWithNoRequest

字段	类型	表 / 列
orderNo	String	—
typeId	String	—
mobile	String	—
num	Integer	—
appId	String	—
sign	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SendWithNoResponse　（object）

字段	类型	表 / 列
orderNo	String	—
typeId	String	—
cardNumberList	List<String>	—

示例

请求示例

{
  "orderNo": "",
  "typeId": "",
  "mobile": "",
  "num": 0,
  "appId": "",
  "sign": ""
}

响应示例

{
  "orderNo": "",
  "typeId": "",
  "cardNumberList": []
}

处理逻辑

逻辑摘要openApiCardService.sendWithNo；完整实现见源码 OpenApiCardController#sendWithNo

前端调用方

源码扫描未发现 7 个前端对该接口的调用（可能为开放回调/内部/未上线/管理端动态调用）

POST /card/sendAndBind 在用开放/回调 #

发卡且自动绑定返回卡号等信息 · OpenApiCardController

基本信息

控制器	com.jxxx.dscp.api.controller.openapi.OpenApiCardController#sendAndBind
所属模块	开放接口/对接 `openapi`
暴露渠道	开放/回调（@Route 注解；免登录 auth=false）
请求方法	POST

调用链路 & 涉及数据表

涉及数据表（未解析到业务表：可能为纯校验/转发/缓存/外部接口）

ControllerOpenApiCardController#sendAndBind

ServiceopenApiCardService#sendAndBind

链路按 Controller → Service(Impl) → Mapper → 表 逐层追踪；字段对应的「表.列」见下方请求/响应表新增列，按字段同名映射到涉及的实体表列；— 表示该字段为查询条件 / 计算 / 转换 / 包装字段，未直接对应单一列。

环境 URL

环境	完整 URL（主机 + 渠道前缀 + 路径）	备注
dev	https://dscp-dev.hn12301.net/open-api/card/sendAndBind
uat	https://dscp-uat.hn12301.net/open-api/card/sendAndBind
pro	https://dscp-uat.hn12301.net/open-api/card/sendAndBind	（仓库 .env.pro 指向 uat；生产域名未确认，此处沿用 uat 主机示意）

请求参数 · Header / Query / Path

无（该接口无 Query/Path/Header 显式参数；入参见 Body）

请求参数 · Body　SendAndBindRequest

字段	类型	表 / 列
orderNo	String	—
typeId	String	—
userName	String	—
mobile	String	—
idNo	String	—
idType	Integer	—
img	String	—
appId	String	—
sign	String	—

响应参数

外层包装（chaos 框架自动；前端同时兼容 code/msg）

errcode	int	业务码，0=成功
errmsg	string	提示信息
data	T	下方“data 结构”

data 结构　SendAndBindResponse　（object）

字段	类型	表 / 列
cardModelName	String	—
cardNumber	String	—
validityTime	Date	—
name	String	—
phone	String	—
idType	String	—
idNo	String	—
typeId	String	—
img	String	—

示例

请求示例

{
  "orderNo": "",
  "typeId": "",
  "userName": "",
  "mobile": "",
  "idNo": "",
  "idType": 0,
  "img": "",
  "appId": "",
  "sign": ""
}

响应示例

{
  "cardModelName": "",
  "cardNumber": "",
  "validityTime": "",
  "name": "",
  "phone": "",
  "idType": "",
  "idNo": "",
  "typeId": "",
  "img": ""
}

处理逻辑

逻辑摘要openApiCardService.sendAndBind；完整实现见源码 OpenApiCardController#sendAndBind

前端调用方

pingxiangcard sendAndBind exact

方法	路径	渠道	摘要	调用方
POST	/baidu/chat	开放/回调	—	—
POST	/baidu/getToken	开放/回调	—	—
POST	/bcm/checkCode	开放/回调	—	—
POST	/bcm/sendCard	开放/回调	—	—
POST	/bcm/test	开放/回调	—	—
POST	/bcm/ticketCode	开放/回调	—	—
POST	/beiJing/appoint	开放/回调	—	—
POST	/beiJing/appointInfo	开放/回调	—	—
POST	/beiJing/appointRecord	开放/回调	—	—
POST	/beiJing/bind	开放/回调	—	—
POST	/beiJing/cardRecord	开放/回调	—	—
POST	/beiJing/cardRecordNew	开放/回调	—	—
POST	/beiJing/consume	开放/回调	—	—
POST	/beiJing/getSign	开放/回调	—	—
POST	/beiJing/operatorConsume	开放/回调	—	—
POST	/beiJing/queryCardByIcid	开放/回调	—	—
POST	/beiJing/queryCardByMobile	开放/回调	—	—
POST	/beiJing/queryCardByMobileTest	开放/回调	—	—
POST	/beiJing/queryOrder	开放/回调	—	—
POST	/beiJing/saleAndPay	开放/回调	—	—
POST	/beiJing/token	开放/回调	—	—
POST	/ccb/applyRefund	开放/回调	—	—
POST	/ccb/cancelOrder	开放/回调	—	—
POST	/ccb/cardModelDetail	开放/回调	—	—
POST	/ccb/confirmRefund	开放/回调	—	—
POST	/ccb/createOrder	开放/回调	—	—
POST	/ccb/createPay	开放/回调	—	—
POST	/ccb/getOrder	开放/回调	—	—
POST	/ccb/listProduct	开放/回调	—	—
POST	/ccb/login	开放/回调	—	—
ANY	/jhpay/svc_occOrderStatusNotice	开放/回调	synchronized	—
POST	/cib/cibActiveBind	开放/回调	—	—
POST	/cib/cibCardRecord	开放/回调	兴业银行旅游卡使用记录接口	—
GET	/cib/sendCibCard	开放/回调	—	—
POST	/furongzhen/cancel	开放/回调	—	—
POST	/furongzhen/confirm	开放/回调	—	—
POST	/furongzhen/consume	开放/回调	—	—
POST	/furongzhen/create	开放/回调	—	—
POST	/furongzhen/reConsume	开放/回调	—	—
POST	/furongzhen/refund	开放/回调	—	—
POST	/icbc/closeOrder	开放/回调	平台商户通过该接口对支付中的订单进行主动关单。请求方式：POST	—
GET	/icbc/downloadStatement	开放/回调	B2C对账单下载接口	—
GET	/icbc/downloadStatementByOrder	开放/回调	B2C按订单结算对账单下载接口 acDate 对账日期，格式"yyyy‐MM‐dd" fileType 对账单类型 01：提现对账单 02：超限对账单不传该字段则默认为01	—
POST	/icbc/openAcctNotify	开放/回调	—	—
POST	/icbc/queryOrder	开放/回调	平台商户通过该接口查询订单状态。请求方式：POST	—
POST	/icbc/queryRefund	开放/回调	当退款交易发生之后，平台商户可以通过退款查询接口查询退款单状态。请求方式：POST	—
POST	/icbc/queryUnfreeze	开放/回调	平台商户可以上送发起过确认收货受理的订单，查询该订单的确认收货状态请求方式：POST	—
POST	/icbc/queryWithdraw	开放/回调	平台商户通过该接口查询订单的各个结算状态和结算流水号状态。请求方式：POST	—
POST	/icbc/refundApply	开放/回调	当订单支付成功后，资金为“冻结中”时，由于用户或者商家的原因需要退款时，合作平台可以通过退款申请受理接口将支付款退还给用户原支付账号，该接口支持单笔与并笔的T+1日退款；请求方式：POST	—
GET	/icbc/token	开放/回调	提供各个对账单获取token、随机数接口。请求方式POST	—
POST	/icbc/transDirect	开放/回调	—	—
POST	/icbc/transDirectNotify	开放/回调	—	—
POST	/icbc/unfreezeAccept	开放/回调	平台商户发起担保支付后，子商户该笔订单资金属于冻结状态，不可结算。确认收货成功及对应订单清算完成后资金解冻可结算。请求方式：POST	—
POST	/icbc/wechatPay	开放/回调	商户发起微信小程序、微信公众号、支付宝生活号合并支付时，调用该接口生成支付报文。此接口兼容单订单支付，如果使用此接口进行单订单支付，请参照下方“4.2 biz_content单订单请求参数说明”。请求方式：POST	—
POST	/icbcNotify/acceptNotify	开放/回调	—	—
POST	/icbcNotify/refundNotify	开放/回调	—	—
POST	/icbcNotify/wechatPayNotify	开放/回调	—	—
POST	/nydm/cancelTicket	开放/回调	—	—
POST	/nydm/consumeNotify	开放/回调	—	—
POST	/nydm/manualCheckStatus	开放/回调	—	—
POST	/nydm/order	开放/回调	—	—
POST	/nydm/queryCheckStatus	开放/回调	—	—
POST	/nydm/queryReturnTicket	开放/回调	退票情况查询	—
POST	/nydm/returnTicket	开放/回调	部分退单	—
POST	/card/addOpenApiCardOrder	开放/回调	—	—
POST	/card/cardBag	开放/回调	—	—
POST	/card/cardInfo	开放/回调	—	—
POST	/card/query	开放/回调	—	—
POST	/card/send	开放/回调	—	—
POST	/user/id3MetaVerify	开放/回调	—	—
POST	/cardService/activeAndBind	开放/回调	—	—
POST	/cardService/appoint	开放/回调	—	—
POST	/cardService/appointDetail	开放/回调	—	—
POST	/cardService/appointList	开放/回调	—	—
POST	/cardService/bind	开放/回调	—	—
POST	/cardService/cancelAppoint	开放/回调	—	—
POST	/cardService/cardResource	开放/回调	—	—
POST	/cardService/faceFlag	开放/回调	—	—
POST	/cardService/queryCard	开放/回调	—	—
POST	/cardService/resourceDetail	开放/回调	—	—
POST	/cqy/prepayWx	开放/回调	—	—
POST	/cqy/reapalPayNotify	开放/回调	—	—
POST	/cqy/reapalRefundNotifyCqy	开放/回调	—	—
POST	/pft/notify	开放/回调	—	—
POST	/pingan/cancelNotify	开放/回调	—	—
POST	/pingan/invoiceNotify	开放/回调	—	—
POST	/pingan/notify	开放/回调	—	—
POST	/pingXiang/cancelOrder	开放/回调	—	—
POST	/pingXiang/createOrder	开放/回调	—	—
POST	/pingXiang/prepay	开放/回调	—	—
POST	/pingXiang/wePay/payNotify	开放/回调	—	—
POST	/pingXiang/wePay/refundNotify	开放/回调	—	—
POST	/ssk/card/bind	开放/回调	—	—
POST	/ssk/card/queryByActiveCode	开放/回调	—	—
POST	/ssk/card/queryByNumber	开放/回调	—	—
POST	/ssk/card/queryCardModel	开放/回调	—	—
POST	/ssk/card/queryCardModelDetail	开放/回调	—	—
POST	/ssk/card/send	开放/回调	—	—
POST	/ssk/park/appoint	开放/回调	—	—
POST	/ssk/park/appointCancel	开放/回调	—	—
POST	/ssk/park/appointCardNo	开放/回调	—	—
POST	/ssk/park/appointDetail	开放/回调	—	—
POST	/ssk/park/appointModifyStatus	开放/回调	—	—
POST	/ssk/park/appointOrderCancel	开放/回调	—	—
POST	/ssk/park/bmsCompany	开放/回调	—	—
POST	/ssk/park/cardResourceDetail	开放/回调	—	—
POST	/ssk/park/cardResourceList	开放/回调	—	—
POST	/ssk/park/checkerFace	开放/回调	—	—
POST	/ssk/park/checkerIdentity	开放/回调	—	—
POST	/ssk/park/checkerQR	开放/回调	—	—
POST	/ssk/user/addChecker	开放/回调	—	—
POST	/ssk/user/logon	开放/回调	—	—
POST	/ssk/user/queryCardBag	开放/回调	—	—
POST	/ssk/user/queryChecker	开放/回调	—	—
POST	/ssk/user/token	开放/回调	—	—
POST	/szh/card/appoint	开放/回调	—	—
POST	/szh/card/bind	开放/回调	—	—
POST	/szh/card/cancelAppoint	开放/回调	—	—
POST	/szh/card/consume	开放/回调	核销接口	—
POST	/szh/card/createOrder	开放/回调	—	—
POST	/szh/card/getAppointDetail	开放/回调	—	—
POST	/szh/card/getAppointResourceDetail	开放/回调	预约景区资源详情	—
POST	/szh/card/queryAppointResource	开放/回调	可预约景区资源列表	—
POST	/szh/card/queryAppointment	开放/回调	—	—
POST	/szh/card/queryCard	开放/回调	用户购买卡列表	—
POST	/szh/card/queryMemberCardBindPage	开放/回调	用户绑定的卡-列表	—
POST	/szh/card/queryOrder	开放/回调	—	—
POST	/szh/card/sendBindSmsCode	开放/回调	—	—
POST	/tgy/checkNotify	开放/回调	—	—
POST	/tgy/createOrder	开放/回调	—	—
POST	/tgy/forceConsume	开放/回调	—	—
POST	/tgy/getProduct	开放/回调	—	—
POST	/tgy/pay	开放/回调	—	—
POST	/tgy/query	开放/回调	—	—
POST	/tgy/refund	开放/回调	—	—
POST	/tstc/cancelOrder	开放/回调	—	—
POST	/tstc/createOrder	开放/回调	—	—
POST	/tstc/getOrder	开放/回调	—	—
POST	/tstc/listOrder	开放/回调	—	—
POST	/tstc/notify	开放/回调	—	—
POST	/tstc/productList	开放/回调	—	—
POST	/tstc/productListTstc	开放/回调	—	—
POST	/unicom/toWeb	开放/回调	—	—
POST	/xgh/cancelOrder	开放/回调	—	—
POST	/xgh/cardModelDetails	开放/回调	—	—
POST	/xgh/cleanCacheToken	开放/回调	—	—
POST	/xgh/getAccessToken	开放/回调	—	—
POST	/xgh/getUserWinning	开放/回调	—	—
POST	/xgh/getXghMemberInfo	开放/回调	—	—
GET	/xgh/getXghUnionPayToken	开放/回调	供应商获取银联token	—
POST	/xgh/isXghMemberLevel	开放/回调	—	—
POST	/xgh/isXghZghMember	开放/回调	—	—
POST	/xgh/payNotify	开放/回调	—	—
POST	/xgh/payNotifyDp	开放/回调	—	—
POST	/xgh/payNotifyHotel	开放/回调	—	—
POST	/xgh/payNotifyManual	开放/回调	—	—
POST	/xgh/payNotifyManualBatch	开放/回调	—	—
POST	/xgh/queryUserWinning	开放/回调	—	—
POST	/xgh/queryXghOrder	开放/回调	—	—
POST	/xgh/queryXghRefund	开放/回调	—	—
POST	/xgh/reapalPayNotify	开放/回调	融宝支付回调	—
POST	/xgh/reapalRefundNotify	开放/回调	融宝支付回调	—
POST	/xgh/reapalRefundNotifyTickets	开放/回调	融宝支付回调	—
POST	/xgh/refundBatch	开放/回调	—	—
GET	/xgh/refundManual	开放/回调	—	—
POST	/xgh/refundNotify	开放/回调	—	—
POST	/xgh/refundNotifyDp	开放/回调	—	—
POST	/xgh/refundNotifyHotel	开放/回调	—	—
POST	/xgh/syncOrder	开放/回调	—	—
POST	/xgh/syncOrderByOrderNo	开放/回调	—	—
ANY	/xgh/testReapal	开放/回调	—	—
POST	/xgh/testSms	开放/回调	—	—
POST	/xgh/unionPayNotify	开放/回调	银联通知供应商	—
POST	/xgh/unionPayToken	开放/回调	银联获取token	—
POST	/xiuchuan/login	开放/回调	—	—
POST	/xiuchuan/notify	开放/回调	—	—
POST	/xiuchuan/payToWechat	开放/回调	—	—
POST	/xiuchuan/querySignState	开放/回调	—	—
POST	/xjhlc/cancelOrder	开放/回调	—	—
POST	/xjhlc/createOrder	开放/回调	—	—
POST	/xjhlc/notify	开放/回调	—	—
POST	/xjhlc/queryOrder	开放/回调	—	—
POST	/xjhlc/queryProduct	开放/回调	—	—
POST	/ysf/getCardModelBySku	开放/回调	—	—
POST	/ysf/getScenicRuleList	开放/回调	—	—
POST	/ysf/getUserCardBindInfo	开放/回调	—	—
POST	/ysf/getUserInfo	开放/回调	—	—
POST	/ysf/listProduct	开放/回调	—	—
POST	/ybx/notify	开放/回调	—	—
POST	/ybx/orderAndPay	开放/回调	—	—
GET	/ybx/queryAccount	开放/回调	—	—
GET	/ybx/queryOrder	开放/回调	—	—
POST	/ybx/refund	开放/回调	—	—
POST	/zfb/cancelOrder	开放/回调	—	—
POST	/zfb/cardModelDetail	开放/回调	—	—
POST	/zfb/createOrder	开放/回调	—	—
POST	/zfb/getOrder	开放/回调	—	—
POST	/zfb/listOrder	开放/回调	—	—
POST	/zfb/listProduct	开放/回调	—	—
POST	/zfb/notify	开放/回调	应用网关统一回调接口退款通知	—
POST	/zfb/openCard	开放/回调	TODO 用户确认领卡后，通过该openspi，回调商家，商家通过该接口返回相关的会员卡信息	—
POST	/zfb/payNotify	开放/回调	支付成功通知	—
POST	/zfb/prepay	开放/回调	—	—
POST	/zfb/queryOrder	开放/回调	—	—
POST	/zfb/recommendProduct	开放/回调	—	—
POST	/zfb/refund	开放/回调	行业订单退款接口	—
POST	/zfb/voucherApply	开放/回调	当用户下单支付成功后申请服务商做凭证的发放	—
POST	/zfb/voucherRefund	开放/回调	行业凭证退款接口	—
GET	/zfb/voucherRefundManual	开放/回调	—	—
POST	/zfb/voucherVerify	开放/回调	年卡激活凭证核销	—
POST	/zhy/card/send	开放/回调	用于建行发卡	—

开放接口/对接 openapi

CibController 3/12 在用

OpenapiBjcAppointConfigController 0/6 在用

OpenapiBjcAppointRecordController 0/6 在用

OpenapiBjcAppointScenicController 0/6 在用

OpenapiBjcCardInfoController 0/6 在用

OpenapiBjcConsumeRecordController 0/6 在用

OpenapiBjcLogController 0/6 在用

OpenapiBjcTokenController 0/6 在用

OpenapiCardConfigController 0/6 在用

OpenapiChannelBusinessController 0/6 在用

OpenapiChannelCardController 0/6 在用

OpenapiChannelInfoController 6/6 在用

OpenapiChannelOperatorController 5/6 在用

OpenapiChannelOrderController 0/6 在用

OpenapiChannelRuleController 5/6 在用

OpenapiCqyRecordController 14/20 在用

OpenapiIcbcLogController 0/6 在用

OpenapiLogController 0/6 在用

OpenapiNydmOrderController 0/6 在用

OpenapiPftRecordController 0/6 在用

OpenapiPinganRecordController 2/6 在用

OpenapiPlatformInfoController 0/6 在用

OpenapiSskCardController 0/6 在用

OpenapiSskUserController 0/6 在用

OpenapiTgyOrderController 0/6 在用

OpenapiTicketCodePoolController 4/4 在用

OpenapiTstcOrderController 0/6 在用

OpenapiXcLogController 0/6 在用

OpenapiXghPurchageController 1/7 在用

OpenapiXjhlcOrderController 0/6 在用

OpenapiYbxOrderController 0/6 在用

OpenapiYbxTicketController 0/6 在用

PingXiangController 2/5 在用

TstcController 0/1 在用

XghController 12/12 在用

YouBaoXingController 1/1 在用

ZfbCardController 5/5 在用

HhCardLogController 0/6 在用

HuaiHuaController 1/2 在用

MeiKeController 1/1 在用

OpenApiCardController 1/4 在用