POST/zfb/cardModelDetails开放/回调

支付宝-卡卡种Details · cardModelDetails 推断名·方法名推断

开放与对接 / 支付宝· ZfbCardController#cardModelDetails

基本信息

接口状态前端在用置信度高免鉴权
接口URLPOSThttps://dscp-dev.hn12301.net/open-api/zfb/cardModelDetails
请求方式POST
暴露渠道开放/回调　前缀 /open-api
名称来源方法名推断　补 javadoc 后自动转正
调用方已确认在用 · 湘工惠商城（1 个前端）
需求上下文1
维护人 / 最后改动hao　2024-11-27　最近提交：1
读写数据表sku、goods_info、goods_channel　反查该表全部接口 →
控制器com.jxxx.dscp.api.controller.openapi.ZfbCardController#cardModelDetails
源码位置jxxx-dscp/dscp-service-business/src/main/java/com/jxxx/dscp/api/controller/openapi/ZfbCardController.java:114
判定依据1 个调用点：xghmall/common/http.api.js

请求参数

Header 请求参数

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

Query 请求参数

参数名	参数值	是否必填	参数类型	描述说明
goodsIds	…	是	List

路径参数及说明

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

Body 请求参数

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

认证方式

免鉴权：@Route(auth = false) —— 该接口不校验登录态，改动前确认调用方与签名校验。

响应参数

data 类型 List<ZfbCardDetail>

