本文介绍了如何使用 Python 从包含嵌套字典的 JSON 数据中提取特定的图片 URL。通过 `requests` 库获取 JSON 数据，并使用 `get` 方法安全地访问嵌套字典中的目标值，避免因键不存在而导致的程序错误。本文提供了详细的代码示例和解释，帮助开发者轻松提取所需信息。
在使用 Python 处理 API 返回的 JSON 数据时，经常需要提取特定字段的值。当 JSON 数据包含嵌套的字典结构时，直接访问可能导致 KeyError 异常。本文将介绍如何安全有效地从嵌套的 JSON 字典中提取图片 URL。
假设我们已经通过 requests 库获取了 JSON 数据，并且解析后的数据存储在名为 character_data 的字典中。目标是从 character_data["decorations"]["avatarUrl"] 获取头像 URL。
以下代码展示了如何使用 get 方法安全地访问嵌套字典中的 avatarUrl：
import requests
def get_avatar_url(character_id):
"""
从 D&D Beyond API 获取角色头像 URL。
Args:
character_id (int): 角色 ID。
Returns:
str: 头像 URL，如果找不到则返回空字符串。
"""
req = requests.get(f"https://character-service.dndbeyond.com/character/v5/character/{character_id}")
if req.status_code != 200:
print(f"请求失败，状态码: {req.status_code}")
return ""
try:
j = req.json()
if not "success" in j or not "data" in j:
print("JSON 数据格式不正确")
return ""
character_data = j["data"]
avatar_url = character_data.get("decorations", {}).get("avatarUrl", "")
return avatar_url
except ValueError as e:
print(f"JSON 解析失败: {e}")
return ""
# 示例用法
character_id = 108291017 # 替换为实际的角色 ID
avatar_url = get_avatar_url(character_id)
if avatar_url:
print(f"头像 URL: {avatar_url}")
else:
print("无法获取头像 URL")
代码解释:
- requests.get(): 使用 requests 库向指定的 URL 发送 GET 请求，获取角色数据。
- req.status_code: 检查 HTTP 状态码，确保请求成功（状态码为 200）。
- req.json(): 将响应内容解析为 JSON 格式的 Python 字典。
-
character_data.get("decorations", {}).get("avatarUrl", ""): 这是核心部分。
- character_data.get("decorations", {}) 尝试获取 character_data 字典中键为 "decorations" 的值。如果 "decorations" 键不存在，则返回一个空字典 {} 作为默认值。
- .get("avatarUrl", "") 接着尝试从 decorations 字典（或者空字典，如果 "decorations" 键不存在）中获取键为 "avatarUrl" 的值。如果 "avatarUrl" 键不存在，则返回一个空字符串 "" 作为默认值。
使用 get 方法的优势:
使用 get 方法可以避免因键不存在而导致的 KeyError 异常。如果直接使用 character_data["decorations"]["avatarUrl"]，当 "decorations" 或 "avatarUrl" 键不存在时，程序会抛出异常。而 get 方法在键不存在时会返回指定的默认值，使代码更加健壮。
其他方法 (不推荐):
虽然可以使用 try...except 块来捕获 KeyError 异常，但这通常不是最佳实践，因为它会隐藏其他潜在的错误。
try:
avatar_url = character_data["decorations"]["avatarUrl"]
except KeyError:
avatar_url = ""
总结:
使用 get 方法是安全有效地从嵌套 JSON 字典中提取数据的推荐方法。它避免了 KeyError 异常，并允许您在键不存在时指定默认值，使代码更加健壮和易于维护。在处理来自 API 的 JSON 数据时，请始终考虑使用 get 方法来访问字典中的值。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
