接口文档以及接口测试用例（接口测试用例包含哪些内容）

本篇文章给大家谈谈接口文档以及接口测试用例，以及接口测试用例包含哪些内容对应的知识点，希望对各位有所帮助，不要忘了收藏本站喔。 今天给各位分享接口文档以及接口测试用例的知识，其中也会对接口测试用例包含哪些内容进行解释，如果能碰巧解决你现在面临的问题，别忘了关注本站，现在开始吧！

本文目录一览：

• 1、接口测试的测试用例该怎么写呢?
• 2、如何做接口测试
• 3、如何简单设计接口测试用例
• 4、接口测试注意的点
• 5、如何做接口测试？
• 6、用 Python 为接口测试自动生成用例

接口测试的测试用例该怎么写呢?

接口测试：

接口：主要是子模块或者子系统间交互并相互作用的部分。

这里说的接口是广义的，客户端与后台服务间的协议；插件间通信的接口；模块间的接口；再小到一个类提供的方法；都可以理解为接口。因此，可以分析，系统间的接口包含三部分：输入、处理逻辑、输出。

接口测试：是指针对模块或系统间接口进行的测试。

分析一个接口：

获取接口文档：和黑盒测试一样，我们是从需求文档中去挖掘测试点，设计测试用例。对于接口测试，同样是有对应的接口文档的。

分析接口文档，提取测试点：

1）输入：接受哪些参数、参数的类型、可选参数和必选参数等；根据输入参数采用等价类、边界值分析法等进行设计。

2）业务逻辑：对于一个接口，不同的输入参数或组合，流程或状态的转移是不同，可以根据业务逻辑画出流程图或状态转移图，确保每种状态至少被访问了一次。

3）输出：根据文档规定的输出，反向设计测试数据，使所有的输出状态都被包含了；

测试用例：同时对输入、业务逻辑、输出进行考虑时，肯定会存在用例的冗余，在最大限度覆盖业务功能和规则下，选取最优用例集合。同时，需要考虑异常数据和场景。

如何做接口测试

做接口测试流程：

测试接口文档。

根据接口文档编写测试用例（用例编写方法完全可以按照黑盒测试的用例编写规则来编写，如：边界值、正交表等等设计方法）。

执行测试，查看接口返回的接口数据是否正确，主要检查返回的接口是否和接口文档中定义的一样，还有要检查返回的数据是否和数据库中的保持一致。

接口测试是测试系统组件间接口的一种测试。接口测试主要用于检测外部系统与系统之间以及内部各个子系统之间的交互点。测试的重点是要检查数据的交换，传递和控制管理过程，以及系统间的相互逻辑依赖关系等。

①目的：测试接口的正确性和稳定性；

②原理：模拟客户端向服务器发送请求报文，服务器接收请求报文后对相应的报文做处理并向客户端返回应答，客户端接收应答的过程；

③重点：检查数据的交换，传递和控制管理过程，还包括处理的次数；

④核心：持续集成是接口测试的核心；

⑤优点：为高复杂性的平台带来高效的缺陷监测和质量监督能力，平台越复杂，系统越庞大，接口测试的效果越明显（提高测试效率，提升用户体验，降低研发成本）。

接口测试范围：

a)业务功能（包括正常、异常场景是否实现）

b)业务规则（覆盖度是否全面）

c)参数验证（边界、业务规则是否达到要求）

d)异常场景（重复提交、并发提交、事务中断、多机环境、大数据量测试）

e)性能测试（响应时间、吞吐量、并发数、资源要求）

f)安全测试（权限验证、SQL注入等）

如何简单设计接口测试用例

