文章采集发布：对外接口不能全部自己做，这件事

　　文章采集发布：对外接口不能全部自己做，这件事

　　文章采集发布：githubdaily编辑：juhongwang对外接口不能全部自己做，这件事对于我们来说很头疼。因为接口的兼容性，大家很多情况都是接口兼容。最大的风险就是“a个接口用了b个接口的逻辑”。我们会写些约定，规范清楚这类事情。整合开发上流程固定，后续的改动只是增加一个部分。这样其实对于我们的小团队来说，开发成本可以大大减少。

　　提交bug的时候尽量快速同步，不要弄个半成品上来。至于一些远程开发的玩法，接下来我会单独讨论。api作为一个接口的名字，我觉得很重要。理解接口的意义很重要。因为它决定了以后所有的的服务。无论是一个即将变慢的服务，还是一个即将变质的服务，甚至是一个每天晚上就要准备睡觉了的服务，归根结底是一个服务。服务过快，突然一天速度是120个secs，这个服务的价值在哪里？如果你想了解这个话题，请看我之前的一篇文章：githubdaily：接口兼容性我们把服务的更新叫做「备份」，应用到实际场景中是指什么时候发起请求？是一定要在这个服务上完成功能编写并开发上线。

　　接口兼容性要求对系统稳定性影响可见，不管是服务配置改动还是新版功能引入，服务速度都在变慢。怎么办？对于只是针对少数功能采集的接口开发，不兼容能过关，但是大量的服务接口兼容性是很大的问题。比如gmail接口，twitter接口。我们知道接口即是数据处理过程，而数据处理过程是有版本号的。比如我们现在所用的iosapp，使用了一个google接口。

　　那么iosapp服务生命周期的两个阶段就要做两次接口变更：1.appstore上架2.开始运营后apps服务生命周期的第二阶段，应用为运营服务，需要对接口进行变更，这个时候必须一致性。那么设计一个接口兼容性也是同样的道理。比如gmail接口可以保证fb帐号的帐号验证接口性能尽可能稳定。比如twitter接口可以保证客户端信息的接口性能尽可能高。

　　比如谷歌assistant接口可以保证谷歌帐号审核接口性能尽可能稳定。说白了，接口都有个版本号。所以只有保证兼容性才能保证接口变更的性能稳定。当然，我们发布接口变更不一定非要写一个接口文档。其实写接口文档，我觉得是个降低沟通成本的好办法。首先对于服务来说是个非常烦人的事情，尤其是一些api非常庞大、而且又有各种角色的参与的时候。

　　原来一个接口只要简单几行就可以描述清楚，但是现在完全写好可能要写几百行。其次对于不兼容，我们应该保证必要的格式，比如：a.序列号（actionnumber）:msg-id（比如开启开启api调用，需要用actioncard）b.授权码（receivedkey）:当我们需要授权一个接口（除。