总览 / 数据待办清单

数据待办清单

这一页把「文档与代码里确实存在、但需要人来收尾」的问题集中列出，每条都带源码位置；表格可一键复制为 Markdown 贴进工单系统。补完后重跑 tools/build_all.sh，条目自动消失。

340缺接口摘要
201摘要口径不一致
45旧版误判在用状态
430免鉴权待复核
4幽灵接口
3无契约条目
1错误码复用
20必填标注存疑

1. 缺接口摘要（340）

源码没有 javadoc，文档只能显示「摘要待补」。建议文案是按方法名与子域机械拼出来的，只作为填写起点，需业务确认后再写进源码注释。

接口业务域源码位置建议文案（需确认）
/promotion/coupon/couponPage营销与触达PromotionCouponController.java:216分页查询「优惠券」
/promotion/coupon/getCoupon营销与触达PromotionCouponController.java:229查询「优惠券」
/promotion/coupon/getUnusedCouponCount营销与触达PromotionCouponController.java:242查询「优惠券」
/promotion/coupon/getCouponByGoodsId营销与触达PromotionCouponController.java:253查询「优惠券」
/profitAccounting/cardModel统计与报表CardModelProfitAccountingController.java:66操作「卡种利润核算」
/statistics/statCardArea统计与报表HomeStatisticsController.java:200统计「首页统计」
/statistics/statHomeTest统计与报表HomeStatisticsController.java:279统计「首页统计」
/statistics/statCardStat统计与报表CardStatisticsController.java:70统计「卡统计」
/tickets/getMemberTourist门票与景区TicketsMemberTouristController.java:158查询「会员·游客」
/tickets/order/exportTicketsOrderPage门票与景区TicketsOrderController.java:262导出「订单」
/tickets/order/getTicketsOrderDetail门票与景区TicketsOrderController.java:571查询「订单」
/tickets/order/getTicketsOrderTouristList门票与景区TicketsOrderController.java:607查询「订单」
/tickets/order/prepay门票与景区TicketsOrderController.java:619操作「订单」
/tickets/order/prepayXgh门票与景区TicketsOrderController.java:671操作「订单」
/tickets/order/payNotify门票与景区TicketsOrderController.java:877第三方回调「订单」
/tickets/order/refundTicketsOrderXgh门票与景区TicketsOrderController.java:956操作「订单」
/tickets/order/refundTicketsOrder门票与景区TicketsOrderController.java:963操作「订单」
/tickets/order/refundNotify门票与景区TicketsOrderController.java:1138第三方回调「订单」
/tickets/exportTicketsCheckPage门票与景区TicketsCheckController.java:119导出「核销」
/tickets/queryTicketsShopList门票与景区TicketsCheckController.java:165查询「核销」
/tickets/queryTicketsCheck门票与景区TicketsCheckController.java:351查询「核销」
/tickets/countTicketsCheckToday门票与景区TicketsCheckController.java:373统计「核销」
/tickets/queryTicketsPageBack门票与景区TicketsController.java:145查询「门票（主表）」
/tickets/getTicketsTypes门票与景区TicketsController.java:288查询「门票（主表）」
/tickets/getTicketsCities门票与景区TicketsController.java:295查询「门票（主表）」
/tickets/getTicketsDetail门票与景区TicketsController.java:307查询「门票（主表）」
/tickets/getSkuDetail门票与景区TicketsSkuController.java:209查询「Sku」
/cardAppointment/exportCardAppointment旅游卡CardAppointmentController.java:182导出「预约」
/cardAppointment/showCardAppointment旅游卡CardAppointmentController.java:300操作「预约」
/cardModel/getCardModelByCardNo旅游卡CardModelController.java:245查询「卡种」
/cardAssignment/resignCardAssignment旅游卡CardAssignmentController.java:234操作「分配」
/card/updateCardActivedZeng旅游卡CardController.java:801修改「卡（主表）」
/card/queryCardChannelActiveList旅游卡CardController.java:897查询「卡（主表）」
/card/exportCardChannelActive旅游卡CardController.java:903导出「卡（主表）」
/card/getOpenapiChannelInfoList旅游卡CardController.java:938查询「卡（主表）」
/cardStock/countCardStockRemain旅游卡CardStockController.java:318统计「库存」
/hotelApi/queryHotelInfoPage酒店HotelApiController.java:113查询「对外酒店接口」
/hotelApi/getHotelInfo酒店HotelApiController.java:141查询「对外酒店接口」
/hotel/getHotelsList酒店HotelInfoController.java:247查询「酒店·信息」
/system/area/tree商户·店铺·基础数据AreaController.java:26查询「区域」
/system/area/get-by-ip商户·店铺·基础数据AreaController.java:34查询「区域」
/sms/smsNotifyAli营销与触达SmsCardLogController.java:152第三方回调「卡·日志」
/checker/queryCheckerConsumeRecord核销CheckerConsumeRecordController.java:77查询「消费记录」
/checker/getCheckerListByResourceId核销CheckerController.java:168查询「核销（主表）」
/checker/version核销CheckerController.java:362操作「核销（主表）」
/checker/hhQrDecode核销CheckerController.java:404操作「核销（主表）」
/consumeEnd/getCardModelList核销ConsumeEndController.java:101查询「消费端」
/consumeEnd/queryCardCheck核销ConsumeEndController.java:111查询「消费端」
/consumeEnd/countCardCheckByChecker核销ConsumeEndController.java:144统计「消费端」
/consumeEnd/queryCardAppointment核销ConsumeEndController.java:176查询「消费端」
/consumeEnd/getTicketsList核销ConsumeEndController.java:209查询「消费端」
/consumeEnd/queryTicketsCheck核销ConsumeEndController.java:218查询「消费端」
/consumeEnd/statCardCheck核销ConsumeEndController.java:237统计「消费端」
/consumeEnd/statCardAppointment核销ConsumeEndController.java:262统计「消费端」
/consumeEnd/statTicketsCheck核销ConsumeEndController.java:285统计「消费端」
/shop/getMapAddrSuggestions商户·店铺·基础数据ShopController.java:516查询「店铺」
/aliyun/face/initFaceVerify开放与对接AliyunRealFaceVerifyController.java:25操作「aliyun（代号待业务确认）」
/aliyun/face/describeFaceVerify开放与对接AliyunRealFaceVerifyController.java:31操作「aliyun（代号待业务确认）」
/ssk/user/token开放与对接SSKUserController.java:35取令牌「对接方 SSK（代号待业务确认）」
/ssk/user/logon开放与对接SSKUserController.java:42操作「对接方 SSK（代号待业务确认）」
/ssk/user/addChecker开放与对接SSKUserController.java:49新增「对接方 SSK（代号待业务确认）」
/ssk/user/queryChecker开放与对接SSKUserController.java:56查询「对接方 SSK（代号待业务确认）」
/ssk/user/queryCardBag开放与对接SSKUserController.java:63查询「对接方 SSK（代号待业务确认）」
/cardService/queryCard开放与对接OpenapiChannelApiController.java:80查询「卡服务（通用开放）」
/cardService/bind开放与对接OpenapiChannelApiController.java:87操作「卡服务（通用开放）」
/cardService/activeAndBind开放与对接OpenapiChannelApiController.java:94操作「卡服务（通用开放）」
/cardService/cardResource开放与对接OpenapiChannelApiController.java:101操作「卡服务（通用开放）」
/cardService/resourceDetail开放与对接OpenapiChannelApiController.java:108查详情「卡服务（通用开放）」
/cardService/appoint开放与对接OpenapiChannelApiController.java:115操作「卡服务（通用开放）」
/cardService/cancelAppoint开放与对接OpenapiChannelApiController.java:122取消「卡服务（通用开放）」
/cardService/appointList开放与对接OpenapiChannelApiController.java:129查询「卡服务（通用开放）」
/cardService/appointDetail开放与对接OpenapiChannelApiController.java:136查详情「卡服务（通用开放）」
/cardService/faceFlag开放与对接OpenapiChannelApiController.java:144操作「卡服务（通用开放）」
/ybx/orderAndPay开放与对接YouBaoXingController.java:31操作「易保行 YBX（待确认）」
/ybx/queryOrder开放与对接YouBaoXingController.java:38查询「易保行 YBX（待确认）」
/ybx/notify开放与对接YouBaoXingController.java:45第三方回调「易保行 YBX（待确认）」
/ybx/refund开放与对接YouBaoXingController.java:57操作「易保行 YBX（待确认）」
/ybx/queryAccount开放与对接YouBaoXingController.java:64查询「易保行 YBX（待确认）」
/ybx/getQrByApi开放与对接YouBaoXingController.java:71查询「易保行 YBX（待确认）」
/icbc/transDirect开放与对接IcbcController.java:171操作「工商银行 ICBC」
/icbc/transDirectNotify开放与对接IcbcController.java:198操作「工商银行 ICBC」
/icbc/openAcctNotify开放与对接IcbcController.java:210操作「工商银行 ICBC」
/pingXiang/sendLoginVerifyCode开放与对接PingXiangController.java:165核销/校验「爱上萍乡」
/pingXiang/login开放与对接PingXiangController.java:213登录「爱上萍乡」
/pingXiang/createOrder开放与对接PingXiangController.java:256新增「爱上萍乡」
/pingXiang/prepay开放与对接PingXiangController.java:284操作「爱上萍乡」
/pingXiang/cancelOrder开放与对接PingXiangController.java:335取消「爱上萍乡」
/pingXiang/wePay/payNotify开放与对接PingXiangController.java:474第三方回调「爱上萍乡」
/pingXiang/refund开放与对接PingXiangController.java:550操作「爱上萍乡」
/pingXiang/wePay/refundNotify开放与对接PingXiangController.java:618第三方回调「爱上萍乡」
/zhyIcbc/createOrder开放与对接ZhyIcbcController.java:28操作「质惠游」
/zhyIcbc/payNotify开放与对接ZhyIcbcController.java:35第三方回调「质惠游」
/zhyIcbc/refund开放与对接ZhyIcbcController.java:42操作「质惠游」
/zhyIcbc/refundNotify开放与对接ZhyIcbcController.java:49第三方回调「质惠游」
/openapi/ticketCodePool/template开放与对接OpenapiTicketCodePoolController.java:58下载「开放平台通用」
/openapi/ticketCodePool/import开放与对接OpenapiTicketCodePoolController.java:81导入「开放平台通用」
/openapi/ticketCodePool/page开放与对接OpenapiTicketCodePoolController.java:171查询「开放平台通用」
/openapi/ticketCodePool/stats开放与对接OpenapiTicketCodePoolController.java:209操作「开放平台通用」
/ssk/card/queryCardModel开放与对接SSKCardController.java:34查询「对接方 SSK（代号待业务确认）」
/ssk/card/queryCardModelDetail开放与对接SSKCardController.java:41查询「对接方 SSK（代号待业务确认）」
/ssk/card/send开放与对接SSKCardController.java:48操作「对接方 SSK（代号待业务确认）」
/ssk/card/bind开放与对接SSKCardController.java:55操作「对接方 SSK（代号待业务确认）」
/ssk/card/queryByNumber开放与对接SSKCardController.java:62查询「对接方 SSK（代号待业务确认）」
/ssk/card/queryByActiveCode开放与对接SSKCardController.java:69查询「对接方 SSK（代号待业务确认）」
/beiJing/getSign开放与对接BeiJingApiController.java:40查询「北京（景区/政务）」
/beiJing/token开放与对接BeiJingApiController.java:49取令牌「北京（景区/政务）」
/beiJing/saleAndPay开放与对接BeiJingApiController.java:58操作「北京（景区/政务）」
/beiJing/queryOrder开放与对接BeiJingApiController.java:66查询「北京（景区/政务）」
/beiJing/bind开放与对接BeiJingApiController.java:74操作「北京（景区/政务）」
/beiJing/queryCardByMobile开放与对接BeiJingApiController.java:82查询「北京（景区/政务）」
/beiJing/cardRecord开放与对接BeiJingApiController.java:90操作「北京（景区/政务）」
/beiJing/cardRecordNew开放与对接BeiJingApiController.java:98操作「北京（景区/政务）」
/beiJing/appoint开放与对接BeiJingApiController.java:106操作「北京（景区/政务）」
/beiJing/appointRecord开放与对接BeiJingApiController.java:114操作「北京（景区/政务）」
/beiJing/queryCardByIcid开放与对接BeiJingApiController.java:122查询「北京（景区/政务）」
/beiJing/consume开放与对接BeiJingApiController.java:130操作「北京（景区/政务）」
/beiJing/appointInfo开放与对接BeiJingApiController.java:138操作「北京（景区/政务）」
/beiJing/operatorConsume开放与对接BeiJingApiController.java:146操作「北京（景区/政务）」
/beiJing/queryCardByMobileTest开放与对接BeiJingApiController.java:153查询「北京（景区/政务）」
/ccb/login开放与对接CcbController.java:40登录「建设银行 CCB」
/ccb/listProduct开放与对接CcbController.java:46查询「建设银行 CCB」
/ccb/cardModelDetail开放与对接CcbController.java:52操作「建设银行 CCB」
/ccb/createOrder开放与对接CcbController.java:58新增「建设银行 CCB」
/ccb/createPay开放与对接CcbController.java:66新增「建设银行 CCB」
/ccb/getOrder开放与对接CcbController.java:139查询「建设银行 CCB」
/ccb/cancelOrder开放与对接CcbController.java:145取消「建设银行 CCB」
/ccb/applyRefund开放与对接CcbController.java:151操作「建设银行 CCB」
/ccb/confirmRefund开放与对接CcbController.java:157确认「建设银行 CCB」
/zfb/auth开放与对接ZfbCardController.java:74操作「支付宝」
/zfb/getPhone开放与对接ZfbCardController.java:80查询「支付宝」
/zfb/listProduct开放与对接ZfbCardController.java:87查询「支付宝」
/zfb/recommendProduct开放与对接ZfbCardController.java:93操作「支付宝」
/zfb/cardModelDetail开放与对接ZfbCardController.java:108操作「支付宝」
/zfb/cardModelDetails开放与对接ZfbCardController.java:114操作「支付宝」
/zfb/createOrder开放与对接ZfbCardController.java:124新增「支付宝」
/zfb/prepay开放与对接ZfbCardController.java:135操作「支付宝」
/zfb/cancelOrder开放与对接ZfbCardController.java:141取消「支付宝」
/zfb/listOrder开放与对接ZfbCardController.java:147查询「支付宝」
/zfb/getOrder开放与对接ZfbCardController.java:153查询「支付宝」
/zfb/queryOrder开放与对接ZfbCardController.java:159查询「支付宝」
/zfb/getQrCode开放与对接ZfbCardController.java:189查询「支付宝」
/zfb/voucherRefundManual开放与对接ZfbCardController.java:307操作「支付宝」
/szh/card/createOrder开放与对接SzhCardController.java:50新增「对接方 SZH（代号待业务确认）」
/szh/card/queryOrder开放与对接SzhCardController.java:77查询「对接方 SZH（代号待业务确认）」
/szh/card/sendBindSmsCode开放与对接SzhCardController.java:83操作「对接方 SZH（代号待业务确认）」
/szh/card/bind开放与对接SzhCardController.java:89操作「对接方 SZH（代号待业务确认）」
/szh/card/appoint开放与对接SzhCardController.java:107操作「对接方 SZH（代号待业务确认）」
/szh/card/cancelAppoint开放与对接SzhCardController.java:113取消「对接方 SZH（代号待业务确认）」
/szh/card/getAppointDetail开放与对接SzhCardController.java:119查询「对接方 SZH（代号待业务确认）」
/szh/card/queryAppointment开放与对接SzhCardController.java:125查询「对接方 SZH（代号待业务确认）」

