一、接口及接口测试

这里插播一个段子

1.接口的概念

1）简单概括为以下3点：

• 程序代码（函数方法）
• 屏蔽实现细节
• 可以被访问/调用来获取信息或实现某些功能（提供访问地址，定义了访问规则）

2）接口自述（通俗的来说）：

• 首先我有一些功能（功能函数）
• 你不用关心我怎么实现的（屏蔽细节）
• 我会给你一个我的地址（接口地址）
• 你按照地址找到我，按照我规定的格式（请求类型）告诉我所需要的信息（参数）就行
• 我会给你个反馈（响应信息）

3）举个栗子：

1. 西虹市公考报名处——接口名称
2. 报名地址： 西虹市街口区带莫路3号 ——接口地址
3. 现场需填写资料： 姓名，身份证证号码，专业，报考岗位等等——接口参数
4. 验证规则：——参数验证规则

• 身份证需与本人一致
• 专业需与报考岗位符合
• 报名时间 2024.8.22-2024.8.30
• 现场会给出是否报名成功 --- 接口响应信息

4）软件中的接口

（接口处理过程）

从开发者角度，接口是分工协作的产物，不同开发者实现自己的功能之后，封装成接口，供其他开发者调用。其他开发者只要按规定格式发送一些必要参数，就能使用该功能

5）常见接口类型

