智慧体育项目做到后期，现场往往是七八个系统并存：订场、门禁、闸机、计时、心率、大屏、小程序、财务。集成上线那一刻大家都很高兴，但维护阶段第一个问题就来了，接口文档找谁要、数据对不上找谁查、某条字段语义变了谁通知谁。责任边界不清，接口就变成三不管地带。
下面按接口台账、责任边界、数据对账、变更管理四块给出做法，集成方和甲方运维都可以直接套用。
一、接口台账：一个接口一份档案
台账至少九个字段：接口编号、所属系统、调用方向、触发场景、数据频率、责任人（提供方与调用方各一名）、文档版本、最近联调时间、异常处理方式。台账活在文档里没有用，要挂在运维系统里，接口出问题时一键能找到人。判断台账是否合格有个简单办法：随机抽三个线上接口，能否在 5 分钟内找到责任人和文档版本，找不到就是台账失守。
二、责任边界：按域划分，不按公司划分
- 设备域：传感器、闸机、计时设备的数据采集与解析，由设备集成方负责；
- 平台域：数据清洗、存储、统一编号，由平台方负责；
- 业务域：报表口径、流程配置、用户权限，由业务系统方负责；
- 网络域：专线、VPN、防火墙策略，由甲方网络团队负责。
划分原则是按数据的产生、加工、使用环节切，出问题时先定位环节再找人，避免各方互相踢皮球。每个域指定一名接口责任人，写进合同附件，人走交接必须更新台账。
三、数据对账：日对账与差异处理
对账频率按数据重要性分级：订单、支付、闸机通行记录日对账；心率、计数类数据周对账；日志类月抽查。对账口径取三个数：总条数、关键字段非空数、金额或计数合计，三个数任一不平就生成差异工单。差异处理流程固定：当日定位差异类型（丢失、重复、字段错位），48 小时内给出修复或补偿方案，重大差异 24 小时内上报。对账结果进日报，连续三天有差异的接口升级为重点观察。
四、接口变更：提前三日通知与回归
接口变更最常见的事故是提供方悄悄改字段语义，调用方不知情，上线后数据错一片。规矩很简单：任何接口变更提前三日书面通知，附变更说明与影响范围；调用方完成回归验证后才能切换；切换后 7 天为观察期，双方各留一名值守。我们在煜飞平台里把接口变更做成强制流程单，没有调用方确认的变更不允许发布，这条硬约束挡掉过不少深夜事故。
五、给甲方与集成方的三条建议
- 项目验收前把接口台账建全，九个字段一项不缺，作为交付物之一签字确认；
- 责任边界写进合同附件，按域划分并指定接口责任人，人员变更须书面更新；
- 日对账与差异工单接入运维系统，连续三天有差异的接口自动升级，不靠人盯。