2. 摘要口径不一致（201）

源码 javadoc 与旧文档摘要不同，v2 以源码为准；但旧摘要可能来自操作日志注解或人工补充，值得确认哪个才是业务真实含义（例如 setStatus 的 javadoc 写成「删除」）。

接口当前（源码 javadoc）旧站摘要（供参考）源码位置
/promotion/couponTemplate/setPromotionCouponTemplateStatus设置优惠券模板状态设置优惠券模板状态PromotionCouponTemplateController.java:146
/promotion/coupon/couponPage（缺摘要）（无摘要）PromotionCouponController.java:216
/promotion/coupon/getCoupon（缺摘要）（无摘要）PromotionCouponController.java:229
/promotion/coupon/getCouponByGoodsId（缺摘要）（无摘要）PromotionCouponController.java:253
/profitAccounting/cardModel（缺摘要）（无摘要）CardModelProfitAccountingController.java:66
/statistics/statCardArea（缺摘要）（无摘要）HomeStatisticsController.java:200
/statistics/statHomeTest（缺摘要）（无摘要）HomeStatisticsController.java:279
/statistics/statCardStat（缺摘要）（无摘要）CardStatisticsController.java:70
/tickets/setDefault设置默认游客设置默认游客TicketsMemberTouristController.java:145
/tickets/getMemberTourist（缺摘要）（无摘要）TicketsMemberTouristController.java:158
/tickets/order/queryTicketsOrderPageAdmin门票订单-管理端分页查询门票订单-管理端分页查询TicketsOrderController.java:234
/tickets/order/exportTicketsOrderPage（缺摘要）（无摘要）TicketsOrderController.java:262
/tickets/order/getTicketsOrderDetail（缺摘要）（无摘要）TicketsOrderController.java:571
/tickets/order/cancelTicketsOrder取消门票订单取消门票订单TicketsOrderController.java:601
/tickets/order/prepayXgh（缺摘要）（无摘要）TicketsOrderController.java:671
/tickets/order/refundTicketsOrderXgh（缺摘要）（无摘要）TicketsOrderController.java:956
/tickets/order/refundTicketsOrder（缺摘要）（无摘要）TicketsOrderController.java:963
/tickets/exportTicketsCheckPage（缺摘要）（无摘要）TicketsCheckController.java:119
/tickets/queryTicketsShopList（缺摘要）（无摘要）TicketsCheckController.java:165
/tickets/queryTicketsCheck（缺摘要）（无摘要）TicketsCheckController.java:351
/tickets/countTicketsCheckToday（缺摘要）（无摘要）TicketsCheckController.java:373
/tickets/queryTicketsPageBack（缺摘要）（无摘要）TicketsController.java:145
/tickets/getTicketsTypes（缺摘要）（无摘要）TicketsController.java:288
/tickets/getTicketsCities（缺摘要）（无摘要）TicketsController.java:295
/tickets/getTicketsDetail（缺摘要）（无摘要）TicketsController.java:307
/tickets/getSkuDetail（缺摘要）（无摘要）TicketsSkuController.java:209
/cardAppointment/exportCardAppointment（缺摘要）（无摘要）CardAppointmentController.java:182
/cardAppointment/showCardAppointment（缺摘要）（无摘要）CardAppointmentController.java:300
/cardModel/getCardModelByCardNo（缺摘要）（无摘要）CardModelController.java:245
/cardCheck/singleRecordCardCheckSzh单记录核销(深圳)单记录核销(深圳)CardCheckController.java:466
/cardBind/resetCardFace卡绑定-重置人脸卡绑定-重置人脸CardBindController.java:156
/cardAssignment/resignCardAssignment（缺摘要）（无摘要）CardAssignmentController.java:234
/card/updateCardActivedZeng（缺摘要）（无摘要）CardController.java:801
/card/queryCardChannelActiveList（缺摘要）（无摘要）CardController.java:897
/card/exportCardChannelActive（缺摘要）（无摘要）CardController.java:903
/card/getOpenapiChannelInfoList（缺摘要）（无摘要）CardController.java:938
/card/queryCardOrderChannelListxuchao: 订单列表-销售渠道下拉数据源 平台账号（merchantId/shopId 为空）返回全部渠道；发卡商/商铺账号只返回其可见订单出现的渠道，与列表数据范围保持一致订单列表-销售渠道下拉数据源CardController.java:962
/cardStock/countCardStockRemain（缺摘要）（无摘要）CardStockController.java:318
/hotelApi/queryHotelInfoPage（缺摘要）（无摘要）HotelApiController.java:113
/hotelApi/getHotelInfo（缺摘要）（无摘要）HotelApiController.java:141
/hotelApi/getRoomTypeData获取房型信息 */获取房型信息HotelApiController.java:420
/hotelApi/hotelBook酒店预订 */酒店预订HotelApiController.java:534
/hotelApi/hotelBookDetail酒店预订 */酒店预订HotelApiController.java:541
/hotelApi/hotelPrePay酒店预支付 */酒店预支付HotelApiController.java:548
/hotelApi/hotelPrePayXgh酒店预支付 - 湘工惠 */酒店预支付 - 湘工惠HotelApiController.java:555
/hotelApi/hotelPayCallback酒店支付回调 */酒店支付回调HotelApiController.java:641
/hotelApi/hotelCancelOrder酒店取消订单 */酒店取消订单HotelApiController.java:650
/hotelApi/hotelRefundCallback酒店退款回调 */酒店退款回调HotelApiController.java:657
/hotelApi/hotelMemberList获取联系人列表 */获取联系人列表HotelApiController.java:666
/hotelApi/hotelAddMember添加联系人 */添加联系人HotelApiController.java:688
/hotelApi/hotelUpdateMember修改联系人 */修改联系人HotelApiController.java:704
/hotelApi/hotelDeleteMember删除联系人 */删除联系人HotelApiController.java:716
/hotelApi/getHotelOrder查询订单 */查询订单HotelApiController.java:725
/hotelApi/getHotelOrderDetail获取订单详情 */获取订单详情HotelApiController.java:732
/hotelApi/getHotelOrderLog获取订单详情 */获取订单详情HotelApiController.java:739
/hotel/getHotelsList（缺摘要）（无摘要）HotelInfoController.java:247
/system/area/tree（缺摘要）（无摘要）AreaController.java:26
/system/area/get-by-ip（缺摘要）（无摘要）AreaController.java:34
/xuchao/batchAdd批量新增分销商用户批量新增分销商用户XuchaoDisUserController.java:137
/auth/checkerLogout核销员登出核销员登出AuthController.java:478
/auth/oauth2MeiKe认证-美科H5网页授权（code 换 openId）认证-美科H5网页授权（code 换 openId）AuthController.java:603
/admissionWarning/cardTypes卡种列表 */卡种列表AdmissionWarningController.java:88
/admissionWarning/page分页查询 */分页查询AdmissionWarningController.java:97
/admissionWarning/export导出 CSV */导出 CSVAdmissionWarningController.java:118
/checker/queryCheckerConsumeRecord（缺摘要）（无摘要）CheckerConsumeRecordController.java:77
/checker/getCheckerListByResourceId（缺摘要）（无摘要）CheckerController.java:168
/checker/updateCheckerPwd更新核销人员密码更新核销人员密码CheckerController.java:217
/checker/faceConsumeXym人脸核销(湘约码)人脸核销(湘约码)CheckerController.java:313
/checker/faceStepTwo人脸核销第二步人脸核销第二步CheckerController.java:356
/checker/version（缺摘要）（无摘要）CheckerController.java:362
/checker/sskConsume随手扣核销随手扣核销CheckerController.java:382
/checker/cardUseNotify核销-用卡信息通知（App端）核销-用卡信息通知（App端）CheckerController.java:410
/consumeEnd/resetCheckerPwd重置核销员密码重置核销员密码ConsumeEndController.java:95
/consumeEnd/getCardModelList（缺摘要）（无摘要）ConsumeEndController.java:101
/consumeEnd/queryCardCheck（缺摘要）（无摘要）ConsumeEndController.java:111
/consumeEnd/countCardCheckByChecker（缺摘要）（无摘要）ConsumeEndController.java:144
/consumeEnd/queryCardAppointment（缺摘要）（无摘要）ConsumeEndController.java:176
/consumeEnd/getTicketsList（缺摘要）（无摘要）ConsumeEndController.java:209
/consumeEnd/queryTicketsCheck（缺摘要）（无摘要）ConsumeEndController.java:218
/consumeEnd/statCardCheck（缺摘要）（无摘要）ConsumeEndController.java:237
/consumeEnd/statCardAppointment（缺摘要）（无摘要）ConsumeEndController.java:262
/consumeEnd/statTicketsCheck（缺摘要）（无摘要）ConsumeEndController.java:285
/activityHotspotTaskManage/queryPage活动热区配置-分页查询活动热区配置-分页查询ActivityHotspotTaskManageController.java:29
/activityHotspotTaskManage/add活动热区配置-新增活动热区配置-新增ActivityHotspotTaskManageController.java:36
/activityHotspotTaskManage/update活动热区配置-更新活动热区配置-更新ActivityHotspotTaskManageController.java:43
/activityHotspotTaskManage/delete活动热区配置-删除活动热区配置-删除ActivityHotspotTaskManageController.java:50
/activityHotspotTaskManage/get活动热区配置-详情活动热区配置-详情ActivityHotspotTaskManageController.java:56
/activityHotspotTask/get活动热区配置-C端查询（按id，免登录）活动热区配置-C端查询（按id，免登录）ActivityHotspotTaskController.java:26
/shop/importShopxuchao: Shop-批量导入（仅超级管理员；逐行部分成功，返回行错误报告）Shop-批量导入（仅超级管理员；逐行部分成功，返回行错误报告）ShopController.java:283
/shop/getMapAddrSuggestions（缺摘要）（无摘要）ShopController.java:516
/jhpay/svc_occOrderStatusNoticesynchronizedsynchronizedCcbNotifyController.java:29
/ybx/getQrByApi（缺摘要）（无摘要）YouBaoXingController.java:71
/pingXiang/sendLoginVerifyCode（缺摘要）（无摘要）PingXiangController.java:165
/pingXiang/login（缺摘要）（无摘要）PingXiangController.java:213
/pingXiang/wePay/appointmentNotify平祥-微信支付回调（预约支付结果）平祥-微信支付回调（预约支付结果）PingXiangController.java:350
/pingXiang/wePay/appointmentRefundNotify平祥-微信支付回调（预约退款结果）平祥-微信支付回调（预约退款结果）PingXiangController.java:425
/pingXiang/refund（缺摘要）（无摘要）PingXiangController.java:550
/openapi/ticketCodePool/template（缺摘要）（无摘要）OpenapiTicketCodePoolController.java:58
/openapi/ticketCodePool/import（缺摘要）（无摘要）OpenapiTicketCodePoolController.java:81
/openapi/ticketCodePool/page（缺摘要）（无摘要）OpenapiTicketCodePoolController.java:171
/openapi/ticketCodePool/stats（缺摘要）（无摘要）OpenapiTicketCodePoolController.java:209
/zfb/auth（缺摘要）（无摘要）ZfbCardController.java:74
/zfb/getPhone（缺摘要）（无摘要）ZfbCardController.java:80
/zfb/cardModelDetails（缺摘要）（无摘要）ZfbCardController.java:114
/zfb/getQrCode（缺摘要）（无摘要）ZfbCardController.java:189
/meike/getUserInfo美科-订单解码获取用户信息美科-订单解码获取用户信息MeiKeController.java:30
/cqy/syncCqyRecord（缺摘要）（无摘要）OpenapiCqyRecordController.java:193
/cqy/bindGoods（缺摘要）（无摘要）OpenapiCqyRecordController.java:200
/cqy/goodsList（缺摘要）（无摘要）OpenapiCqyRecordController.java:266
/cqy/goodsDetail（缺摘要）（无摘要）OpenapiCqyRecordController.java:294
/cqy/createOrder（缺摘要）（无摘要）OpenapiCqyRecordController.java:317
/cqy/prepay（缺摘要）（无摘要）OpenapiCqyRecordController.java:444
/cqy/refund（缺摘要）（无摘要）OpenapiCqyRecordController.java:477
/cqy/refundWx（缺摘要）（无摘要）OpenapiCqyRecordController.java:484
/cqy/listOrder（缺摘要）（无摘要）OpenapiCqyRecordController.java:510
/cqy/getOrder（缺摘要）（无摘要）OpenapiCqyRecordController.java:531
/cqy/cqyCheckerGoods（缺摘要）（无摘要）OpenapiCqyRecordController.java:556
/cqy/cqyCheck（缺摘要）（无摘要）OpenapiCqyRecordController.java:570
/cqy/queryCqyCheck（缺摘要）（无摘要）OpenapiCqyRecordController.java:599
/cqy/statCqyCheck（缺摘要）（无摘要）OpenapiCqyRecordController.java:624
/xgh/getUserInfo（缺摘要）（无摘要）XghController.java:85
/xgh/listProduct（缺摘要）（无摘要）XghController.java:106
/xgh/recommendProduct（缺摘要）（无摘要）XghController.java:112
/xgh/cardModelDetail（缺摘要）（无摘要）XghController.java:127
/xgh/createOrder（缺摘要）（无摘要）XghController.java:143
/xgh/prepay（缺摘要）（无摘要）XghController.java:177
/xgh/refund（缺摘要）（无摘要）XghController.java:270
/xgh/listOrder（缺摘要）（无摘要）XghController.java:368
/xgh/getOrder（缺摘要）（无摘要）XghController.java:374
/xgh/addPurchase（缺摘要）（无摘要）XghController.java:386
/xgh/isXghMember（缺摘要）（无摘要）XghController.java:392
/xgh/isXghCouponMember（缺摘要）（无摘要）XghController.java:416
/cib/cibStat（缺摘要）（无摘要）CibController.java:534
/cib/cibOperatorList（缺摘要）（无摘要）CibController.java:552
/cib/exportCibStatDetail（缺摘要）（无摘要）CibController.java:560
/cib/getCibStatDetail（缺摘要）（无摘要）CibController.java:599
/tstc/refund（缺摘要）（无摘要）TstcController.java:307
/hhService/thirdNotify怀化人社-第三方通知回调（上报）怀化人社-第三方通知回调（上报）HuaiHuaController.java:57
/card/queryCardModelList开放-卡种列表查询开放-卡种列表查询OpenApiCardController.java:73
/card/cardModelDetail开放-卡种详情查询开放-卡种详情查询OpenApiCardController.java:79
/card/sendWithNo开放-发卡（sendWithNo，返回发卡回执）开放-发卡（sendWithNo，返回发卡回执）OpenApiCardController.java:97
/card/sendAndBind发卡且自动绑定返回卡号等信息发卡且自动绑定返回卡号等信息OpenApiCardController.java:110
/zhy/auth/login（缺摘要）（无摘要）AuthController.java:42
/cardBag/bind（缺摘要）（无摘要）CardBagController.java:221
/cardBag/bindForAddFaceImg（缺摘要）（无摘要）CardBagController.java:227
/cardBag/faceFlag（缺摘要）（无摘要）CardBagController.java:236
/cardBag/bindRecord（缺摘要）（无摘要）CardBagController.java:243
/cardBag/manageAppoint（缺摘要）（无摘要）CardBagController.java:260
/cardBag/appoint（缺摘要）（无摘要）CardBagController.java:267
/cardBag/appointRecord（缺摘要）（无摘要）CardBagController.java:273

