后端接口文档（后端接口文档看不懂）

本文目录一览：

• 1、什么是接口文档？

• 2、什么是接口文档,如何写接口,有什么规范?

• 3、前后端分离，关于接口文档，后端是要先写好接口文档，再进行写代码开发，还是写完代码后再编写接口文档？

什么是接口文档？

接口文档又称为API文档，一般是由开发人员所编写的，用来描述系统所提供接口信息的文档。 大家都根据这个接口文档进行开发，并需要一直维护和遵守。

如果想系统的学习接口测试相关的技术，可以了解一下黑马程序员的软件测试课程，里面讲的非常详细。

什么是接口文档,如何写接口,有什么规范?

含义是：在项目开发中，web项目的前后端分离开发，APP开发，需要由前后端工程师共同定义接口，编写接口文档，之后大家都根据这个接口文档进行开发，到项目结束前都要一直维护。

目的是：项目开发过程中前后端工程师有一个统一的文件进行沟通交流开发。项目维护中或者项目人员更迭，方便后期人员查看、维护。

规范是：以/a开头，如果需要登录才能调用的接口(如新增、修改；前台的用户个人信息，资金信息等)后面需要加/u，即：/a/u；中间一般放表名或者能表达这个接口的单词；get方法，如果是后台通过搜索查询列表，那么以/search结尾，如果是前台的查询列表，以/list结尾；url参数就不说了。

API（Application Programming Interface，应用程序接口）是一些预先定义的接口（如函数、HTTP接口），或指软件系统不同组成部分衔接的约定。用来提供应用程序与开发人员基于某软件或硬件得以访问的一组例程，而又无需访问源码，或理解内部工作机制的细节。

应用程序接口又称为应用编程接口，是一组定义、程序及协议的集合，通过 API接口实现计算机软件之间的相互通信。API 的一个主要功能是提供通用功能集。

API同时也是一种中间件，为各种不同平台提供数据共享。程序设计的实践中，编程接口的设计首先要使软件系统的职责得到合理划分。良好的接口设计可以降低系统各部分的相互依赖，提高组成单元的内聚性，降低组成单元间的耦合程度，从而提高系统的可维护性和可扩展性。

前后端分离，关于接口文档，后端是要先写好接口文档，再进行写代码开发，还是写完代码后再编写接口文档？

两种方式都是可以的,针对不同的团队有不同的选择

一般对于需求分析,设计能力比较强,的团队,推荐使用契约优先的设计模式,也就是先编写接口文档,规定好接口的 请求类型/参数数量/参数类型/返回结果的格式然后搭建模拟服务,然后前后端分别开发,但是这种方式需要比较高的设计能力,以应对需求的变更,设计时需要考虑的方面很多,适合于成熟的团队.

如果需求不确定性较高,甚至频繁变动,上面这种方式,就会有局限性,频繁的需求变更带来的就是频繁的接口契约变更.会拖慢前后端的开发进度,这种时候可以采用,先开发后编写文档的流程,由于频繁的发生变更,这时候团队的沟通显得很重要,项目管理人员一定要十分注意前后端开发的沟通效率,不然项目进度会变得不可控

版权声明：本文内容由网络用户投稿，版权归原作者所有，本站不拥有其著作权，亦不承担相应法律责任。如果您发现本站中有涉嫌抄袭或描述失实的内容，请联系我们jiasou666@gmail.com 处理，核实后本网站将在24小时内删除侵权内容。