• HTTP接口：通过HTTP协议传输的接口，可以传输文本表单数据，也可以传输Json类型的对象数据或xml类型的数据
• RPC：远程方法调用，随着分布式系统的出现，当你需要调用部署到其他服务器上的方法时，需要用到RPC。RPC只是提出了这样一个问题，有很多种解决方案，比如WebService(基于SOAP协议)， REST(基于HTTP协议）。
• SOAP：简单面向对象协议，基于HTTP，使用xml作为默认传输格式
• Web Service：基于SOAP协议的一种RPC实现方案。相比传统的HTTP接口只传输文本请求和文本相应，通过Web Service可以直接拿到远程的一个对象，并能够直接调用该对象的属性和方法，比HTTP更高级。
• REST/RESTful AP：REST，表述性状态转移。一种HTTP接口的设计风格，将一切接口视为资源，要求接口路径同意管理，分版本管理，规定了GET/POST等请求以及HTTP状态码的使用规范，默认使用JSON格式传输。RESTful API即满足REST风格即设计规范的API接口。

2.什么是接口测试？

1）为什么要做接口测试？

• 接口测试介于单元测试与系统测试之间，单元测试一般由开发完成（不要相信开发）；
• 接口是各种系统功能的基础，一旦接口出现问题可能会引起许多系统功能的问题并且不容易定位；
• 开展接口测试可以及早发现问题，有效降低测试成本；
• 接口一般较UI相对稳定，利于进行自动化和持续集成。

2）接口测试都测什么？

• 手工测试岗：先提测接口再提出功能，兼做接口自动化
• 服务端测试岗：梳理代码，审核接口实现逻辑是否与业务设计一致，技术实现逻辑的合理性，异常流测试，接口压测及安全性测试
• 测试开发 岗：专职做接口（或UI）的自动化用例开发，测试工具开发

3）怎样掌握接口测试？

1. 了解OSI网络模型，TCP/UDP协议，掌握HTTP/HTTPS协议，了解RPC, Web Service及REST，理解Session和Cookie
2. 掌握常用的接口测试工具如curl命令,Postman,Jmeter,LR,SoupUI,AB等
3. 掌握基本的抓包工具如Chrome开发者工具,Fiddler,Charles,Wireshark,tcpdumps等
4. 掌握一门编程语言Python或Java
5. 了解Nginx, Apache, Tomcat等服务器中间件
6. 掌握数据库基本查询命令，及一些NoSQL(如Redis)操作，用于检查响应结果
7. 掌握基本的Linux日子查询和筛选命令

4）接口测试重难点

1. 动态变量参数化
2. 接口依赖及中间变量问题
3. 异步接口结果验证问题
4. 相应参数及嵌套很多的验证问题
5. 接口测试框架的稳定性问题
6. 资源清理问题
7. 多接口场景测试

二、网络基础知识：IP、域名、DNS及端口

1.IP地址

1）查看IP命令

• Windows: ipconfig
• Linux: ifconfig

def is_ip(ip):
    num_list = ip.split(".")
    for num in num_list:
        if not num.isdigit() or not 0 <= int(num) <=255:
            return False
    return True
print(is_ip("101.1.0.201"))

def  check_ipv4(str):
    ip = str.strip().split(".")
    return False if len(ip) != 4 or False in map(lambda x:True if x.isdigit() and 0<= int(x) <= 255 else False, ip) else True

2.端口

1）端口类型

• 公认端口：从0到1023，紧密绑定于一些服务
• 注册端口：人1024到49151，许多服务绑定这些端口，这些端口同样用于许多其它目的。
• 动态或 私有端口：从49152到65535。理论上，不应为服务分配这此端口。实际上，机器通常从1024起分配动态端口。

2）常见软件默认端口

• Apache/Nginx(HTTP服务): 80
• Tomcat: 8080
• Oracle: 1521
• MySQL: 3306
• SQL Server: 1433
• PostgreSQL: 5432
• MongoDB: 27017
• Redis: 6379
• Memcached: 11211

3）查看端口命令

• Windows: netstat -ano
• Linux: netstat -ntlp

（端口查看）

4）解决端口占用问题

• Windows: netstat -ano | findstr "8080",找到占用端口的程序的PID -> 打开任务管理器 -> 设置显示PID -> 找到并结束对于程序
• Linux: netstat -ntlp | grep "8080", 找到对应的程序 -> ps -ef | grep "程序名" 找到对于的pid -> kill 相应的id

3.域名及DNS

1）如何查看域名所对于的ip？

• Windows/Linux: ping www.baidu.com

2）DNS

三、网络基础知识：OSI七层模型及TCP协议

1.OSI七层模型

• 上三层—— 应用层，控制软件方面：

1. 应用层：文件传输，电子邮件，文件服务，虚拟终端 TFTP，HTTP，SNMP，FTP，SMTP，DNS，Telnet；
2. 表示层：数据格式化，代码转换，数据加密；
3. 会话层：解除或建立与别的接点的联系(会话)。

• 下四层---数据流层，用来管理硬件：

1. 传输层：提供端对端的接口 TCP，UDP；
2. 网络层：为数据包选择路由 IP，ICMP，RIP，OSPF，BGP，IGMP；
3. 数据链路层：传输有地址的帧以及错误检测功能 SLIP，CSLIP，PPP，ARP，RARP，MTU；
4. 物理层：以二进制数据形式在物理媒体上传输数据 ISO2110，IEEE802，IEEE802.2。

2.TCP及UDP协议

• TCP：传输控制协议
• UDP: 数据报文协议

1）TCP和UDP的区别

• UDP的特点如下：

1. 无链接；
2. UDP使用尽最大努力交付，不保证可靠性；
3. UDP是面向报文的，UDP对应用层交付下来的报文，既不合并，也不拆分，而是保留这些报文的边界。应用层交给UDP多长的报文，UDP就照样发送，即一次发送一个报文；
4. UDP没有拥塞控制；
5. UDP支持一对一、一对多、多对一和多对多的交互通信；
6. UDP的首部开销小，只有8字节。

• TCP的特点：

1. TCP是面向连接的；
2. 每条TCP连接只能用于两个断点，一对一；
3. TCP提供可靠交付的服务：连接传输数据、无差错、不丢失、不重复、并且按序到达；
4. TCP提供全双工通信；
5. 面向字节流：TCP根据对方给出的窗口和当前网络拥塞的程度来决定一个报文应该包含多少个字节。

四、HTTP协议

1.请求（Request)

（抓包请求）

