一只半路出家的码畜的经历(二十五)

我哥说:每次遇到坑，都要在解决坑之后进行总结，学到了什么。

昨天安排前端跟我对接设计页面，又出现了很多坑。。。工作没办法进行。。

是这样的:

1.先是说要进行防伪码输入查询，而我的后台只给了二维码图标预览，而没有显示门店的防伪码。改！

2.前端根据产品id调用的接口返回字段不足，需要补充。改！

3.扫码查询门店返回字段与扫码查询产品字段不符合。改！

说一下出现问题的原因:项目不是标准的前后端分离，我做的系统和平台对接的时候，会经过平台的一层包装，而这个包装又或多或少地夹杂了系统的一些逻辑。。。烦。这样的结果导致我接手这个项目的时候没能很好的充分的理解从前端到后端的具体逻辑，于是在开发的时候，就只是听产品经理说一下要提供什么接口，仅此而已。就先不说产品经理连整个逻辑都不清楚这件事了。说项目本身的问题吧，终究是因为文档不足够的原因吧。没有API文档！！没有API文档！！我都是自己打开源码，一步步debug下去。但是这个debug只能跑自己的后台系统。前端调接口就不行了。因为平台对系统的调用，是放在测试服务器上的。可能你会想，直接把平台的代码down下来一起跑不就好了？但是，这个调用链不是那么简单啊，兄弟。。调用逻辑是这样的:前端平台－RPC逻辑层－系统。 所以，要调用本地平台那就必须还要把RPC的代码down下来。。。想想，就开发一个小系统，都那么费劲。。。

所以，API文档的对接，是多么重要！写好API文档，给团队带来的收益，是在后期看得到的。

好了，过渡到API文档这件事。

昨天晚上，我把需要添加的接口写上了，要写API文档。根据上文调用链的逻辑，我写的API文档，照理来说，是提供给RPC逻辑层用的，这是毋庸置疑的吧！

结果，产品经理居然和我说，这个接口的入参你改一下，你应该填上是前端需要填写的入参。

？？？，我一脸懵逼！！要是写上之后，后期还不是要改回来？？？这么做无用功，老子不干！！于是，"不行！这么改，不符合接口API的原则，不对应！" 然后他就只能去找对接的人查明逻辑层的接口是怎么调用的了。。

嗯，这里没总结。因为整篇文章都是在讲一个道理:写好API，效率提高的第一步。

今天清明，放假一天，我没有时间回家祭祖，深飘的男青年。

送你一句: 时间会证明昨天这么努力的你！加油！