3. 旧版标「未使用」但实际有调用（45）

这些接口曾被旧文档判为可以忽略，重扫前端源码后确认在用 —— 按旧文档下线会出事故。

接口调用端源码位置
/statistics/exportStatCardIssue管理后台CardStatisticsController.java:88
/order/exportOrderList管理后台OrderController.java:154
/order/exportOrderTradeList管理后台OrderController.java:212
/order/exportCardOrderPage管理后台OrderController.java:371
/orderPayment/exportOrderPaymentList管理后台OrderPaymentController.java:76
/tickets/order/exportTicketsOrderPage管理后台TicketsOrderController.java:262
/tickets/exportTicketsCheckPage管理后台TicketsCheckController.java:119
/cardAppointment/exportCardAppointment管理后台CardAppointmentController.java:182
/cardResourceRule/exportCardResourceRule管理后台CardResourceRuleController.java:193
/cardBatch/downloadCardBatch管理后台CardBatchController.java:233
/cardBatch/downloadCardStockChip管理后台CardBatchController.java:303
/cardCheck/exportCardCheck管理后台CardCheckController.java:615
/cardAssignment/downloadCardAssignment管理后台CardAssignmentController.java:328
/card/exportCardChannelActive管理后台CardController.java:903
/card/exportCardChannelStat管理后台CardController.java:982
/card/exportCard管理后台CardController.java:1293
/card/exportCardPersonalActive管理后台CardController.java:1450
/card/bindBatchPreview管理后台CardController.java:1495
/cardStock/exportCardStock管理后台CardStockController.java:262
/settlement/oldCardModels管理后台SettlementOldCardController.java:43
/settlement/queryOldCardSettlement管理后台SettlementOldCardController.java:52
/settlement/exportOldCardSettlement管理后台SettlementOldCardController.java:66
/settlement/exportSettlementCardDetailPaymentPage管理后台SettlementCardDetailPaymentController.java:129
/settlement/exportSettlementCardCheckDetailPage管理后台SettlementCardCheckDetailController.java:83
/settlement/exportSettlementCardDetailSplitPage管理后台SettlementCardDetailController.java:174
/settlement/afreshSettlementCard管理后台SettlementCardController.java:555
/openapi/exportOpenapiXghPurchageList管理后台OpenapiXghPurchageController.java:73
/cib/exportCibStatDetail管理后台CibController.java:560
/hhrsWinnerManage/queryPage管理后台HhrsWinnerManageController.java:41
/hhrsWinnerManage/delete管理后台HhrsWinnerManageController.java:60
/hhrsWinnerManage/import管理后台HhrsWinnerManageController.java:67
/hhrsWinnerManage/downloadTemplate管理后台HhrsWinnerManageController.java:107
/distributeAmount/exportDistributeDetail管理后台DistributeAmountController.java:200
/hhrsRights/eligibility怀化人社 H5HhrsRightsController.java:26
/hhrsRights/list怀化人社 H5HhrsRightsController.java:33
/hhrsRights/detail怀化人社 H5HhrsRightsController.java:40
/hhrsRights/appointment/list怀化人社 H5HhrsRightsController.java:47
/hhrsRights/check/list怀化人社 H5HhrsRightsController.java:54
/mpCard/checkFaceBind爱上萍乡 小程序MpCardController.java:28
/hhrsStore/list怀化人社 H5HhrsStoreController.java:27
/hhrsStore/detail怀化人社 H5HhrsStoreController.java:34
/mpShopNotice/queryShopNoticePage爱上萍乡 小程序MpShopNoticeController.java:29
/hhrsWinner/dates怀化人社 H5HhrsWinnerController.java:27
/hhrsWinner/list怀化人社 H5HhrsWinnerController.java:34
/afterSales/exportAfterSales管理后台AfterSalesController.java:133

