接口变更怎么通知？

接口变更通知要让业务和技术同时看懂影响。春喜铜平台里，接口常常连着订单、库存、客户资料、审批、企微提醒和报表。如果只通知“接口今晚升级”，现场并不知道哪些单据会受影响；如果只说字段变化，业务人员也判断不了风险。

先确认变更影响

通知前先把影响范围查清楚：

• 哪个系统发起，哪个系统接收。
• 涉及哪些业务对象，例如订单、客户、库存、工单、审批或通知。
• 变更是新增字段、字段含义调整、枚举变更、调用频率变化，还是失败处理规则变化。
• 是否影响历史数据、未完成单据和正在流转的审批。
• 是否需要停用旧模板、旧报表或旧导入文件。

没有影响范围的通知，容易变成技术群里的消息，业务现场仍按旧规则操作。

通知里必须有新旧对照

接口变更通知要保留新旧对照。字段名称、字段含义、必填规则、默认值、异常处理和上线时间都要写清楚。涉及枚举值时，要说明旧值是否继续兼容；涉及时间字段时，要说明按创建时间、审核时间还是出入库时间计算。

如果接口和报表有关，还要说明报表冻结时间。否则同一个会议前后看到的数字可能不同，后续复盘也很难判断差异来自业务变化还是接口变化。

上线窗口和回退安排

接口变更不要只写计划上线时间，还要写观察窗口、回退条件和人工处理方式。上线后如果出现失败率升高、重复推送、部分成功或对方系统维护，应有明确负责人判断是否暂停、重试或手工补录。

对于客户资料、价格、库存、财务相关接口，回退不能只靠技术恢复旧代码，还要说明已经写入的新数据怎么核对，哪些记录需要人工复查。

通知后的复核

变更完成后，应抽查接口日志和业务单据是否一致。至少看请求时间、业务单号、状态、失败原因和重试记录。业务负责人要确认使用结果，技术负责人确认传输稳定，不能只看接口返回成功。

接口变更通知的目的，是让每个受影响岗位提前知道哪里会变、什么时候变、出了问题找谁，而不是事后再从异常数据里倒查原因。