接口测试是项目测试的一部分 ，它测试的主要对象是接口 ，是测试系统组件间接口的一种测试。接口测试主要用于检测外部系统与所测系统之间以及内部各系统之间的交互点。测试的重点是检查数据交互、传递、和控制管理过程以及系统间的相互依赖关系等。 如何设计接口测试用例？首先，明确出发点，和所有的测试一样 ，接口测试出发点是你要证明所测的程序是错误的。以这个出发点为导向 ，你的设计行为就会尽量朝这个方向，更易发现问题 其次，选择好测试对象。对于一个系统做接口测试选择好的测试对象是接口测试关键。一个系统有无数的接口 ，每个接口如果分别测试 ，那将是很痛苦的一件事情，而且任何一个内部接口的变动 ，都将导致我们用例的不可用。 可将这些最外层的接口分为两类：一类是数据进入系统的接口；一类是数据流出系统的接口。进入系统的接口实际是我们用例的执行调用的接口。可通过变化参数对这些接口进行调用 ，模拟外部的使用；而流出的接口则是我们用例真正该验证的点。数据从哪里流出，流出时的状态如何 ，此时系统又是什么状态都是我们所应该验证的。 然后，确认完整的测试对象的功能：确认外部接口提供给使用这些接口的外部用户什么样的功能，外部用户真正需要什么样的功能。此两个功能一定要准确详细，用例的设计要严格按照测试对象功能设计才是正确的用例。 最后当出发点、对象、功能都确定了，就可以真正设计用例了。下面详细介绍下如何去设计一个结构好、可读性高、渗透性强的接口测试用例。 接口测试用例设计和测试用例设计一样，用例设计的内容应该包括：主要测试功能点、测试环境、测试数据、执行操作以及预期结果。 1）接口测试环境分为两种：一种是程序内部的环境；一种是程序的所调用外部接口的环境。 2）接口测试测试数据分为接口参数数据和用例执行所需系统数据。数据的设计、准备测试用例的数据上需要花费更多的心思。要通过好的测试数据使用例查找问题。接口参数数据需对每个参数根据测试接口的实际的功能进行分析，在符合业务逻辑的情况下进行逻辑组合排列 ，不要遗漏了某些边界值和错误点的数据。每个用例执行所需系统数据和接口参数数据尽可能的采用不一样的数据 ，使用例更容易发现问题。 3）测试功能点，如果一个接口功能复杂时推荐对接口用例进行结构划分 ，这样子用例具有更好的可读性和维护性。接口划分原则为以接口提供的功能点的不同进行合适粒度的划分。同一功能点的用例又可根据测试环境的不同、数据的不同进行用例的填充。 4）接口测试用例执行操作非常简单，就是所测接口的调用。 5）预期结果验证，这也是接口用例设计的很关键的一步 ，应该细而不冗余。每个用例均需验证 ，避免一个用例中重复做相同的验证 ，提高测试用例的效率。 如何设计接口测试用例小例子： 简单划分可以按照2个基本组成要素进行划分：1. 参数 2. 业务 以下为最简单的一种划分用例的方法，可能涵盖不全，但只为说明一种划分接口用例的方法方式以及需要考虑的测试用例的测试点 为何要如此设计，是为了更好的将用例分类为程序规定型以及业务限制型，尽量的保证覆盖，尽量细化到点的划分形式来保证工作时间的预估和计划。 所有的自动化接口的测试用例 都基本围绕三部曲进行，传数据，执行，校验返回的数据和期望数据是否一致来构成每个简单的测试用例。 有清晰的线路和清晰的思维，才能做好整体测试的掌控。

接口测试注意的点

接口测试作为集成测试接口文档以及接口测试用例的一部分接口文档以及接口测试用例，通过直接调用被测试的接口来确定系统在功能性、可靠性、安全性和性能方面是否能达到预期，有些情况是功能测试无法覆盖的，所以接口测试是非常必要的。

接口测试分为两种，一种是webservice接口，走soap协议通过http传输，请求报文和返回报文都是xml格式的，测试时通过工具soapUI进行测试。使用情况比较少接口文档以及接口测试用例；另一种http api接口，走http传输协议，通过路径来区分调用的方法，最常用的是get和post请求。

get请求和post请求的区别在哪里呢？网上的答案为：

1、get请求可以在浏览器中请求到，post请求的测试需要借助工具

2、get请求使用url和cookie传参，post的数据放在body中

3、post比get更安全，因为传递的参数在url上是看不到的

4、get请求的url会有限制，而post请求的数据可以非常大

5、一般get请求是来获取数据，post请求是传递数据的

其实，对于现在飞速发展的 互联网来说，上面的说法已经不严谨了。首先，post请求的参数也可以写在url里，但是这种情况不多见；其次表面上看起来，post利用body传参，比get的url传参安全，但其实只要用抓包工具（fiddler，Charles等），post的参数也是一览无余；再次，现在的浏览器非常强大，可以输入支持很长的URL，所以也不再有限制一说了。这么说来，种种区别只有最后一条是最根本的了。

　怎么来测试接口呢？根据什么来测呢？这就需要开发提供的接口文档了，接口文档和功能测试的需求说明书的功能是一样的。包括：接口说明、调用的url，请求方式（get or post），请求参数、参数类型、请求参数说明，返回结果说明。这里接口文档生成可以使用apipost接口文档生成工具。有了接口文档后，接口文档以及接口测试用例我们就可以设计用例了，一般接口测试的用例分为以下几种：

1、通过性验证，说白了就是传递正确的参数，是否返回正常的结果

2、参数组合，因为参数有必传和非必传，参数的类型和长度，以及传递时可能业务上的一些限制，所以在设计用例时，就要排列组合这些情况，保证所有情况都能覆盖到

3、接口的安全性，这个又分为几种情况：

