POST
/cardBag/cardResource管理后台质惠游获取可预约资源
C 端聚合接口 / 卡包
基本信息
- 接口状态前端在用 免鉴权
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/cardBag/cardResource - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台、质惠游 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台、湘工惠商城(2 个前端)
- 需求上下文
- 维护人 / 最后改动liuxu 2024-07-26
- 读写数据表
card_model、system_dict_data、card_num_appoint_rule反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.zhy.CardBagController#cardResource - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/zhy/CardBagController.java:198 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无(渠道统一鉴权头见《认证方式》) | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| channel | … | 否 | ChannelType | → card_model.channel 1=北京卡管理系统 2=三省卡系统 3=数字平台 4=质惠游 5=支付宝 6=兴业银行 7=湘工惠 8=湘约码 |
| thirdId | … | 否 | String | → card_model.third_id |
| cardNum | … | 否 | String | → card_num_appoint_rule.card_num |
| queryType | … | 否 | Integer | 1=所有 2=需预约的 |
| name | … | 否 | String | → card_model.name |
| pageSize | … | 否 | Integer | |
| pageNum | … | 否 | Integer | |
| cityCode | … | 否 | Long | |
| level | … | 否 | Integer |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| total | … | 否 | Integer | |
| list | … | 否 | List<ScenicInfoBean> | |
| scenicId | … | 否 | String | |
| scenicName | … | 否 | String | |
| openTime | … | 否 | String | |
| signValidDate | … | 否 | String | |
| price | … | 否 | String | → card_model.price |
| scenicImageUrl | … | 否 | String | |
| usedTimes | … | 否 | Integer | |
| openFlag | … | 否 | Integer | 是否开放(0=否 1=是) |
| detailFlag | … | 否 | Integer | 1=有详情,需跳转 0=无详情,直接预约 |
| discountType | … | 否 | Integer | 优惠类型(1无限次;2=总计免次数;3=每月免次数;4=每日免次数;5=原价折扣度;6=原价减额度 |
| appointFlag | … | 否 | Integer | 1=需预约 0=无须预约 |
| advanceDay | … | 否 | Integer | 提前天数 |
| appointDay | … | 否 | Integer | 可预约天数 |
| discountPercentage | … | 否 | Integer | 折扣百分比(%) |
| discountAmount | … | 否 | Integer | 优惠后金额 |
| totalTimes | … | 否 | Integer | 总共可使用次数 |
| monthTimes | … | 否 | Integer | 每月可使用次数 |
| dayTimes | … | 否 | Integer | 每天可使用次数 |
| cardInstruction | … | 否 | String | 持卡使用说明 |
| notice | … | 否 | String | 预约须知 |
| prompt | … | 否 | String | 温馨提示 |
| grade | … | 否 | String | → card_model.grade |
| isAppointmentPay | … | 否 | Integer | |
| appointmentPayAmount | … | 否 | Integer | 付费金额(元) |
| isCheckRefund | … | 否 | Integer | 入园后是否退款 1是 |
| cityList | … | 否 | List<CardBagResourceCityResponse> | |
| cityCode | … | 否 | Long | |
| cityName | … | 否 | String |
响应示例
成功响应示例
{
"errcode": 0,
"errmsg": "",
"data": {
"total": "1",
"list": "[]",
"scenicId": "\"string\"",
"scenicName": "\"string\"",
"openTime": "\"string\"",
"signValidDate": "\"string\"",
"price": "\"string\"",
"scenicImageUrl": "\"string\"",
"usedTimes": "1",
"openFlag": "1",
"detailFlag": "1",
"discountType": "1"
}
}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:card_model、system_dict_data、card_num_appoint_rule 反查全部引用接口 →
- CardBagController#cardResource
- CardBagService#cardResource(CardBagServiceImpl)
其它依赖:CardCheckHandlerCache.get
逻辑摘要:调用 cardResource(cardBagService.cardResource)
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)
调用点证据
dscp-html-manage/src/api/card/index.ts:314管理后台 · requestxghmall/common/http.api.js:18湘工惠商城 · cardResourceUrl