API测试用例是什么,有什么用,我们是否需要做接口测试?有什么工具可以方便的编写接口测试用例?这篇文章给你解答

1. 什么是测试用例

测试用例就是在指定输入下,看输出结果是否符合我们的预期。
例如,参数长度不符合要求情况下,系统能否判断到。
再例如,密码复杂度不达标的情况,系统能否检测到。
我们把不同情况全部列出来,一个个测试并且验证他的结果是否符合预期,这种就是测试用例。

2. 测试用例举例

为了更好的理解什么是接口测试用例,我们举个例子
假设有一个注册接口/api/login,我们可以写出哪些测试用例呢?
首先我们需要了解清楚注册接口的需求,然后根据需求才能写出测试用例。
假设需求如下:

  1. 需要用户名和密码两个参数
  2. 用户名必须大于6个字符,并且是只能字符和下划线的组合
  3. 密码必须大于6位,并且包含数字、英文

根据以上需求,我们可以根据不同输入编写测试用例,检查它的输出是否符合预期:

  1. 输入缺失用户名时,看返回结果会不会提示参数不全
  2. 输入缺失密码时,看返回结果会不会提示参数不全
  3. 用户名不够6字符时,看输出是否能检查到
  4. 用户名包含字符和下划线以外的字符时,输出是否会报错
  5. 用户名完全正确的情况下,看能否通过
  6. 密码长度不够,看输出能否提示错误
  7. 密码未包含数字和英文,能否正确提示错误
  8. 密码正确情况下,能否通过
  9. 用户名和密码都符合要求,能否注册成功
  10. 已存在用户名,再次注册,能否提示重复。
    xxxx 还有更多情况可能未考虑到 xxxx

3. 为什么需要测试用例

从上面的例子我们可以看出,一个简单的注册接口,往往也包含非常多的测试用例
每次你修改这个接口,又或者改动其他代码影响到了这个接口,你都需要重新测试接口的正确性。
如果没有测试用例,你将无法快速全面的测试接口的正确性,
你可能会说你可以用接口测试工具调用测试下,这样确实可以,但是会很麻烦,你需要准备测试环境、输入参数等等。例如用户名已存在的这个情况,你就需要准备一个已经注册的号。
另外,你很可能漏了某些情况没考虑到,也就是测试覆盖不全面。
特别是代码交接给他人后,新接手的人根本就不了解你接口的需求和逻辑,他如果要重新测试这个接口,会变得非常麻烦。

4. 怎么快速编写 API 接口测试用例

好的工具才是解放双手的利器!易文档 提供了测试用例编写工具。
使用工具我们可以把每个情况的测试代码写好,例如上面的注册接口,写好10个测试用例代码,需要的时候就可以批量执行,快速判断接口是否正确。
如下图,是一段注册接口的测试用例代码,根据不同输入,判断期望(expect)是否符合预期。
易文档测试用例代码

执行下我们的测试用例,就能看到结果了,绿色表示测试通过,红色表示失败:
易文档测试用例执行结果
易文档测试用例执行结果

更具体的易文档测试用例使用方法,请看 测试用例视频教程