参数名	参数值	是否必填	参数类型	描述说明
cardModel	…	否	CardModel
id	…	否	Long	旅游卡种ID，主键 → sku.id
name	…	否	String	卡种名称
grade	…	否	ModelGrade	卡种等级，1一类卡，2二类卡 1＝一类卡 2＝二类卡 3＝公式卡
cardModelType	…	否	CardModelType	卡种类型，1省级旅游卡，2市州旅游卡 1＝省级旅游卡 2＝市州旅游卡
code	…	否	Integer	卡种编号: 2 位数，从10 开始。10、11、12、顺序编号
merchantId	…	否	Long	所属商户 → sku.merchant_id
shopId	…	否	Long	所属商铺，关联商铺表id → sku.shop_id
shopName	…	否	String	所属商铺名称
channel	…	否	ChannelType	所属渠道，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游
thirdId	…	否	String	第三方id
price	…	否	Integer	卡种售价
expireDate	…	否	Date	失效日期 → goods_info.expire_date
publishDate	…	否	Date	发行日期
isFace	…	否	Boolean	是否需要人脸
isActiveCode	…	否	Boolean	是否需要激活码
isRefresh	…	否	Boolean	二维码是否刷新
propagateStyle	…	否	String	宣传卡样url地址
propagatePic	…	否	String	宣传图片url地址 → goods_info.propagate_pic
propagateVid	…	否	String	宣传视频url地址
description	…	否	String	图文详情
isDeleted	…	否	Boolean	是否删除 → sku.is_deleted
createdBy	…	否	Long	创建人id → sku.created_by
createdTime	…	否	Date	创建时间 → sku.created_time
updatedBy	…	否	Long	更新人id → sku.updated_by
updatedTime	…	否	Date	修改时间 → sku.updated_time
goods	…	否	Goods
id	…	否	Long	商品id，主键 → sku.id
merchantId	…	否	Long	所属商户id，关联merchant表id → sku.merchant_id
shopId	…	否	Long	所属商铺id → sku.shop_id
name	…	否	String	商品名称
cardModelId	…	否	Long	旅游卡ID，关联旅游卡表id
mainPic	…	否	String	商品主图
typeId	…	否	String	商品大类
subTypeId	…	否	String	商品小类
grade	…	否	String	商品等级
status	…	否	GoodsStatus	商品状态，1正常，2编辑中，3已下架 → goods_channel.status 1＝已上架 2＝编辑中 3＝已下架
qrcode	…	否	String	商品二维码
isDeleted	…	否	Boolean	是否删除 → sku.is_deleted
createdBy	…	否	Long	创建人 → sku.created_by
createdTime	…	否	Date	创建时间 → sku.created_time
updatedBy	…	否	Long	修改人 → sku.updated_by
updatedTime	…	否	Date	修改时间 → sku.updated_time
thirdId	…	否	String	第三方id
thirdName	…	否	String	第三方名称
goodsInfo	…	否	GoodsInfo
id	…	否	Long	商品id，主键 → sku.id
shortName	…	否	String	商品简称 → goods_info.short_name
weight	…	否	Integer	商品权重 → goods_info.weight
tags	…	否	String	商品标签 → goods_info.tags
businessTime	…	否	String	营业时间 → goods_info.business_time
recommendReason	…	否	String	推荐理由 → goods_info.recommend_reason
introduction	…	否	String	简介 → goods_channel.introduction
propagatePic	…	否	String	宣传图片url地址 → goods_info.propagate_pic
video	…	否	String	宣传视频url地址 → goods_info.video
notice	…	否	String	购买须知 → goods_info.notice
tips	…	否	String	温馨提示 → goods_info.tips
expireDate	…	否	Date	→ goods_info.expire_date
isRefund	…	否	Boolean	→ goods_info.is_refund
isDeleted	…	否	Boolean	是否删除 → sku.is_deleted
createdBy	…	否	String	创建人id → sku.created_by
createdTime	…	否	LocalDateTime	创建时间 → sku.created_time
updatedBy	…	否	String	更新人id → sku.updated_by
updatedTime	…	否	LocalDateTime	更新时间 → sku.updated_time
sku	…	否	List<Sku>
id	…	否	Long	商品skuID，主键 → sku.id
merchantId	…	否	Long	所属商户id → sku.merchant_id
shopId	…	否	Long	所属商铺id → sku.shop_id
goodsId	…	否	Long	商品ID，关联商品表id → sku.goods_id
goodsChannelId	…	否	Long	关联商品渠道id → sku.goods_channel_id
skuName	…	否	String	sku名称 → sku.sku_name
showPrice	…	否	Integer	商品挂牌价 → sku.show_price
buyPrice	…	否	Integer	商品实际售价 → sku.buy_price
costPrice	…	否	Integer	商品成本价 → sku.cost_price
buyCount	…	否	Integer	单次可购买数量 → sku.buy_count
stock	…	否	Integer	库存数量 → sku.stock
isLogistic	…	否	Boolean	是否需要物流 → sku.is_logistic
carriageId	…	否	Long	物流模版ID，关联carriage表id → sku.carriage_id
mold	…	否	GoodsMold	商品状态，1实物商品，2虚拟商品，3电子卡券 → sku.mold 1＝实物商品 2＝虚拟商品 3＝电子卡券
isDistributes	…	否	Boolean	是否可分销 → sku.is_distributes
commission	…	否	Integer	分销佣金 → sku.commission
isPreferential	…	否	Boolean	是否可使用优惠券 → sku.is_preferential
isUseScore	…	否	Boolean	是否可使用积分抵扣 → sku.is_use_score
isAddScore	…	否	Boolean	购买后是否产生积分 → sku.is_add_score
useScoreRate	…	否	BigDecimal	抵扣积分倍率 → sku.use_score_rate
addScoreRate	…	否	BigDecimal	产生积分倍率 → sku.add_score_rate
cardNum	…	否	Integer	发卡数量，仅旅游卡商品 → sku.card_num
isDeleted	…	否	Boolean	是否删除 → sku.is_deleted
createdBy	…	否	String	创建人id → sku.created_by
createdTime	…	否	Date	创建时间 → sku.created_time
updatedBy	…	否	String	更新人id → sku.updated_by
updatedTime	…	否	Date	修改时间 → sku.updated_time
shop	…	否	Shop
id	…	否	Long	商铺id，主键 → sku.id
merchantId	…	否	Long	所属商户id，关联merchant表id → sku.merchant_id
merchantType	…	否	MerchantType	商户类型 1＝供应商 2＝分销商 3＝发卡商 4＝其他 5＝酒店 6＝第三方
name	…	否	String	商铺名称
logo	…	否	String	商铺LOGO图片url地址
typeId	…	否	Long	商铺大类
subTypeId	…	否	Long	商铺小类ID
status	…	否	ShopStatus	商铺状态，1正常运营，2审核中，3暂停运营，4已关店 → goods_channel.status 1＝正常运营 2＝审核中 3＝暂停运营 4＝已关店
provinceId	…	否	String	省id
cityId	…	否	String	市id
districtId	…	否	String	区县id
address	…	否	String	商铺地址
mobile	…	否	String	客服电话
linkman	…	否	String	商户联系人
linkphone	…	否	String	商户联系人手机
manager	…	否	String	专属客户经理
level	…	否	String	等级
lng	…	否	String	经度
lat	…	否	String	纬度
introduction	…	否	String	简介 → goods_channel.introduction
businessTime	…	否	String	营业时间 → goods_info.business_time
tags	…	否	String	商铺标签 → goods_info.tags
mainPic	…	否	String	景区主图url地址
propagatePic	…	否	String	宣传图片url地址 → goods_info.propagate_pic
video	…	否	String	景区视频url地址 → goods_info.video
poster	…	否	String	分享海报url地址
propagateContent	…	否	String	宣传语
description	…	否	String	图文详情
ticketInfo	…	否	String	门票信息
trafficInfo	…	否	String	交通信息
tips	…	否	String	温馨提示 → goods_info.tips
isDeleted	…	否	Boolean	是否删除 → sku.is_deleted
createdBy	…	否	String	创建人id → sku.created_by
createdTime	…	否	Date	创建时间 → sku.created_time
updatedBy	…	否	String	更新人id → sku.updated_by
updatedTime	…	否	Date	修改时间 → sku.updated_time
thirdId	…	否	String
thirdName	…	否	String
goodsChannel	…	否	GoodsChannel
id	…	否	Long	→ sku.id
goodsChannelName	…	否	String	商品渠道名称 → goods_channel.goods_channel_name
goodsId	…	否	Long	商品id(关联goods表id) → sku.goods_id
skuId	…	否	Long	关联skuId → goods_channel.sku_id
merchantId	…	否	Long	商品所属商户id → sku.merchant_id
shopId	…	否	Long	商品所属商铺id → sku.shop_id
channelMerchantId	…	否	Long	渠道商户id → goods_channel.channel_merchant_id
channelShopId	…	否	Long	渠道商铺id → goods_channel.channel_shop_id
originGoodsId	…	否	Long	源头商品id → goods_channel.origin_goods_id
originSkuId	…	否	Long	源头skuId → goods_channel.origin_sku_id
maxSalesPrice	…	否	Integer	最大销售价格 → goods_channel.max_sales_price
minSalesPrice	…	否	Integer	最小销售价格/分 → goods_channel.min_sales_price
stock	…	否	Integer	初始库存 → sku.stock
introduction	…	否	String	资源说明 → goods_channel.introduction
remark	…	否	String	备注 → goods_channel.remark
status	…	否	GoodsChannelStatus	状态，1已上架，2编辑中，3已下架 → goods_channel.status 1＝已上架 2＝编辑中 3＝已下架
isDeleted	…	否	Boolean	是否删除 → sku.is_deleted
createdBy	…	否	String	创建人id → sku.created_by
createdTime	…	否	Date	→ sku.created_time
updatedBy	…	否	String	更新人id → sku.updated_by
updatedTime	…	否	Date	→ sku.updated_time
salesNum	…	否	Integer

响应示例

成功响应示例 code=0

{
  "errcode": 0,
  "errmsg": "",
  "data": {
    "cardModel": "…",
    "id": "1",
    "name": "\"string\"",
    "grade": "1",
    "cardModelType": "1",
    "code": "1",
    "merchantId": "1",
    "shopId": "1",
    "shopName": "\"string\"",
    "channel": "…",
    "thirdId": "\"string\"",
    "price": "1"
  }
}

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

附录 · 实现细节

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

涉及数据表：sku、goods_info、goods_channel　反查全部引用接口 →

ZfbCardController#cardModelDetails
ZfbCardService#productDetail（ZfbCardServiceImpl）
SkuService#queryList（SkuServiceImpl）
SkuMapper#queryList

其它依赖：GoodsCache.get、CardModelCache.get、ShopCache.get

逻辑摘要：调用 productDetail（zfbService.productDetail）

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

调用点证据

xghmall/common/http.api.js:29　湘工惠商城 · cardModelDetailsUrl