POST/cardStock/queryCardStockSegment管理后台

查询当前卡号段可分配数量

旅游卡 / 库存· CardStockController#queryCardStockSegment

接口状态前端在用置信度高
接口URLPOSThttps://dscp-dev.hn12301.net/manage-api/cardStock/queryCardStockSegment
请求方式POST
Content-Typeapplication/json
暴露渠道管理后台　前缀 /manage-api
名称来源源码注释
调用方已确认在用 · 管理后台（1 个前端）
需求上下文1
维护人 / 最后改动luoli　2023-12-15　最近提交：1
读写数据表card_stock　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.card.CardStockController#queryCardStockSegment
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/card/CardStockController.java:202
判定依据1 个调用点：dscp-html-manage/src/api/card/index.ts

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

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

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

Body 类型 CardStockSegmentRequest

参数名	参数值	是否必填	参数类型	描述说明
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
batchCode	…	否	String	→ card_stock.batch_code
segmentMin	…	否	String	分配卡号段开始
segmentMax	…	否	String	分配卡号段结束
idList	…	否	List<Long>	id列表
keywords	…	否	String	关键字

需登录态：Authorization: Bearer <token>（多租户另带 tenant-id）；30002 会话失效需重登。详见全局公共参数。

data 类型 CardStockSegmentResponse

参数名	参数值	是否必填	参数类型	描述说明
batchCode	…	否	String	卡批次号 → card_stock.batch_code
segmentCount	…	否	int	申请人

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "batchCode": "\"string\"",
    "segmentCount": "1"
  }
}

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

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

涉及数据表：card_stock　反查全部引用接口 →

逻辑摘要：查询详情（cardStockService.getMapper）；调用 isNotEmpty（CollectionUtil.isNotEmpty）

源码内联注释（旧站解析结果）

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

调用点证据