GET https://www.sojson.com/open/api/weather/json.shtml?city=%E5%8C%97%E4%BA%AC HTTP/1.1
Host: www.sojson.com
Connection: keep-alive
Upgrade-Insecure-Requests: 1
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/68.0.3440.106 Safari/537.36
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,image/webp,image/apng,*/*;q=0.8
Accept-Encoding: gzip, deflate
Accept-Language: zh-CN,zh;q=0.9,en-US;q=0.8,en;q=0.7
Cookie: __cfduid=dccd65c484a7657b468327b66023fefc41534934250; yjs_id=59d1c42afa817b578b4b562d1f72651f; ctrl_time=1

• 第1行： 请求方法 接口地址 HTTP协议版本；
• 第2-N行：请求headers(如果有Cookie，最后一行为Cookie)；
• 空一行；
• 请求数据（POST等方法使用，此处为空）。

POST http://openapi.tuling123.com/openapi/api/v2 HTTP/1.1
Content-Type: application/json
cache-control: no-cache
Postman-Token: 1a39439e-61c8-4e59-82a1-736a362c5962
User-Agent: PostmanRuntime/7.2.0
Accept: */*
Host: openapi.tuling123.com
accept-encoding: gzip, deflate
content-length: 468
Connection: keep-alive
{
	"reqType":0,
    "perception": {
        "inputText": {
            "text": "附近的酒店"
        },
        "inputImage": {
            "url": "imageUrl"
        },
        "selfInfo": {
            "location": {
                "city": "北京",
                "province": "北京",
                "street": "信息路"
            }
        }
    },
    "userInfo": {
        "apiKey": "ec961279f453459b9248f0aeb6600bbe",
        "userId": "206379"
    }
}

2.URL

1）URL组成格式：

协议\\: 服务器地址:端口号\资源路径?参数1=值1&参数2=值2

2）URL编码：

3.请求方法

1）GET请求和POST请求的区别：

• GET请求：

1. GET请求可被缓存；
2. GET请求保留在浏览器历史记录中；
3. GET请求可被收藏为书签；
4. GET请求不应在处理敏感数据时使用；
5. GET请求有长度限制；
6. GET请求只应当用于取回数据。

• POST请求：

1. POST请求不会被缓存；
2. POST请求不会保留在浏览器历史记录中；
3. POST不能被收藏为书签；
4. POST请求对数据长度没有要求。

4.请求参数（URL参数）

• 中的city=北京 ,向接口传递一个参数“city”,参数值为“北京”
• 不同的参数之间用&隔开，非ASCII码参数会自动url encode

5.请求Headers（请求头）

6.请求数据(又称为Request Body 或 Data)

1）请求数据类型（Content-Type）

• application/x-www-form-urlencoded：网页表单格式（默认）；
• application/json：REST接口常用格式；
• text/xml：xml格式，RPC接口，Dubbo接口常用格式；
• test/html：html格式；
• multipart/form-data：混合表单，支持上传图片。

2）数据编码

• ASCII码：单字节，美国信息交换标准码, 包含数字，字母，英文标点及一些控制字符；
• ISO-8859-1：又称Latin1，单字节，向下兼容ASCII，用于支持部分于欧洲使用的语言；
• ANSI编码：单字节表示英文，双字节表示汉字，对ASCII的扩展，不同的国家和地区制定了不同的标准，中文中的GBK,GB2312属于ANSI编码；
• Unicode编码：采用二个字节编码（英文和中文的字符都以双字节存放），与ANSI码不兼容；
• UTF-8：是目前互联网上使用最广泛的一种Unicode 编码方式，又称万国码。
• Base64：一种用64个字符来表示任意二进制数据的方法。

3)Base64编码的作用：

由于某些系统中只能使用ASCII字符。Base64就是用来将非ASCII字符的数据转换成ASCII字符的一种方法。而且base64特别适合在http，mime协议下快速传输数据。

（Base64在接口中的的使用）

7.响应（Response)

接口返回的信息，包含HTTP状态码，响应头和相应信息。

HTTP/1.1 200 OK
Date: Thu, 23 Aug 2018 06:32:26 GMT
Transfer-Encoding: chunked
Connection: keep-alive
{"intent":{"actionName":"","code":10005,"intentName":"","parameters":{"lon":"","checkout_date":"2018-08-25","star":"0","city":"北京","days":"1","order":"","price_range":"","nearby_place":"酒店","brand":"","checkin_date":"2018-08-24","place":"信息路","lat":"","needgeo":"0"}},"results":[{"groupType":1,"resultType":"url","values":{"url":"http://m.elong.com/hotel/0101/nlist/#indate=2018-08-24&outdate=2018-08-25&keywords=%E4%BF%A1%E6%81%AF%E8%B7%AF"}},{"groupType":1,"resultType":"text","values":{"text":"亲，已帮你找到相关酒店信息"}}]}

1）常见的响应格式：

• html
• json
• xml

2）响应编码：

有时需要根据不同的编码来正确解析响应内容。

8.HTTP状态码

