官网表单的线索没进系统、ERP 的订单状态没同步过来、财务对不上数。排查到一半才发现，双方都以为是对方的问题，而接口本身没有任何记录。
一、接口失控的四种场景
- 谁在用说不清：临时需求上线后没人记得
- 参数变了没人通知：一边改了字段，另一边还按老格式解析
- 失败无人知：接口报错只写在日志里，业务侧毫无感知
- 交接即失传：负责的同事离职，接口成了黑盒
二、接口台账至少写五列
- 接口名称与用途
- 双方系统与负责人
- 传输字段与频率
- 失败重试规则
- 上一次联调时间
三、失败不能静默
- 失败达到阈值自动通知双方负责人
- 关键接口设置补偿任务，定时重试
- 数据量对不上时在业务侧给出提示
举个例子，官网线索同步接口如果连续失败超过十分钟就通知市场和技术，业务侧看到提示后可以人工补录，避免线索静默丢失。
四、变更要走流程
任何字段增减、格式调整、频率变化，都要提前通知对端并约定切换时间。同时保留旧版本的兼容期，避免某一天数据突然对不上。
五、定期做一次联调体检
建议每半年把主要接口重新跑一遍，核对数据条数和关键字段。接口和人际关系一样，长期不联系就会生疏，等到出事再联系往往已经晚了。
对接越多，越需要一本账。9527CRM 提供开放接口与同步日志，把外部系统的交互记在一处，出问题时不用再靠猜。
