api接口规范 后端开发完接口才给出接口文档，合理吗？你怎么看？

后端开发完接口才给出接口文档，合理吗？你怎么看？

一个非常好的问题，我是工作多年的Web应用架构师，来回答一下这个问题。欢迎关注我，了解更多IT专业知识。

后端给出接口文档太晚，也合理也不合理，要看具体情况，总有解决方法，我来说一下我的观点。

不合理：成熟的技术团队，重视功能设计，在动手写代码之前已经有了完整的技术文档和功能定义，甚至在TDD测试驱动开发模式中，测试数据已经准备就绪，那么这时接口文档不管写没写，接口逻辑都是已经确定的，整理出来是水到渠成。

合理：多存在于早期小型创业公司，主观客观原因都有。

- 先说主观原因。赶进度、没时间、懒得写，甚至开发前都没做仔细的设计，边做边改，这些原因普遍存在，也实在没啥好办法。

- 客观原因，需求在变，功能跟着变，接口也要变，那么如果写了文档，理所当然也要更新维护啊？我的天哪。

有解决方法吗？建议试试：

1，Swagger接口文档，将文档融合到代码中，让维护文档和修改代码整合为一体，使得修改代码逻辑的同时方便的修改文档说明。

2，Postman接口测试工具，导入导出JSON文件，高效团队协作。Postman支持各种请求方式和配置环境变量，并对返回结果进行测试校验，支持批量自动化运行，可以和自动构建系统集成。

怎么看待一些后端程序员不写接口文档，老是以很忙为借口搪塞？

感谢邀请！
不写接口文档，一般都是很忙。或者没有空闲的时间去梳理文档。

前后端对接，一般前段开发人员一般都需要后端人员提供接口文档，但是现在swagger文档已经完全可以提供该功能。很多情况下后端开发程序员集成一个swagger进去，会自动生成相应的文档。

可以给后端开发人员一定的时间去学习swagger或者集成swagger进项目。

api接口规范 免费的api接口推荐 api接口

版权声明：本文内容由互联网用户自发贡献，本站不承担相关法律责任.如有侵权/违法内容,本站将立刻删除。