1)绕过验证，比如提交订单时，在传递商品价格参数时，修改商品价格，就要看后端有没有验证了。或者我支付时，抓个包将订单金额一改，如果能以我改后的金额支付，那这个借口就有问题了。

2）绕过身份验证，就是某个功能只有有特殊权限的用户才能操作，那我传递一个普通的用户，是不是也能操作呢

3）参数是否加密，这个关系到一些账户的安全，比如我们在登录一些网站时，它要将我们的登录信息进行加密，如果不加密我们的信息就会暴露，危害性极大。

4) 密码安全规则，设置密码时复杂程度的校验。

4、根据业务逻辑来设计用例

用例设计完了，用什么来测试接口呢？我们可以借助一些工具，比如apipost和jmeter。apipost使用比较简单，可以在列表中选择请求方式，在输入框中输入URL，如果是get请求，直接点击发送就可以看返回结果了。

如果是post请求，会涉及到几种参数的上传方式和添加请求头、权限验证还有添加cookie等操作。apipost都可以简单实现

还有一种测试接口的工具是jmeter，用途比较广泛，不但能测接口的功能，还能对接口进行性能测试。比如：压力测试、负载测试等。在jmeter中需要创建线程组，如图：

Apipost官方链接： https://console.apipost.cn/register?utm_source=10008

如何做接口测试？

对于接口测试，首先测试人员要懂代码，你只需要知道接口的作用是什么就可以了，其次，自己去读开发的代码。

然后，根据该接口功能及代码写测试用例：根据该接口参数，构造不同的用例，测试接口在参数合法及非法情况下能否达到预期效果，根据该接口中的逻辑，测试该接口实现代码的逻辑，进行容错及健壮性测试，静态检测代码，看是否有内存泄露、或永远走不到的分支、代码规范及逻辑是否合理，对于一些接口，需要进行多线程测试。

接口测试一般会用于多系统间交互开发，或者拥有多个子系统的应用系统开发的测试。接口测试适用于为其他系统提供服务的底层框架系统和中心服务系统。

主要测试这些系统对外部提供的接口，验证其正确性和稳定性。接口测试同样适用于一个上层系统中的服务层接口，越往上层，其测试的难度越大。接口测试在淘宝的应用是一个自下而上的发展过程。

用 Python 为接口测试自动生成用例

基于属性的测试 会产生大量的、随机的参数，特别适合为单元测试和接口测试生成测试用例

尽管早在2006年haskell语言就有了 QuickCheck 来进行”基于属性的测试“，但是目前来看这依然是一个比较小众的领域，参考资料有限，本文如有不足，欢迎指正。

在过去的测试实践中，执行测试时通常需要明确的内容（Value）：

这些内容可以通过”判定树“或者”判断表“来表示，然后测试的执行过程变成了这样

可以称为 基于表的测试

在最初，这给了我们测试的方向，但是缺点也非常明显：

你要足够多的"X-Y" 才能可能覆盖到隐蔽的bug。

这里请大家回答几个问题：

如果以上问题的答案不是yes，那么 基于属性的测试 就是你需要掌握的东西！

基于属性的测试和基于表的测试，最大的区别可以这样描述：

vs

于是利用工具生成大量的X类数据，进行测试，并验证结果是否Y类。

值得注意的是：

在不同的语言中有不同的工具来实现，比如：

本文以python为例进行演示：

假设有add函数，接收两个类型整数参数，并返回它们的相加结果

首先写出一个简单的测试用例

正如前面所说，一个这样的用例，根本没信心覆盖全部的场景，例如：

所以接下来怎么办？

改为基于属性的测试

执行结果

由结果可知，工具根据 参数是整数 这一规范，自动生成、执行了大量的测试用例

接口测试和函数的单元测试非常相似：

此外接口文档作为前后端、甚至测试开发的对接窗口，对参数的要求约定的更加细致，

以OpenAPI为例，每个参数可以有以下属性：

于是为接口生成符合要求的参数就变得可行了，举个例子：

这是以unittest为例进行封装的结果，只需要在TestCase中指定openapi的内容（或路径），

启动测试框架时，会自动读取、解析接口文档，并生成测试用例

下面是部分执行日志，可以看到对接口发送了随机参数，并获得返回值

文章来自https://www.cnblogs.com/dongfangtianyu/p/api_test_by_pbt.html

关于接口文档以及接口测试用例和接口测试用例包含哪些内容的介绍到此就结束了，不知道你从中找到你需要的信息了吗 ？如果你还想了解更多这方面的信息，记得收藏关注本站。 接口文档以及接口测试用例的介绍就聊到这里吧，感谢你花时间阅读本站内容，更多关于接口测试用例包含哪些内容、接口文档以及接口测试用例的信息别忘了在本站进行查找喔。

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