4. 免鉴权接口待复核（430）

源码写了 @Route(auth = false)，不校验登录态。开放/回调类是设计如此，但管理后台或小程序渠道上出现免鉴权需要安全确认（是否应有签名校验、是否应改回需登录）。

接口业务域摘要源码位置
/promotion/couponTemplate/getCouponTemplateList营销与触达优惠劵模板列表PromotionCouponTemplateController.java:163
/promotion/couponTemplate/getCouponTemplateListByIds营销与触达优惠劵模板列表（Ids）PromotionCouponTemplateController.java:191
/promotion/couponTemplate/getCouponTemplateByPage营销与触达优惠劵模板-分页查询PromotionCouponTemplateController.java:214
/promotion/couponTemplate/getCouponTemplate营销与触达优惠劵模板详情PromotionCouponTemplateController.java:241
/promotion/queryPromotionActivityShopPage营销与触达活动商铺表-分页查询PromotionActivityShopController.java:63
/promotion/coupon/take营销与触达优惠劵-领取PromotionCouponController.java:195
/promotion/coupon/couponPage营销与触达（缺摘要）PromotionCouponController.java:216
/promotion/coupon/getCoupon营销与触达（缺摘要）PromotionCouponController.java:229
/promotion/coupon/getUnusedCouponCount营销与触达（缺摘要）PromotionCouponController.java:242
/promotion/coupon/getCouponByGoodsId营销与触达（缺摘要）PromotionCouponController.java:253
/profitAccounting/cardModel统计与报表（缺摘要）CardModelProfitAccountingController.java:66
/statistics/statHomeSalesAmount统计与报表首页-总销售额统计HomeStatisticsController.java:93
/statistics/statHomeTest统计与报表（缺摘要）HomeStatisticsController.java:279
/statistics/statCardModel统计与报表卡种情况统计CardStatisticsController.java:110
/tickets/addTicketsMemberTourist门票与景区单票会员游客表-新增TicketsMemberTouristController.java:89
/tickets/updateTicketsMemberTourist门票与景区单票会员游客表-更新TicketsMemberTouristController.java:111
/tickets/deleteTicketsMemberTourist门票与景区单票会员游客表-删除TicketsMemberTouristController.java:136
/tickets/setDefault门票与景区设置默认游客TicketsMemberTouristController.java:145
/tickets/getMemberTourist门票与景区（缺摘要）TicketsMemberTouristController.java:158
/tickets/order/queryTicketsOrderPage门票与景区单票订单-分页查询TicketsOrderController.java:202
/tickets/order/createTicketsOrder门票与景区单票订单-新增TicketsOrderController.java:336
/tickets/order/getTicketsOrderDetail门票与景区（缺摘要）TicketsOrderController.java:571
/tickets/order/cancelTicketsOrder门票与景区取消门票订单TicketsOrderController.java:601
/tickets/order/getTicketsOrderTouristList门票与景区（缺摘要）TicketsOrderController.java:607
/tickets/order/prepay门票与景区（缺摘要）TicketsOrderController.java:619
/tickets/order/prepayXgh门票与景区（缺摘要）TicketsOrderController.java:671
/tickets/order/reapalPayNotify门票与景区融宝支付回调TicketsOrderController.java:800
/tickets/order/cqyWxPayNotify门票与景区线路微信支付回调TicketsOrderController.java:827
/tickets/order/payNotify门票与景区（缺摘要）TicketsOrderController.java:877
/tickets/order/refundTicketsOrderXgh门票与景区（缺摘要）TicketsOrderController.java:956
/tickets/order/refundTicketsOrder门票与景区（缺摘要）TicketsOrderController.java:963
/tickets/order/cqyWxRefundNotify门票与景区线路微信退款回调TicketsOrderController.java:1061
/tickets/order/refundNotify门票与景区（缺摘要）TicketsOrderController.java:1138
/tickets/queryTicketsCheckPage门票与景区单票核销表-分页查询TicketsCheckController.java:107
/tickets/addTicketsCheck门票与景区核销员核销接口 单票核销表-新增TicketsCheckController.java:190
/tickets/queryTicketsCheck门票与景区（缺摘要）TicketsCheckController.java:351
/tickets/countTicketsCheckToday门票与景区（缺摘要）TicketsCheckController.java:373
/tickets/queryTicketsPage门票与景区单票-分页查询TicketsController.java:96
/tickets/queryTicketsPageBack门票与景区（缺摘要）TicketsController.java:145
/tickets/getTicketsTypes门票与景区（缺摘要）TicketsController.java:288
/tickets/getTicketsCities门票与景区（缺摘要）TicketsController.java:295
/tickets/getTicketsDetail门票与景区（缺摘要）TicketsController.java:307
/tickets/getSkuDetail门票与景区（缺摘要）TicketsSkuController.java:209
/cardAppointment/test/verifyFace旅游卡人脸核销测试方法CardAppointmentController.java:353
/cardResourceRule/queryCardResourceRuleList旅游卡旅游卡资源-列表查询CardResourceRuleController.java:136
/cardCheck/importCardCheck旅游卡【入园记录】增加补录导入功能CardCheckController.java:380
/cardQRCode/createCardQRCode旅游卡卡入园二维码-创建CardQRCodeController.java:48
/card/test旅游卡购卡订单回调测试方法CardController.java:1143
/settlement/testSettlementCardCalc结算与分配旅游卡结算单-计算测试SettlementCardController.java:639
/settlement/getSettlementCard结算与分配旅游卡结算单-详情SettlementCardController.java:789
/hotel/getHotelRoomPriceCalendar酒店价格日历表-详情HotelRoomPriceCalendarController.java:234
/hotelApi/queryHotelInfoPage酒店（缺摘要）HotelApiController.java:113
/hotelApi/getHotelInfo酒店（缺摘要）HotelApiController.java:141
/hotelApi/queryHotelRoomTypeTreePage酒店房型表-分页查询(树形)HotelApiController.java:256
/hotelApi/getHotelRoomDetail酒店房间plan详情(树形)HotelApiController.java:375
/hotelApi/getRoomTypeData酒店获取房型信息 */HotelApiController.java:420
/hotelApi/getHotelCalendar酒店获取低价日历HotelApiController.java:466
/hotelApi/getHotelRoomInfo酒店获取酒店房型及sku列表信息HotelApiController.java:494
/hotelApi/hotelBook酒店酒店预订 */HotelApiController.java:534
/hotelApi/hotelBookDetail酒店酒店预订 */HotelApiController.java:541
/hotelApi/hotelPrePay酒店酒店预支付 */HotelApiController.java:548
/hotelApi/hotelPrePayXgh酒店酒店预支付 - 湘工惠 */HotelApiController.java:555
/hotelApi/hotelPayCallback酒店酒店支付回调 */HotelApiController.java:641
/hotelApi/hotelCancelOrder酒店酒店取消订单 */HotelApiController.java:650
/hotelApi/hotelRefundCallback酒店酒店退款回调 */HotelApiController.java:657
/hotelApi/hotelMemberList酒店获取联系人列表 */HotelApiController.java:666
/hotelApi/hotelAddMember酒店添加联系人 */HotelApiController.java:688
/hotelApi/hotelUpdateMember酒店修改联系人 */HotelApiController.java:704
/hotelApi/hotelDeleteMember酒店删除联系人 */HotelApiController.java:716
/hotelApi/getHotelOrder酒店查询订单 */HotelApiController.java:725
/hotelApi/getHotelOrderDetail酒店获取订单详情 */HotelApiController.java:732
/hotelApi/getHotelOrderLog酒店获取订单详情 */HotelApiController.java:739
/system/area/tree商户·店铺·基础数据（缺摘要）AreaController.java:26
/system/area/get-by-ip商户·店铺·基础数据（缺摘要）AreaController.java:34
/sms/smsNotifyAli营销与触达（缺摘要）SmsCardLogController.java:152
/sms/sendVerifyCode营销与触达短信-发送验证码SmsController.java:60
/sms/sendCardBindVerifyCode营销与触达卡绑定发送短信SmsController.java:86
/xuchao/batchAdd结算与分配批量新增分销商用户XuchaoDisUserController.java:137
/auth/getRandomCodeImg平台与系统权限-获取图形验证码AuthController.java:243
/auth/login平台与系统权限-登录AuthController.java:268
/auth/checkerLogin平台与系统权限-核销员登录AuthController.java:321
/auth/checkerLogout平台与系统核销员登出AuthController.java:478
/auth/simulateLogin平台与系统权限-登录AuthController.java:492
/auth/oauth2session平台与系统权限-H5网页授权登录AuthController.java:534
/auth/oauth2MeiKe平台与系统认证-美科H5网页授权（code 换 openId）AuthController.java:603
/auth/oauth2平台与系统小程序授权登录AuthController.java:685
/auth/oauth2Login平台与系统c端模拟授权登录AuthController.java:822
/checker/queryCheckerConsumeRecord1核销核销员核销记录表-分页查询CheckerConsumeRecordController.java:68
/checker/queryCheckerConsumeRecord核销（缺摘要）CheckerConsumeRecordController.java:77
/checker/unifiedConsume核销统一核销接口CheckerController.java:238
/checker/faceConsumeCztk核销湘约码卡人脸核销CheckerController.java:306
/checker/faceConsumeXym核销人脸核销(湘约码)CheckerController.java:313
/checker/faceConsume核销人脸核销CheckerController.java:326
/checker/hhFaceConsume核销怀化核销CheckerController.java:349
/checker/faceStepTwo核销人脸核销第二步CheckerController.java:356
/checker/version核销（缺摘要）CheckerController.java:362
/checker/sskConsume核销随手扣核销CheckerController.java:382
/checker/hhQrDecode核销（缺摘要）CheckerController.java:404
/checker/cardUseNotify核销核销-用卡信息通知（App端）CheckerController.java:410
/consumeEnd/resetCheckerPwd核销重置核销员密码ConsumeEndController.java:95
/consumeEnd/getCardModelList核销（缺摘要）ConsumeEndController.java:101
/consumeEnd/queryCardCheck核销（缺摘要）ConsumeEndController.java:111
/consumeEnd/countCardCheckByChecker核销（缺摘要）ConsumeEndController.java:144
/consumeEnd/queryCardAppointment核销（缺摘要）ConsumeEndController.java:176
/consumeEnd/getTicketsList核销（缺摘要）ConsumeEndController.java:209
/consumeEnd/queryTicketsCheck核销（缺摘要）ConsumeEndController.java:218
/consumeEnd/statCardCheck核销（缺摘要）ConsumeEndController.java:237
/consumeEnd/statCardAppointment核销（缺摘要）ConsumeEndController.java:262
/consumeEnd/statTicketsCheck核销（缺摘要）ConsumeEndController.java:285
/activityHotspotTask/get营销与触达活动热区配置-C端查询（按id，免登录）ActivityHotspotTaskController.java:26
/shop/queryShopList商户·店铺·基础数据Shop-列表查询ShopController.java:193
/shop/importShop商户·店铺·基础数据xuchao: Shop-批量导入（仅超级管理员；逐行部分成功，返回行错误报告）ShopController.java:283
/shop/getShop商户·店铺·基础数据Shop-详情ShopController.java:312
/pay/prepay订单·支付·售后支付-预下单PayController.java:115
/pay/cardPayCallback订单·支付·售后支付-购卡支付回调PayController.java:190
/aliyun/face/initFaceVerify开放与对接（缺摘要）AliyunRealFaceVerifyController.java:25
/aliyun/face/describeFaceVerify开放与对接（缺摘要）AliyunRealFaceVerifyController.java:31
/ssk/user/token开放与对接（缺摘要）SSKUserController.java:35
/ssk/user/logon开放与对接（缺摘要）SSKUserController.java:42
/ssk/user/addChecker开放与对接（缺摘要）SSKUserController.java:49
/ssk/user/queryChecker开放与对接（缺摘要）SSKUserController.java:56
/ssk/user/queryCardBag开放与对接（缺摘要）SSKUserController.java:63
/jhpay/svc_occOrderStatusNotice开放与对接synchronizedCcbNotifyController.java:29
/cardService/queryCard开放与对接（缺摘要）OpenapiChannelApiController.java:80
/cardService/bind开放与对接（缺摘要）OpenapiChannelApiController.java:87
/cardService/activeAndBind开放与对接（缺摘要）OpenapiChannelApiController.java:94
/cardService/cardResource开放与对接（缺摘要）OpenapiChannelApiController.java:101
/cardService/resourceDetail开放与对接（缺摘要）OpenapiChannelApiController.java:108
/cardService/appoint开放与对接（缺摘要）OpenapiChannelApiController.java:115
/cardService/cancelAppoint开放与对接（缺摘要）OpenapiChannelApiController.java:122
/cardService/appointList开放与对接（缺摘要）OpenapiChannelApiController.java:129
/cardService/appointDetail开放与对接（缺摘要）OpenapiChannelApiController.java:136
/cardService/faceFlag开放与对接（缺摘要）OpenapiChannelApiController.java:144
/ybx/orderAndPay开放与对接（缺摘要）YouBaoXingController.java:31
/ybx/queryOrder开放与对接（缺摘要）YouBaoXingController.java:38
/ybx/notify开放与对接（缺摘要）YouBaoXingController.java:45
/ybx/refund开放与对接（缺摘要）YouBaoXingController.java:57
/ybx/queryAccount开放与对接（缺摘要）YouBaoXingController.java:64
/ybx/getQrByApi开放与对接（缺摘要）YouBaoXingController.java:71
/icbc/wechatPay开放与对接商户发起微信小程序、微信公众号、支付宝生活号合并支付时，调用该接口生成支付报文。此接口兼容单订单支 付，如果使用 此接口进行单订单支付，请参照下方“4.2 biz_content单订单请求参数说明”。 请求方式：POSTIcbcController.java:42
/icbc/unfreezeAccept开放与对接平台商户发起担保支付后，子商户该笔订单资金属于冻结状态，不可结算。确认收货成功及对应订单清算完成后资 金解冻可结算。请求方式：POSTIcbcController.java:55
/icbc/refundApply开放与对接当订单支付成功后，资金为“冻结中”时，由于用户或者商家的原因需要退款时，合作平台可以通过退款申请受理接 口将支付款退还给用户原支付账号，该接口支持单笔与并笔的T+1日退款； 请求方式：POSTIcbcController.java:69
/icbc/queryRefund开放与对接当退款交易发生之后，平台商户可以通过退款查询接口查询退款单状态。 请求方式：POSTIcbcController.java:81
/icbc/queryOrder开放与对接平台商户通过该接口查询订单状态。 请求方式：POSTIcbcController.java:93
/icbc/queryUnfreeze开放与对接平台商户可以上送发起过确认收货受理的订单，查询该订单的确认收货状态请求方式：POSTIcbcController.java:105
/icbc/queryWithdraw开放与对接平台商户通过该接口查询订单的各个结算状态和结算流水号状态。 请求方式：POSTIcbcController.java:117
/icbc/closeOrder开放与对接平台商户通过该接口对支付中的订单进行主动关单。 请求方式：POSTIcbcController.java:129
/icbc/token开放与对接提供各个对账单获取token、随机数接口。请求方式POSTIcbcController.java:140
/icbc/downloadStatementByOrder开放与对接B2C按订单结算对账单下载接口 acDate 对账日期，格式"yyyy‐MM‐dd" fileType 对账单类型 01：提现对账单 02：超限对账单 不传该字段则默认为01IcbcController.java:153
/icbc/downloadStatement开放与对接B2C对账单下载接口IcbcController.java:164

