第5章 接口与移门（1/2）

请关闭浏览器的阅读/畅读/小说模式并且关闭广告屏蔽过滤功能，避免出现内容无法显示或者段落错乱。

联调从周三正式开始。

吉彤坐在工位前，打开华信那边发来的测试环境接口地址，开始逐一接入沈瑶梳理好的接口清单。他先跑通了最简单的用户信息查询，数据返回得还算顺畅，但到了角色列表这一项，返回的结构跟小张之前在会议里承诺的完全不一样——文档里写的是对象数组，键名为id和na，实际返回的却是一个嵌套了三层的结构，最外层多了一个data包裹，里面还有个perission字段，压根没在文档里出现过。

吉彤截了个图，在微信上发给小张：这个返回结构跟我们上次约定的不一致，你看一下。

小张过了二十分钟回了一条：哦那个是老接口版本，文档没更新。你按实际返回的来就行。

吉彤盯着那行字看了几秒。他想起沈瑶之前说过的话——每一处不清楚的地方都得来回问。他压住心里的那口气，把实际返回的结构解析出来，重新调整了前端的映射逻辑。但这只是个开头，接下来测验证码接口时又出现了新的问题：错误码返回了三位数，但跟文档里任何一项都对不上。

吉彤这次没有直接在微信上问小张。他打开一个Excel表格，把已经对接过的几个接口实际返回的字段结构和错误码全部列出来，在旁边标注了文档所述实际返回两栏，差异处用红色标出。做完之后他把表格发到项目群里，同时在群里@了小张和刘师傅：辛苦两位看一下这个对比表，有几个地方跟文档差异较大，需要确认以哪个为准统一一下。

群里安静了一会儿。大约十分钟后，刘师傅回了一条：抱歉，文档确实没同步。你按实际返回的来，后面我们安排人把文档补全。

沈瑶从旁边探过头来看了吉彤的屏幕一眼，没有多说什么，只是轻轻了一声，尾音微微上扬，像是某种默许。

周五下午，华信那边来人了。小张背着黑色电脑包走进蔚蓝科技的时候，吉彤正在调第三个接口的集成逻辑。他抬头看见小张在前台那边刷来访登记，雾蓝色头发的前台姑娘正耐心地教他怎么用访客系统的触屏，小张的手指悬在屏幕上方按了好几下才点准。

小张来了。沈瑶从工位上站起来，走过去迎了一下，先坐，茶水间有水有茶，你自己倒。

小张被带到一张空着的临时工位上。他放下电脑包，目光不自觉地扫了一圈周围的工位——那些绿植、手账本、加湿器、毛绒柯基、写着今天也要温柔地解决问题的便签。他的表情微微抽动了一下，像是不确定自己看到了什么。

吉彤起身去茶水间接水的时候，小张正站在旁边四处打量。看见吉彤进来，他点了下头算是打招呼，然后目光落在茶水间的那排茶叶罐上——茉莉花茶、铁观音、菊花、桂花蜜，旁边还有一罐红糖和一瓶蜂蜜。小张伸手拿起那瓶桂花蜜看了看标签，又放了回去。

你们这边……东西挺全的。小张说。

茶水间日常补给。吉彤倒了一杯茉莉花茶，你要喝什么自己倒。

有速溶咖啡吗？

没留意，好像没有。

小张了一声，最后还是倒了杯白水。

联调的技术交流在下午两点半正式开始。沈瑶拉了一张白板到小张座位旁边，把之前吉彤整理的那份接口差异对比表投影到墙上，一条一条过。小张坐在椅子上，两条胳膊交叉搭在电脑键盘两侧，每被指出一处不一致就低头在代码里翻找一下，然后解释一句那个是后来改的没更新这个我回去问一下后端同事。

吉彤坐在旁边，沈瑶每指出一处他就在自己本子上记一笔。他注意到小张的语速比上次在华信会议室里慢了，也没有那种不耐烦的甩话，也许是换了个陌生的环境，也许是蔚蓝这边空气里那股淡淡的茉莉花香本身就让人不容易上火。

过到第三个接口的时候，小张忽然停下来，转头看了吉彤一眼：你这表格做得很清楚。我们内部要是有人能把文档理成这样，我少加一半的班。

吉彤愣了一下：就是Excel列的，没什么。

列清楚就是本事。小张说完这句又转回去看代码了。

联调进行了两个小时，解决了五个接口的数据映射问题。小张走之前把吉彤那份Excel表要了去，说回去照着把文档重修一版。沈瑶送他到电梯口，转身回来的时候对吉彤说了句：他态度比上次好多了。

可能是因为来了咱们这边，不太好意思摆架子。

也可能是你那表格让他觉得咱们是认真做事的。沈瑶坐回工位，你知道华信那种公司，对接的乙方多了去了，很多人就是混着把联调跑通就完事，数据对不对、错误码全不全他们不在乎。咱们一在乎，对方反而会认真一点。

吉彤回到座位上，看着屏幕上已经跑通的三个接口，忽然有点恍惚。他在恒远科技的时候，跟外部供应商对接永远是最痛苦的一环——对方的接口乱七八糟，但没人有耐心去整理成表格，所有人都在各管各的跑通，最后上线前一周集中崩溃。而现在他花了两个小时做了一张表，反而让整个流程顺了不少。

傍晚时分，赵宇从外面抽烟回来，凑过来问联调怎么样了。吉彤简单说了一下，赵宇听完若有所思地点了点头：你说这种整理表格的活儿，在咱们以前的公司是谁干？

吉彤想了想：没人干。

对啊。赵宇靠在椅背上，没人干就烂着，烂到最后大家加班一起补。我上周改代码的时候发现沈瑶给每个接口都写了ock数据，我一开始觉得她太闲了，后来发现有了ock我前端开发根本不用等后端接口，自己跑自己的，效率高出一截。你说这事儿以前的公司有没有人做？也有人提过，但大家都是等后端好了再说，一等就等了一个月。

吉彤没接话。他看着自己Excel表格里那几行绿色的已确认标记，心里慢慢浮现出一个念头——过去他觉得没人干的原因是活儿太多干不完，现在他开始觉得，也许根本原因是没人觉得应该干。

本章未完，点击下一页继续阅读。