POST
/cardStock/updateCardStock管理后台卡库存表-更新
旅游卡 / 库存
基本信息
- 接口状态未见调用·长期未改动(待确认)
- 接口URLPOST
https://dscp-dev.hn12301.net/manage-api/cardStock/updateCardStock - 请求方式
POST - Content-Type
application/json - 暴露渠道管理后台 前缀
/manage-api - 名称来源源码注释
- 调用方本次扫描未发现调用
- 需求上下文
- 维护人 / 最后改动AsiQue 2023-12-08
- 读写数据表
card_stock反查该表全部接口 → - 控制器
com.jxxx.dscp.api.controller.card.CardStockController#updateCardStock - 源码位置
jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardStockController.java:178 - 判定依据
请求参数
Header 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无(渠道统一鉴权头见《认证方式》) | ||||
Query 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
路径参数及说明
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| 无 | ||||
Body 请求参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| id | … | 是 | Long | ID,主键 → card_stock.id |
| cardNumber | … | 是 | String | 卡号,规则参照card_number_rule → card_stock.card_number |
| activeCode | … | 是 | String | 激活码,激活码规则:随机码,包含大写字母、数字。激活码位数12位 → card_stock.active_code |
| cardModelId | … | 是 | Long | 旅游卡种ID,关联旅游卡种表ID → card_stock.card_model_id |
| cardModelName | … | 否 | String | 卡种名称,冗余字段 → card_stock.card_model_name |
| cardType | … | 是 | CardType | 卡类型,1电子卡,2实体卡(带芯片),3实体卡(不带芯片) → card_stock.card_type 1=电子卡 2=实体卡(带芯片) 3=实体卡(不带芯片) |
| chipCode | … | 否 | String | 芯片码 → card_stock.chip_code |
| batchCode | … | 否 | String | 卡批次号 → card_stock.batch_code |
| 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 |
| applicant | … | 否 | String | 申请人 → card_stock.applicant |
认证方式
响应参数
| 参数名 | 参数值 | 是否必填 | 参数类型 | 描述说明 |
|---|---|---|---|---|
| void —— 不返回业务数据(外层包装见全局公共参数) | ||||
响应示例
成功响应示例
{"errcode":0,"errmsg":""}附录 · 实现细节
调用链 / 数据表 / 调用点证据 / 源码注释 / 逻辑摘要
涉及数据表:card_stock 反查全部引用接口 →
- CardStockController#updateCardStock
- CardStockService#update(CardStockServiceImpl)
- CardStockMapper#update
- BeanUtils.map → CardStock ⇒ 表 card_stock
逻辑摘要:更新(cardStockService.update);入参与返回值经 BeanUtils 做对象/分页映射
操作日志:card / 更新卡库存
旧站环境备注:pro:(仓库 .env.pro 指向 uat;生产域名未确认,此处沿用 uat 主机示意)