总览 / 业务域 / 旅游卡

旅游卡 业务总览

发卡·卡批次·卡库存·卡预约·卡资源规则·人脸核销改造

183接口数
101已确认在用
19子域
5免鉴权接口
9缺摘要
44涉及数据表
要看接口明细:旅游卡 接口清单 →(默认只显示契约,调用链与示例折叠;每页最多 46 个接口)

这个域里有哪些业务对象

子域 / 业务对象接口在用代表接口控制器
二维码11createCardQRCodeCardQRCodeController
分配85addCardAssignment deleteCardAssignment downloadCardAssignment getCardAssignment …共 8 个CardAssignmentController
卡号规则73addCardNumberRule deleteCardNumberRule getByModelRuleId getCardNumberRule …共 7 个CardNumberRuleController
卡号预约规则60addCardNumAppointRule deleteCardNumAppointRule getCardNumAppointRule queryCardNumAppointRuleList …共 6 个CardNumAppointRuleController
卡种87addCardModel copyCardModelResource deleteCardModel getCardModel …共 8 个CardModelController
卡种·公告75addCardModelNotice deleteCardModelNotice getCardModelNotice queryCardModelNoticeList …共 7 个CardModelNoticeController
卡种·规则83addCardModelRule deleteCardModelRule getByModelRuleId getCardModelNotice …共 8 个CardModelRuleController
卡(主表)3321addCard addCardBind addCardOrder bindBatch …共 33 个CardController
套餐规则33addCardPackageRule deleteCardPackageRule queryCardPackageRuleCardPackageRuleController
套餐规则·资源·资源包61addCardPackageRuleResourcePacket deleteCardPackageRuleResourcePacket getCardPackageRuleResourcePacket queryCardPackageRuleResourcePacketList …共 6 个CardPackageRuleResourcePacketController
库存116addCardStock countCardStockRemain deleteCardStock exportCardStock …共 11 个CardStockController
批次95addCardBatch deleteCardBatch downloadCardBatch downloadCardStockChip …共 9 个CardBatchController
核销147addCardCheck cardCheckFootPrintList cardCheckPage deleteCardCheck …共 14 个CardCheckController
绑定74addCardBind getCardBind getMemberCardBind queryCardBindPage …共 7 个CardBindController
资源档期·场次63addCardResourceCalenderTimeSlot deleteCardResourceCalenderTimeSlot getCardResourceCalenderTimeSlot queryCardResourceCalenderTimeSlotList …共 6 个CardResourceCalenderTimeSlotController
资源档期与场次94addCardResourceCalender deleteCardResourceCalender deleteCardResourceEnabled getCardResourceCalender …共 9 个CardResourceCalenderController
资源规则2316addCardResourceRule batchResourceOffline batchResourceOnline batchUpdateStatus …共 23 个CardResourceRuleController
预约116addCardAppointment cancelCardAppointment cardAppointmentPage deleteCardAppointment …共 11 个CardAppointmentController
预约·支付61addCardAppointmentPayment deleteCardAppointmentPayment getCardAppointmentPayment queryCardAppointmentPaymentList …共 6 个CardAppointmentPaymentController

本域常用状态与类型字典

值与含义直接来自后端枚举类,不是人工整理。

类型含义(源码注释)用到接口取值
ChannelType所属渠道,1北京卡管理系统,2三省卡系统,3数字平台,4质惠游691=北京卡管理系统 2=三省卡系统 3=数字平台 4=质惠游 5=支付宝 6=兴业银行 7=湘工惠 8=湘约码
OrderStatus订单状态,1=待确认 2=已确认 3=待发货 4=已发货 5=已完成 6=已取消491=待支付 2=待发货 3=已发货 4=已完成 5=已取消 6=退款中 7=已退款
PayStatus支付状态,1=待支付 2=已支付 3=已退款451=待支付 2=已支付 3=已退款 4=退款失败 5=退款中 6=退款申请
CardType卡类型,1电子卡,2实体卡(带芯片),3实体卡(不带芯片)381=电子卡 2=实体卡(带芯片) 3=实体卡(不带芯片)
IdType证件类型,1身份证,2护照,3港澳通行证,4台胞证,5驾驶证,6居住证,7士官证,8学生证,9出生证351=身份证 2=护照 3=港澳居民来往内地通行证 5=驾驶证 6=居住证 7=士官证 8=学生证
OrderSource订单来源,1H5,2微信小程序,3支付宝小程序,4安卓APP,5IOSAPP311=H5 2=微信小程序 3=支付宝小程序 4=安卓APP 5=IOSAPP 6=YOUZHENG 7=XIANGGONGHUI 8=XIANGYUEMA 9=ZHIHUIYOU 10=BCM 11=JIANHANG 24=MEIKE
OrderType订单类型,1旅游年卡,2美食特产,3生活好物,4自驾路线,5非遗专区,6景区套票,7酒店民宿,8餐饮美食291=景区套票 2=酒店民宿 3=餐饮美食 4=美食特产 5=自驾路线 6=非遗专区 7=旅游卡 8=旅游卡
AssignmentType分配对象类型,1商户,2商铺281=商户 2=商铺 3=个人
ModelGrade卡种等级,1一类卡,2二类卡251=一类卡 2=二类卡 3=公式卡
Preferential优惠方式,1免费,2折扣,3优惠211=免费 2=折扣 3=优惠
SettlementWay结算方式211=按刷卡次数 2=买断 3=分成 4=按分配金额统一计算 5=月度均衡分配计算
CardModelType卡种类型,1省级旅游卡,2市州旅游卡201=省级旅游卡 2=市州旅游卡
PaymentMode交易方式(PaymentMode),1=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他191=积分 2=优惠券 3=微信 4=支付宝 5=工商银行 6=其他 7=湘工惠 8=建行
CardState卡状态,1待售,2待绑定,3正常,4挂失,5过期,6损坏,7冻结181=待销售 2=待激活 3=已激活 4=已绑定 5=已禁用 6=已过期 7=已无效 8=已锁定

读写最多的数据表

数据表被多少接口读写反查
card_resource_rule36全部引用
card34全部引用
card_model15全部引用
card_appointment14全部引用
card_bind14全部引用
card_model_rule14全部引用
card_stock14全部引用
card_check11全部引用
card_resource_calender10全部引用
card_package_rule_resource_packet9全部引用
card_resource_calender_time_slot8全部引用
card_batch8全部引用
看这里需要注意:5 个接口是 @Route(auth=false) 免鉴权(不校验登录态),改动前确认调用方与签名校验。
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写,均来自同一份数据