一、API 是什么
API = Application Programming Interface，应用程序编程接口 简单一句话：软件和软件之间沟通的通道 / 规则。
你可以把它理解成餐厅服务员：
- 顾客（前端 / 你的程序）不会直接进厨房（数据库 / 第三方服务）
- 服务员（API）负责传话、取菜、返回结果 没有 API，两个软件完全没法交换数据。
二、生活里的 API 例子
- 天气 APP APP 自己不存全球天气，调用气象平台 API，发送城市名，API 返回温度、降水。
- 网站微信登录 网页调用微信登录 API，跳转微信授权，API 返回你的昵称、头像。
- 支付（支付宝 / 微信支付） 商城调用支付 API，创建订单、唤起付款、同步支付结果。
- 翻译、AI 对话（我本身就是 API 服务） 程序发送文字给大模型 API，接口返回回答内容。
三、常见 API 分类
1. 按使用场景
- Web API（最常用） 通过网络请求调用，基于 HTTP/HTTPS，前后端、跨平台交互都用这个。 格式主流：JSON，少数 XML。 常见请求方式：
- GET：查询数据（查天气、查信息）
- POST：提交数据（登录、发消息、上传）
- PUT：修改数据
- DELETE：删除数据
- 系统本地 API 操作系统自带接口，比如 Windows、安卓系统 API，程序调用实现弹窗、拍照、读取文件。
- 硬件 API 控制硬件：摄像头、打印机、单片机接口。
2. 架构类型
- RESTful API：现在行业标准，简洁、易调试，互联网绝大多数接口
- RPC API：高性能内部接口（微服务之间调用，gRPC）
- GraphQL API：前端自定义需要哪些数据，减少多余传输
四、调用 API 必备要素
- 请求地址（接口 URL）
- 请求方式 GET/POST
- 请求参数（要传给接口的数据）
- 身份凭证（Token、AppKey、密钥，防止别人乱调用）
- 返回数据（JSON 格式）
极简示例（天气 API）
{
"city":"北京",
"temp":"26℃",
"weather":"晴"
}
五、相关常见名词
- 接口文档：服务商提供的说明书，写清地址、参数、返回格式
- Token：身份令牌，登录后获取，每次调用带上证明权限
- 限流：API 限制调用次数，防止滥用（比如每天 1000 次免费额度）
- SDK：官方封装好的代码包，不用自己手写网络请求，直接调用 API
- 接口测试工具：Postman、Apifox，用来调试 API
六、个人 / 开发者能用的 API
- AI 类：豆包 API、OpenAI、通义千问
- 工具类：地图、短信、OCR 文字识别、翻译
- 数据类：股票、新闻、快递查询