• 1** 信息，服务器收到请求，需要请求者继续执行操作；
• 2** 成功，操作被成功接收并处理；
• 3** 重定向，需要进一步的操作以完成请求；
• 4** 客户端错误，请求包含语法错误或无法完成请求；
• 5** 服务器错误，服务器在处理请求的过程中发生了错误。

1）常见HTTP响应码

• 200： 成功
• 301/302： 请求重定向到另外一个接口
• 400：请求语法错误
• 403：资源没有访问权限
• 404：资源不存在（有可能是请求url错误或参数不正确）
• 405：请求方法不被允许（比如接口只允许Post,使用Get请求接口）
• 500：服务器内部错误（通常是服务器挂了或接口Bug)
• 502：网关失效
• 504：网关请求超时

9.HTTP与HTTPS

1）HTTPS和HTTP的区别

• HTTPS协议需要到ca申请证书，一般免费证书较少，因而需要一定费用；
• HTTP是超文本传输协议，信息是明文传输，HTTPS则是具有安全性的SSL加密传输协议；
• HTTP和HTTPS使用的是完全不同的连接方式，用的端口也不一样，前者是80，后者是443；
• HTTP的连接很简单，是无状态的；HTTPS协议是由HTTP+SSL协议构建的可进行加密传输、身份认证的网络协议，比HTTP协议安全。

10.Cookie和Session

• **Cookie/Cookies**是指某些网站为了辨别用户身份、进行session跟踪而储存在用户本地终端上的数据（通常经过加密）；
• Session：服务端为客户端访问所建立和维持的会话，通常会生成一个唯一的id，会话有一定的有效期；

1）比较流行的做法是：

• 用户访问时服务端建立会话（Session）；
• 将会话id（Session ID）随响应返回，并保存在客户端的Cookies里；
• 后续的访问中，服务器通过辨识，客户端请求时携带的Cookies内容来识别用户。

（用户首次访问服务器向客户端设置Cookie）

（后续访问时携带Cookie）

2）Cookie和Session的区别：

• cookie是存在客户端（浏览器）的进程内存中和客户端所在的机器硬盘上；
• cookie只能能够存储少量文本，大概4K大小；
• cookie是不能在不同浏览器之间共享；
• Session存在服务器端，存在网站进程的内存中；
• Session在初次设置session的时候，会在session池中实例化一个session对象，以sessionid 的值作为key，同时会将key以cookie的形式保存到客户端的内存中；
• Session的作用域只存在当前浏览器的会话中，当浏览器关闭以后就会将sessionid丢失，但是服务器的Session对象要20分钟以后才会回收。

11.授权与加密

1）常见的接口安全策略：

• Session/Cookie机制： 即需要登录，登录后可访问各个接口，最常用的一种策略，适用于内部接口。
• 固定appid模 式： 用户注册时会生成一个唯一的appid，用户调用接口时需要携带appid，适用于公开接口，安全性较差。
• 动态token模式： token即身份令牌，用户访问接口需要使用个人appid临时申请一个token，token有一定有效期，适用于公开接口，安全性较appid模式好。
• 开放协 议： Basic Auth/ Oauth1.0 / Oauth2.0: 适用于开放接口。
• 数字签名： 将所有请求参数及参数值进行排列拼接，加上用户私钥，再进行Md5或其他加密生成一个请求的签名（sign）,请求是需要携带签名，服务器收到请求后，会对请求重新计算签名并核实与请求所携带签名是否一致。安全性较高，可以有效防止请求被篡改。适用于内部接口及微服务接口。

2）常见的加密算法：

在接口数据传输过程中常对一些敏感数据（如密码）进行Base64编码或MD5加密，以增加安全性。加密算法分为对称式加密算法和非对称式加密算法，对称式加解密使用同一个秘钥，非对称式使用不同的秘钥。

• 对称式加密

1. DES：数据加密标准，速度较快，适用于加密大量数据的场合；
2. AES：高级加密标准，速度快，安全级别高。

• 非对称式加密

1. RSA：是一个支持变长密钥的公共密钥算法， 分公钥和私钥，SSH协议使用该算法；
2. MD5：最常用的一种加密方法，是一种摘要算法。

12.缓存

1）接口测试中缓存相关注意点

• 在更新或调试接口是，注意是否需要清理缓存（或临时禁用缓存）；
• 缓存有一定的有效期；
• 接口性能测试中会关注缓存的命中率。