开发文档和接口文档（开发文档和接口文档哪个好）

本文目录一览：

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

• 2、android开发接口文档怎么写

• 3、什么是接口文档？

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

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

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

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

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

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

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

android开发接口文档怎么写

1 接口书写的格式：

1   用例图

2   流程图

3   具体的接口：

3.1请求的方式：

包括：

服务器地址 le.gxjinan.com/open/user.php?ac=login

请求方式 POST

编码格式 UTF-8

内容的格式 application/x-www-form-urlencoded

3.2 请求的参数：

例如：

参数 类型 是否必须

说明

user String  是 手机号，邮箱，用户名

3.2 响应信息：

请求方式 POST

编码格式 UTF-8

数据类型 Json 数据实体，包含msg对象。

内部包含的注册成功后用户的ID!

3.3 返回的数据:

返回的正确信息

整体的Json 数据，

详细的Json数据，

返回错误的信息

什么是接口文档？

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

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

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