总览 / 业务域 / C 端聚合接口
C 端聚合接口
面向小程序/H5/公众号的聚合接口（zhy、mp、hhrs、萍乡、美客）
57接口数
45已确认在用
14子域
48免鉴权接口
48缺摘要
34涉及数据表
要看接口明细：C 端聚合接口 接口清单 →（默认只显示契约，调用链与示例折叠；每页最多 46 个接口）
这个域里有哪些业务对象
| 子域 / 业务对象 | 接口 | 在用 | 代表接口 | 控制器 |
|---|---|---|---|---|
| 中奖 | 2 | 2 | dates list | HhrsWinnerController |
| 中奖·管理 | 4 | 4 | delete downloadTemplate import queryPage | HhrsWinnerManageController |
| 内容·管理 | 5 | 5 | add delete get queryPage | MpContentManageController |
| 卡包 | 22 | 15 | addCardNumRule appoint appointRecord appointmentPrepay | CardBagController |
| 小程序·内容 | 2 | 1 | getDetail queryList | MpContentController |
| 小程序·卡 | 1 | 1 | checkFaceBind | MpCardController |
| 店铺公告 | 1 | 1 | queryShopNoticePage | MpShopNoticeController |
| 怀化人社用户 | 1 | 0 | mpUserInfoDecode | HuaiHuaUserController |
| 景区 | 4 | 3 | getScenicDetail queryFilterOptions queryScenicList queryScenicRegions | MpScenicController |
| 权益 | 5 | 5 | list list detail eligibility | HhrsRightsController |
| 登录鉴权 | 1 | 0 | login | AuthController |
| 订单 | 2 | 2 | getOrderDetail queryOrderList | MpOrderController |
| 门店 | 2 | 2 | detail list | HhrsStoreController |
| 预约 | 5 | 4 | checkCardBind getAppointmentDetail getUsageRecordDetail queryReserveOptions | MpReserveController |
本域常用状态与类型字典
值与含义直接来自后端枚举类，不是人工整理。
| 类型 | 含义（源码注释） | 用到接口 | 取值 |
|---|---|---|---|
ChannelType | 所属渠道，1北京卡管理系统，2三省卡系统，3数字平台，4质惠游 | 69 | 1＝北京卡管理系统 2＝三省卡系统 3＝数字平台 4＝质惠游 5＝支付宝 6＝兴业银行 7＝湘工惠 8＝湘约码 |
ModelGrade | 卡种等级，1一类卡，2二类卡 | 25 | 1＝一类卡 2＝二类卡 3＝公式卡 |
GoodsStatus | 商品状态，1正常，2编辑中，3已下架 | 24 | 1＝已上架 2＝编辑中 3＝已下架 |
Preferential | 优惠方式，1免费，2折扣，3优惠 | 21 | 1＝免费 2＝折扣 3＝优惠 |
SettlementWay | 结算方式 | 21 | 1＝按刷卡次数 2＝买断 3＝分成 4＝按分配金额统一计算 5＝月度均衡分配计算 |
CardModelType | 卡种类型，1省级旅游卡，2市州旅游卡 | 20 | 1＝省级旅游卡 2＝市州旅游卡 |
BinderType | 绑定人类型，1本人，2亲友 | 10 | 1＝本人 2＝亲友 |
AppointmentStatus | 预约状态，1预约成功，2预约失败，3已取消,4已入园 | 9 | 1＝预约成功 2＝已关闭 3＝已取消 4＝已入园 |
TicketPriceModel | 签约门票定价方式 | 8 | 1＝统一定价 2＝周期定价 |
ResourceStatus | 资源上下架状态，1已上架，2编辑中，3已下架 | 7 | 1＝已上架 2＝编辑中 3＝已下架 |
CheckSettlementType | 刷卡次数结算方式 | 7 | 1＝签约计价 2＝阶梯计价 3＝阈值计价 |
BelowCostSettlementWay | 平均单价未达保本单价时结算方式 | 7 | 1＝按保本单价补充金额 2＝按实际金额计算 |
AboveCostSettlementWay | 平均单价高于保本单价时结算方式 | 7 | 1＝按保本单价计算金额 2＝按实际金额计算 |
读写最多的数据表
| 数据表 | 被多少接口读写 | 反查 |
|---|---|---|
card_model | 11 | 全部引用 |
card_bind | 10 | 全部引用 |
card_resource_rule | 10 | 全部引用 |
mp_content | 7 | 全部引用 |
member | 5 | 全部引用 |
card_appointment | 5 | 全部引用 |
shop | 5 | 全部引用 |
hhrs_winner | 5 | 全部引用 |
card | 3 | 全部引用 |
openapi_channel_rule | 3 | 全部引用 |
member_relation | 2 | 全部引用 |
card_model_notice | 2 | 全部引用 |
看这里需要注意：48 个接口是
@Route(auth=false) 免鉴权（不校验登录态），改动前确认调用方与签名校验。