接口测试介绍

接口介绍
不同主体之间进行通信的通道,它应具有一套规范/标准 (分类 硬件接口:USB接口 网线接口; 软件接口)

软件接口

1.软件系统中,前端和后端是两大重要组成部分

2.前端主要用于与用户交互,用户通过前端可以提交数据并查看响应的结果

3.后端主要处理用户提交的数据产生相应

比如:百度搜索,思考前后端分工前后端通过某个通道完成数据交互 搜索12306时,https://www.baidu.com/s?wd=12306

访问路径包括/s,建立通信管道 参数包括wd=12306符合标准

采用接口的好处
(实现了前后端分离)为了数据交互同时,
1.前后端都可以使用自己熟悉的技术
2.缩短了研发周期
3.保证代码安全
4.拓展性更好

接口预定义

落实到文档,该文档称之为API文档
前后端编码时,1.需要参考API文档/
2.前人总结的相关规范 如:RESTful架构风格

举例:
编写登录接口的API文档
描述:登录接口
URL:http://www.xxx.com/login
请求方式:POST
提交数据:账号 usename
密码 password
响应结果: 成功true 失败 false
前端实现:

后端实现:

1.获得用户提交的数据 2.查询结果相应数据(true/false)

接口测试的主要作用

主要作用 1.更好的辅助定位bug(前/后端) 2.发现程序中的安全隐患 3.提高测试效率

测试接口流程如下

1.绕过前端 2.通过URL定位接口资源 3.提交测试数据 4.判断响应是否满足预期

接口测试三要素

1. 定位接口资源 2.提交测试资源 3.判断相应资源

接口测试分类

1.B/S测试(web形式的接口测试): 1.服务器接口测试->自实现接口 2.外部接口测试 如支付宝接口,微信测试

2.C/S模块之间的接口测试

RESTful架构风格

为什么要学习RESTful架构风格?

避免千人千面, 使API文档风格统一

RESTful架构是一种接口设计架构, 约束了接口实现的规范

架构的作用:提高了文档的可读性

RESTful架构的设计在API文档中关于接口的描述也是围绕三要素展开的:

描述: 实现用户的登录功能
流程:
1、登录表单的数据提交到服务器: http://www.xxx.com/login, 请求方式 POST
2、提交的数据格式: username=xxxx&password=yyyy
3、响应结果:
200 {“msg”:“登录成功”}
200 {“msg”:“登录失败”}

注意: 一般响应结果的msg中, 提示信息很可能是英文

RESTful架构三要素

要素一

组成

• URL(统一资源定位符), 例如: http://www.baidu.com/s
  • 协议: 常见的有 http/ https/ ftp/ ftps
  • IP: 服务器 IP 地址
  • 端口: http默认端口一般是80, https默认端口一般是443
  • 路径: 一个资源路径映射一个接口实现
• 请求方式: 常见GET/POST/PUT/DELETE 分别对应 查/增/改/删 四种操作

get 和 post 的区别

• 提交方式不同
  • get 提交的数据显示在地址栏
  • post 是隐式提交, 更安全
• 可提交的数据量不同
  • get 提交的数据量有限制
  • post 无限制
• 执行效率不同
  • get 的效率比 post 高

要素二

两种常见的数据提交格式

• 键值对格式
• JSON格式(类似于 python 中的字典)

一般情况下, 使用 get 方式进行提交时, 使用的是键值对格式 使用 post 方式进行提交时, 使用的是JSON格式

要素三

状态码

• 1xx 请求正常, 但是无响应, 只在实验状态下使用
• 2xx 请求正常, 响应正常, 如: 200 201 204…
• 3xx 以其他方式获取响应, 如: 302 重定向 304 取本地缓存
• 4xx 浏览器端异常, 如: 404 资源路径有误
• 5xx 服务器端异常, 如: 500 服务器运行异常

响应体

常见的接口的响应体有两种类型

• 响应 html 文档, 例如: 访问百度搜索接口
• 响应 JSON 格式数据

RESTful架构风格实现

RESTful 只是一种规则, 并不是标准, 换言之, 不是硬性约束

案例

一.查询
1.1 学员-查询所有
请求方法：GET
请求地址：http://127.0.0.1:8000/api/students
1.2 学员-查询指定单个
请求方法：GET
请求地址：http://127.0.0.1:8000/api/students?s_id=S001
(注: s_id 为参数名称; S001,S005,S088 为学员ID;)
1.3 学员-查询指定多个
请求方法：GET
请求地址：http://127.0.0.1:8000/api/students?s_id=S001,S005,S088
(注: s_id 为参数名称; S001,S005,S088 为学员ID;)
1.4 学员-组合查询
请求方法：GET
请求地址：http://127.0.0.1:8000/api/students?chengji=A&banji=B01
(注: chengji：成绩; banji：班级;)

二.新增
2.1 学员-新增
1) 请求方法：POST
2) 请求地址：http://127.0.0.1:8000/api/newstudents/
3) 请求JSON报文：
4) 调用传入的json串如下（可新增多条，之间用,隔开）：

  {"data": [{"s_id":"S009","s_name":"zhangsanfeng","banji":"B01","chengji":"A"}]}

5. 新增成功返回报文：

   {"already_exist": {"results": [],"count": 0},"create_success": {"results": [{"s_id":"S009","s_name":"zhangsanfeng","banji":"B01","chengji":"A"}],"count": 1}}

	6) 新增失败id已存在-返回报文：{"already_exist": {"results": [{"s_id":"S009","s_name":"zhangsan","banji":"B02","chengji":"B"}],"count": 1},"create_success": {"results": [],"count": 0}}7) 新增失败json格式错误：

{"status_code": 400,"detail": "请求体参数格式错误。"}

三.更新
3.1 学员-更新
1). 请求方法：PUT
2). 请求地址：http://127.0.0.1:8000/api/updatestudents/S009/
(注：1：为学院ID)
3). 请求JOSN报文：

  {"data": [{"s_id":"S009","s_name":"zhangsanfeng","banji":"B01","chengji":"A"}]}4). 修改成功返回：{"s_id":"S009","s_name":"zhangsanfeng","banji":"B01","chengji":"A"}

四.删除
4.1 学员-删除单个
请求方法：DELETE
请求地址：http://127.0.0.1:8000/api/deletestudents/S003/
(注:S003为学员ID)

s_id":"S009","s_name":"zhangsanfeng","banji":"B01","chengji":"A"}

复习复盘

1.接口的概念是什么?
2.接口的作用是什么?
3.如何实现接口的通道?
4.如何预定义接口规则?
5.接口测试的概念是什么?
6.接口测试的作用是什么?
7.接口测试三要素是什么?
8.接口测试可以怎样分类?
9.RESTful三要素