POST
/cardStock/queryCardStockCount管理后台查询当前库存最多可分配数量
旅游卡 / 库存
基本信息
- 接口状态前端在用
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/cardStock/queryCardStockCount - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方已确认在用 · 管理后台(1 个前端)
- 需求上下文
- 维护人 / 最后改动luoli 2023-12-15
- 读写数据表
card_stock反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.card.CardStockController#queryCardStockCount - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardStockController.java:228 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无(渠道统一鉴权头见《认证方式》) | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| cardModelId | … | 否 | Long | 旅游卡种ID,关联旅游卡种表ID → card_stock.card_model_id |
| cardType | … | 否 | CardType | 卡类型,1电子卡,2实体卡(带芯片),3实体卡(不带芯片) → card_stock.card_type 1=电子卡 2=实体卡(带芯片) 3=实体卡(不带芯片) |
| status | … | 否 | StockStatus | 状态,1待分配,2已分配 → card_stock.status 1=待分配 2=已分配 |
| assignmentType | … | 否 | AssignmentType | 分配对象类型,1商户,2商铺 → card_stock.assignment_type 1=商户 2=商铺 3=个人 |
| businessId | … | 否 | Long | 分配对象(商户/商铺ID) → card_stock.business_id |
| idList | … | 否 | List<Long> | id列表 |
| keywords | … | 否 | String | 关键字 |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 未解析到返回结构 | ||||
响应示例
附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:card_stock 反查全部引用接口 →
- CardStockController#queryCardStockCount
逻辑摘要:查询详情(cardStockService.getMapper)
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)
调用点证据
dscp-html-manage/src/api/card/index.ts:79管理后台 · request