API 接口（Endpoint）

一句话：前后端约定好的一个网络地址，前端按这个地址发请求，后端在这里接收处理并返回数据。

它是什么

API接口（Endpoint）就是一个具体的URL加上请求方法（GET/POST等），代表后端提供的某一项具体功能，比如 GET /api/users 获取用户列表，POST /api/orders 创建订单。前后端约定好接口的地址、参数格式、返回格式，就能各自独立开发再对接。

适合干什么

• 前后端分离项目的接口设计和联调
• 对接第三方服务的API文档阅读

不适合干什么

• 纯静态网站没有任何动态数据交互的场景（不需要设计接口）

普通人怎么用

看接口文档时重点关注：请求地址、请求方法（GET查询/POST新建/PUT更新/DELETE删除）、需要传什么参数、会返回什么格式的数据；调试时用Postman这类工具单独测试接口，不用每次都通过完整页面操作触发。

进阶用户怎么用

接口设计要考虑版本管理（如/api/v1/users，方便未来升级不破坏旧版本兼容性）、统一的错误返回格式、合理的权限校验；避免一个接口塞太多逻辑，保持职责单一。

常见误区

• 把GET和POST搞混，比如用GET传敏感数据（GET参数会出现在URL里，不适合传密码等敏感信息）
• 接口报错时只看状态码不看具体错误信息，其实大多数API会在返回内容里包含更详细的错误说明

和相似工具的区别

• 和Webhook的区别：普通API接口是你主动去请求获取/提交数据，Webhook是对方主动在事件发生时推送数据给你的接口

入门步骤

• 明确要提供什么功能，设计对应的URL和请求方法
• 定义清楚请求参数和返回数据格式
• 用Postman等工具测试接口是否按预期工作