医院的接口版本治理,不是给接口标上版本号,而是让每次变更都可识别、可评估、可验证、可追溯。缺少统一机制时,同一接口可能被不同厂商以不同口径修改,导致单系统测试通过,跨系统业务却出现字段误读、数据遗漏或调用失败。治理的起点应是医院掌握接口资产及其责任归属,而不是先要求所有系统统一升级。
建立版本台账与变更入口
医院应按系统和数据流梳理接口清单,记录接口用途、提供方与接收方、数据范围、当前版本、依赖关系、业务责任人和技术责任人。字段定义、编码映射、必填规则、身份认证、错误返回等约定,也应纳入接口文档并与对应版本关联。对于多厂商链路,还需标明数据转换发生在哪一层,避免问题出现后责任边界不清。
版本变更应有统一入口。申请方说明变更原因、影响接口和业务场景;评审时判断是否涉及字段含义、数据格式、授权范围或调用行为变化,并识别上下游系统及存量接口的影响。只有完成影响评估、责任确认和实施安排,变更才进入开发与联调,不能以“对方已经升级”代替医院内部评审。
把兼容和验收纳入生命周期
每个版本都应明确适用范围、变更内容、兼容方式和退出安排。能兼容现有调用方时,应明确兼容边界;不能兼容时,应提前通知相关系统并安排迁移,避免新旧版本切换造成业务中断。具体兼容策略应结合接口用途和系统条件确定,不宜设定脱离实际的统一期限。
验收不能只看接口是否连通。应围绕代表性业务场景核对字段映射、数据完整性、异常反馈、重传及问题追溯,并保存测试结果、差异清单和整改记录。上线后,变更说明、调用异常和责任处理也应留痕;必要时预先明确回退条件与执行责任。
最后,采购和改造合同应写清接口文档、版本变更通知、联调配合、缺陷修复及跨厂商问题处理责任。医院仍须自行承担业务口径、授权审批和数据质量管理,不能用供应商的标准符合性承诺替代内部治理。通过台账、评审、测试和留痕形成闭环,接口升级才不会退化为一次性的开发任务。
