接口、API、接口文档,一次全部讲明白!

很多刚入门做测试的小伙伴，第一步就被一堆名词卡住了：

到底什么是接口？API 和接口是一回事吗？接口文档该怎么看？

还有 HTTP、HTTPS、请求头、参数、状态码……一堆陌生术语，越看越懵。

很多人接口测试学不会，不是不会工具，而是基础概念没打通。

今天这篇，专门给零基础小白讲透接口核心基础，不讲废话、不堆公式，全程通俗大白话，帮你彻底扫清术语障碍，打好接口测试的地基！

一、先搞懂3个核心名词：接口 / API / 接口文档

这三个词是接口测试的基石，90%的新手混淆都出在这里。

1、什么是接口？

一句话定义：两个系统之间传输数据的“通道/窗口”。

生活化类比：小区快递收发窗口。

楼栋和快递站是两个独立区域，快递不能随便穿墙进来，只能通过收发窗口进出。

接口的作用也是如此：

手机APP 和后端服务器互不直接连通
所有数据（登录、查数据、下单、传图片）全部通过接口传输

没有接口，前后端数据就无法互通，软件就无法正常使用。

2、什么是 API？

API 全称：应用程序编程接口。

通俗理解：标准化、可以被代码调用的接口。

简单区分：

接口：是统称（泛指数据通道）
API：是行业规范化的接口，是可以被程序直接调用的标准接口

在测试日常工作中，接口≈ API，两个名词可以直接混用，不用过度纠结细微区别。

3、什么是接口文档？

接口的官方使用说明书。

由后端开发编写，清晰记录每一个接口的调用规则，是前端、测试、开发统一的对接标准。

它会写清楚：

这个接口用来干什么
地址是什么、用什么方式请求
需要传哪些参数、哪些必填
成功/失败会返回什么数据

做接口测试，99%的依据就是接口文档。看不懂文档，就没法做接口测试。

二、HTTP / HTTPS 到底有什么区别？

绝大部分互联网接口，都是基于 HTTP/HTTPS 协议传输数据。

协议，通俗说就是：客户端和服务器的对话规则。

1、HTTP 协议

明文传输，数据裸奔。

类比：写在明信片上的内容，任何人都能看见、篡改。

优点：速度快、简单；缺点：极度不安全。

所以正式项目的生产环境，基本不会用 HTTP。

2、HTTPS 协议

HTTP +加密，是 HTTP 的安全升级版。

类比：密封信封+加密信件，只有收发双方可以解密查看，第三方无法窃取、篡改数据。

所有正规网站、APP接口，统一使用HTTPS，也是我们测试工作中接触最多的协议。

通用通信流程（必记）

客户端发请求 → 服务器接收并处理 → 服务器返回响应数据

三、接口完整结构拆解，新手一看就懂

我们以一个生活化的查询城市天气接口举例：

https://api.weather.com/getWeather?city=北京

一个完整的接口，由 5 大核心部分组成。

1、请求 URL：接口的唯一地址

相当于服务器的精准收货地址，只有地址正确，才能找到对应的接口、拿到数据。

标准格式：协议+域名+接口路径

2、请求方式：告诉服务器你要做什么

日常测试最常用 5 种，直接记场景即可：

GET：查询数据（查天气、查用户列表、查订单）✅ 只查不改，只读不写
POST：新增数据（注册账号、提交表单、创建订单）✅ 新增一条全新数据
PUT：全量修改数据（完整替换用户信息）✅ 覆盖更新所有内容
PATCH：局部修改数据（只改手机号、只改密码）✅ 只更新个别字段，更轻量
DELETE：删除数据（删除订单、删除收藏）✅ 删掉整条数据记录

3、请求头 Header：请求的附加身份说明

可以理解为：寄件备注+身份凭证。

请求头里会携带很多关键信息，测试高频重点字段：

Content-Type：告诉服务器，我传的参数是什么格式（JSON/表单等）
Token：用户登录令牌，相当于通行证，没 Token 无法访问需要登录的接口
User-Agent：标识客户端类型（手机/电脑/浏览器）

4、请求参数：你发给服务器的条件数据

参数就是你想让服务器帮你处理的条件，也是接口测试的核心重点，分为3类：

查询参数：URL 问号后面的内容，如 ?city=北京
路径参数：拼接在 URL 路径中，如 /user/1001，1001是用户ID
请求体参数：POST/PUT 专用，放在请求体内，适合传账号密码、表单、批量数据

5、响应数据 + 状态码：服务器给你的结果

① 响应数据

服务器处理完请求后，返回给客户端的结果，工作中99%都是JSON格式（键值对格式，清晰易懂）。

示例：

{ "code":200, "msg":"查询成功", "data":{"weather":"晴","temp":"26℃"} }

② HTTP 状态码（统一标准）

快速判断请求结果，记住这套通用规则即可：

2xx 成功：200 请求一切正常
3xx 重定向：301 页面/接口永久跳转
4xx 客户端错误：404地址不存在、401未登录、403权限不足
5xx 服务端错误：500代码异常、503服务器不可用

重点区分：HTTP状态码是通用网络状态；响应里的 code 是后端自定义业务码，用来判断业务是否执行成功，二者完全不同！

四、手把手教你读懂一份接口文档

看完上面的知识点，我们直接用一份真实简易接口文档，实操阅读一遍。

【接口示例】获取城市天气信息

接口名称：获取城市天气请求地址：https://api.weather.com/getWeather请求方式：GET请求参数：city（必填、字符串、城市名称）成功返回：{"code":200,"msg":"查询成功","data":{"weather":"晴"}}失败返回：{"code":400,"msg":"城市名称不能为空"}}

小白标准阅读步骤：

1.先看请求地址+请求方式：确定怎么调、去哪里调

2.再看请求参数：分清必填/非必填、参数类型，明确传参规则

3.查看返回示例：熟知成功、失败的返回格式和提示信息

4.根据文档规则，设计测试用例、开展接口测试

五、本篇总结：你能收获什么？

看完这篇，彻底告别接口测试入门懵圈状态：

✅ 分清接口、API、接口文档的核心区别与作用
✅ 吃透 HTTP/HTTPS 协议差异，理解数据通信逻辑
✅ 精通接口五大核心组成（URL/请求方式/请求头/参数/响应）
✅ 独立读懂基础接口文档，扫清入门术语障碍

这是接口测试最核心的理论地基，地基打牢，后续 Postman 实操、接口用例设计、接口自动化都会事半功倍！

下期预告：下一篇带你上手 Postman 工具，从零实操调用第一个接口，理论落地实操！

喜欢记得点赞、在看、关注【测试有方】，持续更新零基础测试干货！