5. 幽灵接口与无契约条目（4 / 3）

源码里已注释或删除但旧文档仍在写（幽灵）；或两边都拿不到完整契约（无契约条目）。

接口业务域摘要
/tickets/order/refundAppointmentOrder门票与景区（无摘要）
/tickets/order/appointmentPayNotify门票与景区（缺摘要）
/tickets/order/appointmentPrepay门票与景区（缺摘要）
/tickets/order/appointmentRefundNotify门票与景区（缺摘要）
/tickets/order/appointmentPayNotify门票与景区（缺摘要）
/tickets/order/appointmentPrepay门票与景区（缺摘要）
/tickets/order/appointmentRefundNotify门票与景区（缺摘要）
必填标注存疑（20 处）：旧站把源码里被注释掉的 //@NotNull(...) 当成生效校验标了必填，v2 已按源码实际生效标注；若业务上确实应为必填，请在源码里把注释放开。

6. 错误码复用（1 组）

同一码值对应多条业务含义，前端只能靠提示语区分，建议拆分码段。

码值被哪些常量复用
20010CARD_RESOURCE_RULE_COUNT_ERROR、CARD_RESOURCE_RULE_MONTH_COUNT_ERROR、CARD_RESOURCE_RULE_DAY_COUNT_ERROR
由 tools/build.py 从 data/apis.json 生成 · 生成时间 2026-09-12 19:49 · 数据口径见说明 · 本页数字非手写，均来自同一份数据