12301-dscp 接口文档 v2

后端 jxxx-dscp 全部 1664 个 HTTP 接口,按 业务域 → 子域 组织,并与 7 个前端仓库源码的调用点交叉验证。 所有数字由 tools/build.py 从同一份 data/apis.json 算出。

1664接口总数
679已确认在用
0仅末段匹配
985本次扫描未发现调用
14业务域
45旧版误判为未使用
340源码无注释(名称为推断)
3旧站无详情卡片
238源码补全的精简条目
18旧站漏记的接口
4旧站幽灵接口
430@Route auth=false
请先读《口径修正说明》。 旧版把 45 个接口标为「未使用」,但重扫前端源码后能找到真实调用点(多为导出/下载类接口)。 不要依据旧版「未使用」标签下线任何接口。

我的常用

★ 我的收藏(空)
🕘 最近查看(空)
由浏览器本机存储(localStorage),不上传、不共享;在任意接口卡片点「☆ 收藏」即可加入。

业务域

怎么用:点卡片任意位置=该域的接口清单(按子域分组,点接口名进详情);右下角按钮=该域的业务总览(业务对象、状态含义、读写数据表、风险)。
旅游卡183 接口 · 101 在用 · 19 个子域 · 5 个免鉴权

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

门票与景区104 接口 · 51 在用 · 13 个子域 · 29 个免鉴权

景区门票·场次库存·入园与预警·门票核销单

酒店178 接口 · 68 在用 · 23 个子域 · 22 个免鉴权

酒店与房型、价格日历、订单、点评

订单·支付·售后135 接口 · 41 在用 · 20 个子域 · 3 个免鉴权

通用订单、支付、发货、退款、售后

商品与履约71 接口 · 53 在用 · 10 个子域

商品/SPU/SKU、渠道商品、物流运费

商户·店铺·基础数据60 接口 · 44 在用 · 9 个子域 · 8 个免鉴权

商户与合同财务、店铺、行业/地区/销售等主数据

核销67 接口 · 24 在用 · 9 个子域 · 22 个免鉴权

核销员、核销记录、消费端核销

结算与分配64 接口 · 48 在用 · 10 个子域 · 3 个免鉴权

卡结算、估算核算、分销与分配

营销与触达58 接口 · 37 在用 · 9 个子域 · 14 个免鉴权

优惠券、活动、活动热区、短信通知

C 端聚合接口57 接口 · 45 在用 · 14 个子域 · 48 个免鉴权

面向小程序/H5/公众号的聚合接口(zhy、mp、hhrs、萍乡、美客)

会员9 接口 · 2 在用 · 2 个子域

会员与常用联系人

统计与报表22 接口 · 21 在用 · 3 个子域 · 4 个免鉴权

首页统计、卡统计、利润核算

开放与对接466 接口 · 66 在用 · 33 个子域 · 255 个免鉴权

银行/支付/景区/政务等第三方对接与回调

平台与系统190 接口 · 78 在用 · 30 个子域 · 17 个免鉴权

用户/角色/菜单/日志、代码生成、鉴权、文件、区域

怎么读这套文档

使用导读先选角色(产品/运营/开发/测试/对接方),再看标记图例与三个常见坑 —— 第一次来必读
业务术语与状态字典status=3、cardType=2 是什么:后端枚举原值+中文含义,按「用到接口数」排序
业务域总览(左侧栏)每个域一页:有哪些业务对象、常用状态、读写哪些表、多少免鉴权接口
调用手册渠道前缀、环境主机、鉴权头、响应外层包装、错误码现状 —— 这些只写一次,接口页不再重复
全量目录1664 个接口一屏可扫,按业务域分组,可按在用状态过滤
字段 / DTO 字典同名字段在哪些接口出现、类型是否一致 —— 排查口径不一致用
数据表 → 接口反查:某张表被哪些接口读写(改表结构前先查这里)
规范体检命名/方法/注释/死链等问题的量化清单与改进建议
接口变更清单相对上一份快照(或旧站基线):新增/删除/字段与状态变更,逐条列出
数据待办清单缺摘要、摘要口径不一致、免鉴权待复核、错误码复用等,带源码位置,可复制成工单
三省卡对接文档外部三省一卡通平台(yikatongApi)的对接接口目录:70 条、状态标记、响应示例;与本仓库接口是两套系统
接口状态与负责人业务状态、维护人、最后改动与提交说明,全部由代码 + git 推断(含 586 个脚手架生成未接入接口)
错误码字典源码 ResCode / ChaosRes 常量 + 每个码被多少接口抛出

前端调用(数量口径)

旧版站点已归档到 legacy/ 供对照(只读,不再维护)。