一、什么是 API 接口
1. 通俗理解
API 全称 Application Programming Interface，应用程序编程接口。
你可以把 API 理解成系统与系统之间的 “翻译官” 和 “传话筒” 。
- 手机 APP、小程序、网站、电商系统、代购系统、京东 / 淘宝数据后台，互相不能直接硬连；
- 就靠 API 接口 按照固定格式发请求、传数据、返回结果。
2. 举个生活例子
你去餐厅点餐：
- 你是前端 / 用户系统
- 厨房是后端服务器 / 数据库
- 服务员就是 API 接口
你把需求（点餐）告诉服务员，服务员传给厨房；厨房做好再通过服务员把结果给你。没有服务员，你没法直接进厨房做菜；没有 API，两个软件就没法互相传数据。
3. 实际业务举例
- 代购系统要获取京东商品价格、标题、图片、评论，就要调用 京东商品 API；
- 网站登录时，输入账号密码点登录，就是调用登录 API，校验是否正确；
- 充值付款，调用支付 API，把金额、订单号传给支付平台，再返回支付结果；
- 识图找货、批量查商品、下单代买，全是靠一个个 API 接口完成。
4. API 工作原理
- 客户端发起请求（传参数：商品 ID、页数、关键词等）
- 接口接收请求
- 后端处理逻辑、查数据库
- 接口返回数据（一般是 JSON 格式：成功 / 失败、文字、列表、数字）
二、API 接口常见分类
- 按用途
- 商品接口：查商品详情、搜索商品、识图找货
- 订单接口：创建订单、查询订单状态、取消订单
- 用户接口：注册、登录、获取用户信息
- 支付充值接口：充值、扣款、查询余额
- 物流接口：查物流轨迹、获取运输状态
- 按开发方式最常用：HTTP/HTTPS 接口，也就是我们平时对接京东、1688、淘宝、代购系统用的接口。
三、API 接口包含哪些基本要素
做对接、做测试必须看懂这 5 个：
- 请求地址（URL） ：接口访问网址
- 请求方式：GET / POST 最常用
- 请求参数：需要传给接口的数据（商品 ID、关键词、页码、账号密码）
- 请求头（Header） ：身份验证、Token、授权密钥、内容格式
- 返回参数（响应数据） ：接口返回的结果，成功码、错误提示、商品数据、列表等
四、怎么测试 API 接口（新手可直接照着操作）
1. 常用测试工具
- Postman：最主流，专业接口测试工具
- Apifox：国产，接口文档 + 调试 + 测试一体化
- 浏览器：简单 GET 接口直接浏览器打开就能测
- JMeter：适合压力测试、高并发测试
2. 基础测试步骤（通用流程）
第一步：拿到接口文档
确认：接口地址、请求方式、必填参数、Header 密钥、返回字段说明。
第二步：配置请求信息
- 输入接口 URL
- 选择请求方式 GET / POST
- 填写 Header：填 Token、Appkey、授权信息
- 填写请求参数：商品 ID、搜索词、页数等
第三步：发送请求，查看返回结果
重点看 3 点：
- 状态码：200 = 请求成功；404 = 地址错；401 = 没授权；500 = 服务器报错
- 错误码：0000 成功、其他编码代表参数错误、权限不足、次数超限
- 返回数据：有没有商品标题、价格、图片、评论、列表是否完整
第四步：校验数据是否正确
- 参数为空时会不会报错
- 传错误商品 ID 会不会提示
- 分页是否正常
- 数据和官网京东 / 1688 是否一致
- 特殊字符、多语言（俄语 / 塔吉克语）是否乱码
3. 常见接口测试类型
- 功能测试正常传参、缺参数、错参数，看接口返回是否符合预期。
- 边界测试页数填 0、填负数、一次查最大条数、超长关键词。
- 权限测试不带 Token、错误密钥，看是否拦截拒绝访问。
- 并发 / 压力测试短时间大量调用，看接口会不会卡顿、报错、限流（适合代购、代采系统上线前）。
- 异常测试网络中断、超时、重复提交订单，看接口会不会重复下单、数据错乱。
4. 接口测试合格标准
- 正常请求能正常返回数据
- 错误参数有明确提示，不崩溃
- 数据准确，和原平台（京东 / 1688）一致
- 响应速度快，无明显延迟
- 有授权校验，防止恶意调用
- 支持多语言、特殊字符不乱码
五、总结一句话
- API 接口：就是两个系统之间传数据、做交互的通道和规则，没有接口，软件、平台、电商系统之间就无法打通数据。
- 测试接口：就是用 Postman/Apifox，填地址、填参数、发请求，看能不能通、数据对不对、异常情况稳不稳定。
