在Python开发中调用第三方API并正确处理返回响应是常见需求，Mouser API作为电子元器件数据查询的重要接口，很多开发者都需要掌握其调用方法。本文将以Mouser API为例，详细介绍Python中调用API的完整流程，包括请求参数构造、请求发送、响应解析以及常见错误处理方案。
调用Mouser API前的准备
在使用Mouser API之前，需要先完成两个基础准备工作，否则无法成功发起有效请求。
- 注册Mouser开发者账号，申请专属的API密钥，这是请求鉴权的核心凭证
- 明确需要调用的API端点地址和请求参数要求，不同功能的端点参数存在差异
Python中发送API请求的实现
Python中常用的HTTP请求库是requests，它语法简洁且功能完善，适合处理各类API请求场景。首先需要通过包管理工具安装该库：
pip install requests
以下是调用Mouser API查询元器件信息的基础代码示例，包含请求头设置、参数传递和请求发送的完整逻辑：
import requests
# 替换为自己的Mouser API密钥
API_KEY = "your_mouser_api_key"
# Mouser元器件搜索端点地址
ENDPOINT = "https://api.mouser.com/api/v1/search/part"
# 要查询的元器件型号
PART_NUMBER = "STM32F103C8T6"
# 构造请求头，包含鉴权信息和内容类型
headers = {
"Authorization": f"Bearer {API_KEY}",
"Content-Type": "application/json"
}
# 构造请求参数
params = {
"partNumber": PART_NUMBER,
"includeDatasheets": "true"
}
# 发送GET请求
response = requests.get(ENDPOINT, headers=headers, params=params)
API响应的处理步骤
获取到API响应后，不能直接使用返回的原始数据，需要按照规范逐步处理，确保数据的可用性和程序的健壮性。
1. 状态码判断
首先需要检查响应的状态码，Mouser API返回200表示请求成功，其他状态码都代表请求存在问题。常见状态码含义如下：
| 状态码 | 含义 |
|---|---|
| 200 | 请求成功，响应包含有效数据 |
| 400 | 请求参数错误，需要检查传递的参数格式和内容 |
| 401 | 鉴权失败，通常是API密钥无效或过期 |
| 429 | 请求频率超限，需要降低请求速率 |
2. JSON数据解析
Mouser API的响应数据默认是JSON格式，需要先将其转换为Python字典再进行操作，同时要做好异常捕获，避免响应不是合法JSON导致的程序崩溃。
try:
# 将响应内容解析为JSON字典
response_data = response.json()
# 判断请求是否成功
if response.status_code == 200:
print("请求成功，获取到元器件数据")
# 提取返回的数据列表
parts = response_data.get("Parts", [])
if parts:
# 打印第一个元器件的基础信息
first_part = parts[0]
print(f"元器件型号：{first_part.get('ManufacturerPartNumber')}")
print(f"制造商：{first_part.get('Manufacturer')}")
print(f"库存数量：{first_part.get('Availability')}")
else:
print("未查询到匹配的元器件信息")
else:
print(f"请求失败，状态码：{response.status_code}，错误信息：{response_data.get('Message')}")
except ValueError as e:
print(f"响应内容不是合法的JSON格式，错误：{e}")
print(f"原始响应内容：{response.text}")
3. 异常情况处理
除了响应本身的错误，还需要处理请求过程中可能出现的网络异常，比如连接超时、网络不通等情况，避免程序直接崩溃。
import requests.exceptions
try:
response = requests.get(ENDPOINT, headers=headers, params=params, timeout=10)
except requests.exceptions.Timeout:
print("请求超时，请检查网络或稍后重试")
except requests.exceptions.ConnectionError:
print("网络连接失败，请检查网络状态")
except requests.exceptions.RequestException as e:
print(f"请求发生未知错误：{e}")
常见问题与注意事项
在实际调用Mouser API的过程中，开发者经常会遇到一些问题，以下是几个需要注意的点：
- API密钥不要硬编码在代码中，建议通过环境变量或配置文件的方式读取，避免密钥泄露
- Mouser API有请求频率限制，不要短时间内发送大量请求，否则会被暂时封禁访问权限
- 响应中的部分字段可能为空，解析数据时使用
get()方法而不是直接通过键访问，避免抛出键不存在的异常 - 如果返回的数据量较大，可以考虑分页处理，避免一次性加载过多数据导致内存占用过高
调用第三方API时，始终要做好完整的错误处理，不能只假设请求一定会成功，这样才能保证程序的稳定性和可靠性。
PythonAPI调用Mouser_API响应处理修改时间：2026-06-28 15:36:41