减肥门诊接口上线前怎么联调？测试数据、幂等、回执与对账

接口文档通过评审并不代表真实链路可用。HIS、电子病历、检查检验、患者端和专病随访系统在网络、字段和业务状态上都可能出现差异，联调必须验证端到端结果。

先建立系统边界和责任矩阵

对每条接口明确发送方、接收方、主数据来源、触发方式、期望时延、失败责任和人工处理入口。没有责任边界的接口，即使技术连通也容易在异常时互相等待。

用例必须包含失败和重复场景

除正常数据外，还应测试缺少必填字段、单位不一致、枚举未知、身份冲突、网络中断和服务超时。对可能重复提交的写入接口，应验证幂等标识和重复请求的返回行为。

区分接收回执与业务成功

HTTP成功只表示接口层可能接收了请求，不一定代表业务记录已正确入库。回执应包含可关联的请求标识、处理状态和错误原因，必要时通过查询接口确认最终状态。

建立可复核的双向对账

按测试批次核对发送数、接收数、成功数、失败数和待处理数，并抽查关键字段、来源和时间。对账差异必须定位到具体记录，不能只比较汇总总数。

上线前演练停机与回退

明确接口不可用时是否缓存、谁接收告警、恢复后如何补传以及错误数据如何更正。生产切换需经过医院审批，联调通过不能替代安全、性能和业务验收。

常见问题

可以直接用真实患者数据联调吗？

应优先使用模拟或脱敏数据；确需使用生产数据时，必须符合医院授权、安全和最小必要要求。

接口返回200就算通过吗？

不算。还要确认业务处理结果、数据落点、重复行为、公开或下游展示以及对账一致性。

权威来源

参考国家卫生健康委《电子病历系统功能规范（试行）》关于数据接口、共享和字典管理的要求。具体联调与上线流程应遵循医院信息科和网络安全制度。