Python与API - 技术栈

一、课程整体定位

这门课是 Python 进阶内容的延续，核心是教你：

用 Python 的requests库调用外部 API 获取数据
解决调用 API 时遇到的常见错误，掌握调试方法
学会一些命令行快捷指令，提升操作效率

二、核心概念：API 是什么？

老师用了两个非常形象的比喻：

1. 生活化比喻

场景：你想查明天的天气（这是你的「需求」）
你：用户 / 程序员
手机 App：你的 Python 代码
API：餐厅里的「服务员」------ 你不用直接跑到气象局的服务器（后厨）去拿数据，只需要告诉服务员（API）你的需求（查北京天气），服务员会帮你传递请求、拿回结果（天气数据）。

2. 技术层面解释

API（应用程序编程接口）是不同软件之间沟通的「桥梁」：

你的 Python 代码（客户端） → 发送请求 → 第三方服务器（如和风天气服务器）
第三方服务器 → 处理请求 → 返回数据（如 JSON 格式的天气信息） → 你的 Python 代码
整个过程不需要你了解服务器内部怎么运行，只需要按规则「发请求、收数据」就行。

三、核心工具：requests 库

1. 作用

requests是 Python 的一个第三方库，专门用来帮你：

向指定的网址（API 地址）发送「请求」（比如查天气的请求）
接收服务器返回的「响应」（天气数据）
解析响应数据（把服务器返回的原始数据转换成 Python 能看懂的格式）

2. 类比理解

requests库就像你派出去的「快递员」：

你（代码）告诉快递员：「去 XX 地址（API 地址）拿一个包裹（天气数据）」
快递员（requests）负责跑过去、提交你的身份信息（API 密钥）、拿到包裹
快递员把包裹带回来，你拆开（解析数据）就能用了。

四、基础准备：Python 及相关工具安装验证

这是所有操作的前提，一步都不能错，详细步骤如下：

1. Python 安装

途径 1（简单）：电脑应用商店搜索「Python」直接下载（注意选 3.8 及以上版本）
途径 2（通用） ：Python 官网（www.python.org）下载，关键注意点：✅ 下载时一定要勾选「Add Python to PATH」（把 Python 添加到系统环境变量），否则后续命令行找不到 Python。

2. 验证 Python 是否安装成功

这是课上重点强调的操作，步骤拆解：

按下键盘上的 Win键 + R键（Win 键就是带 Windows 图标的键），会弹出「运行」窗口；
在窗口里输入 python（注意小写），按回车；
如果弹出一个黑色的命令行窗口，显示类似 Python 3.10.0 (tags/v3.10.0:b494f59, Oct 6 2021, 16:50:30) [MSC v.1929 64 bit (AMD64)] on win32 的内容，说明安装成功；
如果提示「'python' 不是内部或外部命令」，就是没勾选「Add Python to PATH」，需要重新安装或手动配置环境变量。

3. 验证 pip 是否安装（包管理工具）

pip 是 Python 用来安装第三方库（比如 requests）的工具，验证步骤：

同样按 Win + R，输入 cmd 打开命令行窗口；
在命令行里输入 pip（小写），按回车；
如果显示一堆 pip 的使用说明（比如pip install <包名>），说明安装成功；
如果报错「'pip' 不是内部或外部命令」，和 Python 同理，是环境变量没配好。

五、进阶准备：Python 虚拟环境创建

1. 为什么要创建虚拟环境？

不同的 Python 项目可能需要不同版本的库（比如 A 项目要 requests 2.25，B 项目要 requests 3.0）；
虚拟环境可以给每个项目「隔离」出独立的环境，避免库版本冲突，就像给每个项目建了一个独立的「房间」。

2. 创建虚拟环境的详细步骤

课上老师讲的步骤拆解（Windows 系统）：

步骤 1：新建文件夹（存放项目）

在电脑任意位置（比如桌面）右键 → 新建 → 文件夹，命名为「Python_API_Study」（英文名，避免中文报错）。

步骤 2：打开命令行并进入该文件夹

Win + R 输入 cmd 打开命令行；
输入 cd 文件夹路径（比如 cd C:\Users\你的名字\Desktop\Python_API_Study），按回车；✅ 验证：输入 dir 按回车，能看到文件夹里的内容（刚建的文件夹是空的，会显示「文件列表为空」），说明进入成功。

