无非就是找到这个api接口文档档吗?

任何专业的开发者都应该明白,实现方法服从于功能需求,而功能需求体现在接口定义中。所以,必须要先确定接口定义,然后才能开始实现,这是基本规则,题主说的『早点发现问题早点改,防止到后面大家再返工』是完全正确的工程态度,无可厚非。相反,题主遇到的后端反问『你都开发完了吗』,这种开发者(我不在乎他是后端还是前端)是非常不专业的,你管我开发没开发完呢,重要的是大家有一个共同认识,如果要等到上下游开发完之后才来考虑集成,不可预料性太多,这就是增加项目风险。哎呀,这些还要我说出来,我都觉得没有意思,因为这些道理都是不言自明的啊!题主所说的这样的(后端)开发者,极不专业,不专业得我……我都不知道说什么好.......对了,题主还有一个问题:『我应该怎么说服后端?』朋友,要说服一个人,可很不容易,如果你能够把一个人教育得转过来,要花很多精力,而面对这样的货色,我觉得不值得你花太多精力;我建议你用另一种方法去『说服』他,那就是直接去找有权力改变对方行为的人,找你的领导来说明情况,让你的领导去找对方领导去谈,当然,如果你们有一个共同的领导更好。领导拿的工资就是干这个的,领导的工作职责之一就是要提高工作效率,他们有责任处理好这样的事情。当然,很有可能,领导也处理不好这件事情,或者因为领导自己也是傻X,或者因为领导怕得罪人装糊涂,或者因为领导根本就不想管。那,哥们,你就别费那劲『说服』他们了,赶紧准备简历找一个新的工作才是正经的。想想看,你的开发意识已经强过了其他开发者,强过了你的领导,也就强过了这个团队,你待得时间越长你的身价就越低,赶紧离开这个地方,找一个理念正确的团队工作,才能发挥你真正的价值。后端写 view model,部署 swagger,工具:https://github.com/springdoc/springdoc-openapi 前端 curl 同步 swagger.json,通过自己写的脚本自动生成接口类型声明。注意接口类型声明禁止任何人改动,只允许生成。前端针对接口类型声明开发功能后端完善功能,可能会改动 API 的 view model,更新 swagger.json前端在开发中及时同步 swagger.json,重新生成接口类型声明,修改ts代码以通过编译最后上线前同步一遍 swagger,重新生成接口类型声明,保证代码都能通过编译swagger.json 和代码生成脚本要被git管理,但是生成的代码不用放入。说服后端,你就让他先不给实现,先把 swagger 部署出来。这个不太耗时的。

我要回帖

更多关于 api接口文档 的文章

 

随机推荐