Python 教程 / 请求 HTTP API 并验证 JSON 响应
HTTP API 接收请求并返回状态与数据。Python 客户端应分别检查 HTTP 结果、网络等待、响应大小、JSON 解析和业务结构;成功收到一个响应,不等于其中的金额可以直接信任。
区分协议、地址与数据格式
HTTP(Hypertext Transfer Protocol,超文本传输协议)规定请求和响应方式,URL 指定资源位置,JSON 则只是正文可能采用的一种格式。实际外部服务还需遵循其 HTTPS、身份验证、配额与使用规则;本练习只用自己可控制的本地响应,不依赖外部服务变化。
客户端接口见Python 官方 urllib.request 文档,数据结构基础可结合JSON 转换与验证理解。这里的临时服务器用于学习客户端流程,不是生产部署方案。
保存测试数据并启动本机服务器
新建独立练习目录,把以下完整 JSON 保存为 UTF-8 文件 expenses.json,不要在包含凭据或私人文件的目录启动练习服务器:
[{"id":"e1","name":"coffee","amount":3500},{"id":"e2","name":"lunch","amount":8000}]
在第一个终端进入此目录,选择项目解释器,执行:
python -m http.server 8000 --bind 127.0.0.1
绑定 127.0.0.1 表示仅本机访问。若 8000 已占用,选择空闲端口并同步改下面客户端 URL。服务启动后会占用这个终端直到停止;请保持它运行,再打开第二个终端。需要帮助核对路径时参见工作目录与文件位置。
此命令会提供当前目录的文件访问,不是仅提供一个 JSON 文件。始终在专用目录使用并保持本机绑定;测试结束用 Ctrl+C 停止。相关用途与限制见Python 官方 http.server 说明。
运行完整客户端并检查合计
将完整代码以 UTF-8 保存为 fetch_expenses.py:
import json
import sys
from urllib.request import urlopen
from urllib.error import HTTPError, URLError
url = sys.argv[1]
try:
with urlopen(url, timeout=5) as response:
if response.status != 200:
raise ValueError("unexpected status")
raw = response.read(1_000_001)
if len(raw) > 1_000_000:
raise ValueError("response too large")
data = json.loads(raw.decode("utf-8"))
except (HTTPError, URLError, TimeoutError, UnicodeError, ValueError) as error:
raise SystemExit(f"request failed: {type(error).__name__}")
if not isinstance(data, list):
raise SystemExit("expected a list")
total = 0
for row in data:
if not isinstance(row, dict) or type(row.get("amount")) is not int or row["amount"] < 0:
raise SystemExit("invalid record")
total += row["amount"]
print("records:", len(data))
print("total:", total)
在选择了同一项目环境的第二个终端运行,必须提供 URL 参数:
python fetch_expenses.py http://127.0.0.1:8000/expenses.json
正常输出为 records: 2 和 total: 11500。前者是记录数,后者是金额合计。本例只用标准库;若实际解释器命令是 python3,则在两个终端一致替换命令名称。
客户端要求状态为 200,最多读入 1,000,001 字节以判定是否超过 1,000,000 字节上限。随后按 UTF-8 解码并解析 JSON,再要求顶层为列表、每项为字典,且 amount 恰为非负整数;布尔值被排除。它没有验证 id 或 name 的业务规则,不应当作完整记录验证器。
请求或解析失败会显示 request failed 及异常类名,并以失败状态结束;结构检查分别提示 expected a list 或 invalid record。这里不把失败替换为空列表继续输出“正常合计”。
分别测试网络失败与数据失败
HTTPError 表示服务器返回错误 HTTP 状态,它也是 URLError 的子类;URLError 还可表示连接、解析地址等问题。正文收到后也可能存在无效 UTF-8、非法 JSON、过大响应或字段错误,层次不同。异常定义见Python 官方 urllib.error 文档。
- 只把请求 URL 的文件名改成一个不存在的名称,应得到 request failed: HTTPError,表示服务器可达但资源请求失败。
- 恢复 URL,在 expenses.json 中将一个 amount 改成字符串 "3500",再次请求应得到 invalid record。这里服务器只读取文件,不会像生成脚本那样每次请求前重写样例。
- 恢复原始 JSON,再次确认 records: 2 与 total: 11500。随后在服务器终端按 Ctrl+C,重新请求应得到连接失败提示,通常为 request failed: URLError。
timeout=5 限制个别阻塞等待,不是整个请求、读取与解析过程的统一绝对截止时间。该示例也不声称处理所有可能的断线、协议异常或重定向政策。扩展客户端时应根据实际协议设计错误边界和总时间预算。
增加重试前,明确次数、间隔和操作是否可安全重复;带写入副作用的请求不能盲目重发。真实服务的令牌按其规定管理,不要直接放在源码、公开 URL 或日志中。测试结束后确认本地服务器已停止,再处理实习数据。