步骤 3：创建虚拟环境

在命令行输入以下命令，按回车：

复制代码

# 创建名为「venv」的虚拟环境（venv是通用命名，也可以改其他名字）
python -m venv venv

执行后，你的「Python_API_Study」文件夹里会多出一个「venv」文件夹，里面包含了虚拟环境的所有文件（编译器、库目录等）。

步骤 4：激活虚拟环境（课上老师说会发截图，这里补充完整指令）

在命令行输入：

复制代码

# Windows系统激活指令
venv\Scripts\activate

激活成功后，命令行开头会出现 (venv)，说明你已经进入虚拟环境了；
后续安装的所有库（比如 requests）都会只装在这个虚拟环境里，不影响电脑全局的 Python。

步骤 5：退出虚拟环境

在命令行输入：

复制代码

deactivate

输入后，命令行开头的 (venv) 会消失，回到全局环境。

六、核心操作：API 调用的完整步骤

这是课程的核心，老师拆解成 4 个关键步骤，每个步骤都讲清楚：

步骤 1：申请 API 密钥（API Key）

为什么需要：API 相当于服务器给你的「访问权限」，多数正规 API 都需要验证身份，避免恶意调用；
举例：比如用「和风天气 API」查天气，需要先在和风天气官网注册账号，创建一个项目，系统会生成一个唯一的「API Key」（一串字符串）；
注意：这个 Key 是你的「身份凭证」，不要随便泄露给别人。

步骤 2：明确 API 的请求地址（URL）

API 的请求地址分两部分：
1. 通用基础地址 ：比如和风天气的实时天气 API 基础地址是 https://devapi.qweather.com/v7/weather/now；
2. 个性化内容：需要拼接在基础地址后面，比如指定查询的城市、带上你的 API Key；
- 最终完整地址示例：https://devapi.qweather.com/v7/weather/now?location=116.41,39.92&key=你的APIKey（location 是经纬度，对应北京）。

步骤 3：设置请求参数

参数是你告诉 API「具体要什么数据」的关键，比如：
- location：查询的城市（可以是城市名、经纬度、城市 ID）；
- key：你的 API 密钥；
- 不同 API 的参数不同，一定要看服务商的「操作手册 / 文档」（比如和风天气的 API 文档会列所有可选参数）。

步骤 4：错误处理（重点）

调用 API 时一定会遇到失败的情况，比如：
1. API Key 输错了 → 服务器返回「权限错误」；
2. 网络断了 → 代码报错「连接超时」；
3. 参数写错（比如城市名输成「北亰」）→ 服务器返回「参数无效」；

课程后续会教你用 Python 的「异常捕获」（try-except）来处理这些错误，比如：

复制代码

import requests

try:
    # 发送API请求
    response = requests.get("https://devapi.qweather.com/v7/weather/now?location=116.41,39.92&key=你的APIKey")
    # 如果返回错误状态码，主动抛出异常
    response.raise_for_status()
    # 解析数据
    data = response.json()
    print("天气数据：", data)
except requests.exceptions.RequestException as e:
    # 捕获所有请求相关的错误，并提示用户
    print("API调用失败：", str(e))
    print("请检查：1.API Key是否正确 2.网络是否正常 3.参数是否正确")

七、课上提到的「任务 / 资料」说明

这些是你后续需要实操的内容，对应知识点：

验证 Python 安装的笔记：就是上面「四、2」的步骤，用来确认你的 Python 环境没问题；
虚拟环境指令截图：对应「五、2」的激活 / 退出指令，后续要动手练；

打印网页状态码的代码 ：状态码是服务器返回的「结果提示」（比如 200 = 成功，404 = 地址错，401 = 权限错），示例代码：

复制代码

import requests

# 测试用的网址（比如百度）
url = "https://www.baidu.com"
# 发送请求
response = requests.get(url)
# 打印状态码
print("网页状态码：", response.status_code)  # 正常会输出200

总结

本次课程的核心知识点可以浓缩为 3 个关键点：

基础环境：先确保 Python/pip 安装成功，用虚拟环境隔离项目避免冲突；
核心概念：API 是软件间的「沟通桥梁」，requests 库是 Python 调用 API 的「工具」；
核心流程：调用 API 的完整步骤是「申请密钥→确定地址→设置参数→处理错误」，其中错误处理是保证代码稳定的关键。