接口联调务必按照文档走

前置条件: 我们A公司和B公司给客户做一个项目，A、B公司之前合作过给客户做项目，这次接口工作是按照原有接口格式扩展新接口。

案情实例：

我们A公司提出具体需求文档给B公司，请B公司开发新的接口供A调用，B公司在拿到需求后，在A\B公司之前合作的接口文档上，新增了3个接口文档描述。我A按照旧的文档数据基本格式，新的3个接口文档定义进行了开发工作。等到进行联调时发现，B公司新的3个接口并没有按照B提供的文档进行开发。

我在这里犯了个错误，不应该妥协对方没有按照接口文档开发。

实际导致的结果是：

1.我这边已经开发好的代码要推翻重写，浪费很多时间。

2.需要同B公司确认他们实际的接口实现情况，根据他们实际接口返回做处理。

3.B公司开发把他们需要做的工作（基本的接口本地测试工作）转嫁到了我这里。

4.修改后的代码双方都没有按照文档开发，A我这边妥协于B的实际代码，如果双方有一方有代码逻辑变更，需要另一方进行相应变更，但多数是变更的这个消息并没有准确快速的通知给另一方。（这里是B把他没有按照文档开发的一个接口，又改成了按照文档开发，导致我根据他修改后的代码又要修改回去，3次开发）

5.开发中双方都会有自己少改点代码，让对方多改点的想法，会导致双方互相扯皮，浪费时间。

6.代码维护，不进行新的文档维护，员工离职后代码就死了。

经验总结：不按照文档开发，不进行联调，一个字，滚。

接口联调务必按照文档走相关推荐

金税接口Sap下传文档
* Program ID/Name: ZSDE1001 Date written: 20080516 * Author's name: xh Last update: * Program title: ...
基于JavaWeb平台的常用物联网硬件接口对接代码总结文档_田超凡
基于JavaWeb平台的常用物联网硬件接口对接代码总结文档 ...
干掉 Swagger + Postman？测试接口直接生成API文档，这个国产文档工具真香！
点击上方"芋道源码",选择"设为星标" 管她前浪,还是后浪? 能浪的浪,才是好浪! 每天 10:33 更新文章,每天掉亿点点头发... 源码精品专栏原创 | ...
commons-math3-3.6.1-org.apache.commons.math3.analysis.differentiation-包下的接口-中英对照文档及源码赏析
commons-math3-3.6.1-org.apache.commons.math3.analysis.differentiation-包下的接口-中英对照文档及源码赏析摘要:中英对照文档.源码 ...
干掉 Postman？测试接口直接生成API文档，这个文档工具真香！
欢迎关注方志朋的博客,回复"666"获面试宝典实不相瞒我的收藏夹里躺着很多优质的开源项目,我有个爱好平时遇到感兴趣的开源项目都会记录下来,然后有时间在慢慢研究.前几天刚给同事分享 ...
干掉 Postman？测试接口直接生成API文档，这工具真香！
前几天粉丝群有小伙伴问,有啥好用的API文档工具推荐,无意间发现了一款工具,这里马不停蹄的来给大家分享一下. ShowDoc一个非常适合团队的在线API文档工具,也支持用docker自建文档服务,不过 ...
干掉 Postman？测试接口直接生成API文档，这个工具我爱了
前几天粉丝群有小伙伴问,有啥好用的API文档工具推荐,无意间发现了一款工具,这里马不停蹄的来给大家分享一下. ShowDoc一个非常适合团队的在线API文档工具,也支持用docker自建文档服务,不过 ...
干掉Postman？测试接口直接生成API文档，这工具强烈推荐！
最近被身边几个做开发的朋友安利了一款国产的 API 开发调试神器,真的有被惊艳到!!!简直不要太好用! 没想到,中国也有了比 Postman 还好用的软件! 这个 API 开发调试神器就是 ApiPo ...
干掉 Postman？测试接口直接生成 API 文档，这工具真香！
作者:小 G 来源:GitHubDaily " 阅读本文大概需要 5 分钟. " 前阵子,偶然发现一款国产 API 接口开发调试神器,上手尝鲜之后,真的有被惊艳到,功能齐全,对中文 ...

接口联调务必按照文档走

接口联调务必按照文档走相关推荐

最新文章

热门文章