接口自动化测试用例的编写方法

news2025/6/2 9:34:10

🍅 点击文末小卡片，免费获取软件测试全套资料，资料在手，涨薪更快

phpunit 接口自动化测试系列

Post接口自动化测试用例

Post方式的接口是上传接口，需要对接口头部进行封装，所以没有办法在浏览器下直接调用，但是可以用Curl命令的-d参数传递接口需要的参数。当然我们还以众筹网的登录接口为例，讲解post方式接口的自动化测试用例。

（1）接口文档

.登录(POST)
URL：http://api.zhongchou.cn/user/login

参数：

identity，用户名、用户手机、用户邮箱，三者之一

password，用户密码

errno，0：表示成功，非0：表示失败

User基础数据结构

token，成功会返回32位token字符串，失败会返回空字符串

这个接口文档很清楚，就是传递用户名和密码进行登录，登录后会返回user基本数据结构和Token。

（2）Curl命令执行

分析了接口文档，我们需要在终端下执行接口，然后才能根据接口的返回值来编写对应的接口测试用例。

在终端下执行命令：

[root@n028 api]# curl -d ‘identity=1838905&password=a**0’ http://api.zhongchou.cn/user/login?v=1

其中的identity为众筹网的用户名，password为密码，V=1是因为这个接口是第一版本的。执行结果如图4.2.1所示：

在这里插入图片描述

（3）Curl返回值查看

由于post方式无法用浏览器直接调用，返回结果是编码后的json字符串，不方便我们查看结果。所以我们要借助于chrome的插件。

打开chrome浏览器->右击浏览器，选择“审查元素”->在浏览器下部选择“Console”选项卡。在打开的栏目下的“>”后输入dir().然后将刚刚终端Curl返回的结果拷贝到这个函数中，回车即可解析结果。如图4.2.2所示：

在这里插入图片描述

（4）PHP调用Post方式接口

PHP调用Post接口和Get方式有所不同，一般用以下方式调用，而且是固定的：

public function testlogin()
 
    {
 
        $url='http://api.zhongchou.cn/user/login?v=1';
 
        $post_params=array('identity'=>'183****8905','password'=>'a0****0');
 
        $ch = curl_init();//初始化curl
 
        curl_setopt($ch, CURLOPT_URL,$url);//抓取指定网页
 
        curl_setopt($ch, CURLOPT_HEADER, 0);//设置header
 
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);//要求结果为字符串且输出到屏幕上
 
        curl_setopt($ch, CURLOPT_POST, 1);//post提交方式
 
        curl_setopt($ch, CURLOPT_POSTFIELDS,$post_params);
 
        $data = curl_exec($ch);//运行curl
 
        curl_close($ch);
 
  
 
        echo  $data;
 
    }

然后执行代码，就可以看到如图4.2.3所示的输出结果：

在这里插入图片描述

如到Get方式，这个输出结果同样是经过编码后的json字符串，我们也需要对其进行json_decode（）解码一下，然后再输出结果。所以增加以下两行代码：

res=jsondecode(data);

print_r($res);

此时的输出结果图4.2.4所示，简单清晰了许多。

在这里插入图片描述

（5）PHP编写Post接口自动化测试用例

现在PHP能调用post方式的接口了，可是没有添加自动判断执行结果的脚本，不算是一个真正的测试用例。接下来我们添加上对返回值的assert语句，使之成为一个完整的自动化测试用例。

完整的测试用例如下：

public function testlogin()
 
    {
 
        $url='http://api.zhongchou.cn/user/login?v=1';
 
        $post_params=array('identity'=>'183****8905','password'=>'a0******0');
 
        $ch = curl_init();//初始化curl
 
        curl_setopt($ch, CURLOPT_URL,$url);//抓取指定网页
 
        curl_setopt($ch, CURLOPT_HEADER, 0);//设置header
 
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);//要求结果为字符串且输出到屏幕上
 
        curl_setopt($ch, CURLOPT_POST, 1);//post提交方式
 
        curl_setopt($ch, CURLOPT_POSTFIELDS,$post_params);
 
        $res = curl_exec($ch);//运行curl
 
        curl_close($ch);
 
        $data=json_decode($res,true);
 
        //print_r($data);
 
        if(is_null($data)==false)
 
        {
 
            if($data['errno']=='0')
 
            {
 
                $this->assertEquals('0',$data['errno']);//判断errno是否为0，此步为抛出执行通过
 
                $index =strpos($data['data']['name'],'8905');
 
                $this->assertnotEquals(-1,$index);//判断结果是否包含关键字
 
                print('接口/user/login：登录接口------------------OK'."\n");
 
            }
 
            else
 
            {
 
                $this->assertEquals('0',$data['errno']);//抛出执行失败
 
                print("接口/user/login：登录接口---------------Failure!"."\n".$res."\n");
 
            }
 
        }
 
}

Assert判断语句和get相似，先判断返回errno,然后判断返回的name是不是我们刚刚登录的账号。当然如果返回值不是我们预期的，也要使测试用例执行失败。执行结果如图4.2.5所示，同样如果要看接口返回值，注销掉//print_r($data);

在这里插入图片描述