🌐 什么是 API？

一、API 是什么？

API 是 Application Programming Interface（应用程序编程接口） 的缩写。

通俗解释：

API 就像是不同软件系统之间沟通的“桥梁”或“服务员”。
它让程序员可以不用了解软件内部的实现细节，就能使用某些功能或数据。

类比理解：

• API 像餐厅菜单：
  你在菜单（API）上选择要的菜（功能），然后厨房（系统内部）完成制作，最后服务员（API）将结果给你。

• API 像电源插座：
  你把设备插上去（调用 API），它帮你接通电（系统资源），你不需要知道电厂怎么发电（底层实现）。

---

二、API 的分类

根据使用方式不同，API 可以分为以下几种：

类型	描述	示例
本地 API（Library API）	操作系统或程序内部模块之间的接口	Windows API, C++ STL
Web API（最常用）	基于网络，通过 HTTP 协议进行通信的接口	微信小程序接口，GitHub API
开放 API（Open API）	公开给所有开发者使用的 API	天气查询 API、百度地图 API
私有 API	内部系统或团队私有使用	公司内部业务服务接口

---

三、Web API 详解（重点）

1. 工作原理

一个 Web API 通常基于 客户端-服务器模型：

[客户端浏览器/程序] ——> 发出 HTTP 请求 ——> [API 服务器]
                              |
[客户端浏览器/程序] <—— 返回 JSON/XML 数据 <——

2. 常见协议和格式

• 协议：HTTP 或 HTTPS

• 常见请求方法（HTTP Methods）：

  方法	含义	说明
  GET	获取资源	查询数据（如获取用户信息）
  POST	创建资源	提交数据（如新建订单）
  PUT	更新资源	修改数据（如更新用户资料）
  DELETE	删除资源	删除数据（如注销账户）

• 数据格式：

  • JSON（最常用）：轻量、可读性强
  • XML：传统格式，现在较少使用

---

四、一个简单的 API 示例

假设我们要使用一个天气 API，查询某城市的天气。

请求示例（GET）：

GET https://api.weatherapi.com/v1/current.json?key=你的API密钥&q=Beijing

返回结果（JSON）：

{
  "location": {
    "name": "Beijing",
    "country": "China"
  },
  "current": {
    "temp_c": 30.2,
    "condition": {
      "text": "Sunny"
    }
  }
}

你就可以拿这些数据在自己的网页或程序中展示天气情况了。

---

五、如何使用 API？（从小白到动手）

Step 1：获取 API 文档

几乎所有公开 API 都会有官方文档，介绍如何调用、参数说明、响应示例等。

Step 2：申请 API Key（如果需要）

一些服务要求你注册账号，获取密钥用于身份验证。

Step 3：发起请求（可以用工具或代码）

推荐工具：

• Postman（图形界面，适合测试）
• curl（命令行）
• 浏览器（适合 GET 请求）

示例代码（Python）：

import requests

url = "https://api.weatherapi.com/v1/current.json"
params = {
    "key": "你的API密钥",
    "q": "Beijing"
}

response = requests.get(url, params=params)
data = response.json()
print(data["current"]["temp_c"])

---

六、API 的优势

优势	说明
模块化	系统之间松耦合，便于维护
重用性	不必重复造轮子，调用已有服务
自动化	机器可调用，实现自动处理流程
跨平台	不同平台之间轻松通信

---

七、学习建议

学习方向	推荐工具 / 资源
基础理解	菜鸟教程、MDN、w3school
实践操作	Postman、curl、Python requests
持续进阶	使用 GitHub API、微信开发者平台、OpenAI API 等真实案例练习

---

八、常见术语解释

术语	解释
Endpoint	API 的一个具体接口地址
Header	HTTP 请求头信息，如身份认证信息
Status Code	HTTP 返回状态码，如 200（成功）、404（未找到）
Rate Limit	限流，API 通常限制单位时间内的访问次数
RESTful	一种 API 设计风格，基于资源和 HTTP 方法

---

九、总结一句话

API 是现代程序交流的语言，是你调用“外部服务”的钥匙。
掌握 API，等于你能把自己的程序连接到整个互联网的智慧和能力上。