Python requests模块获取随机单词：API限制与分类筛选策略

使用 requests 模块获取基础随机单词

在python项目中，经常需要与外部api进行交互以获取数据。requests库是进行http请求的强大工具。以下代码演示了如何从random-word-api.herokuapp.com api获取一个随机单词：

import requests
import random

def fetch_random_word():
    """
    从API获取一个随机单词。
    """
    try:
        url = "https://random-word-api.herokuapp.com/word?number=1"
        response = requests.get(url)
        # 检查HTTP响应状态码，确保请求成功
        response.raise_for_status() 
        words = response.json()
        if words:
            # API返回的是一个列表，即使只请求一个单词
            random_word = random.choice(words) 
            print(f"获取到的随机单词: {random_word}")
            return random_word
        else:
            print("API未返回任何单词。")
            return None
    except requests.exceptions.RequestException as e:
        print(f"请求API时发生错误: {e}")
        return None
    except ValueError as e:
        print(f"解析API响应失败: {e}")
        return None

# 调用函数获取随机单词
fetch_random_word()

代码解析：

• import requests：导入requests库用于发送HTTP请求。
• url = "https://random-word-api.herokuapp.com/word?number=1"：定义API的URL，number=1参数表示请求一个单词。
• response = requests.get(url)：发送GET请求到指定的URL。
• response.raise_for_status()：这是一个非常重要的步骤，它会在HTTP请求返回错误状态码（如4xx或5xx）时抛出requests.exceptions.HTTPError异常，有助于及时发现问题。
• words = response.json()：将API返回的JSON格式响应解析为Python列表或字典。
• random.choice(words)：从返回的单词列表中随机选择一个（尽管我们只请求一个，API仍可能返回列表）。
• 异常处理：使用try...except块捕获requests.exceptions.RequestException（网络问题、DNS错误等）和ValueError（JSON解析失败）等潜在错误，提高代码的健壮性。

尝试按类别筛选及遇到的问题

许多API提供参数来精细化查询结果，例如按类别筛选。自然地，我们可能会尝试通过在URL中添加category参数来获取特定类别的单词，例如“水果”：

import requests
import random

def fetch_random_word_by_category(category):
    """
    尝试从API获取特定类别的随机单词。
    """
    try:
        url = f"https://random-word-api.herokuapp.com/word?number=1&category={category}"
        print(f"尝试请求URL: {url}")
        response = requests.get(url)
        response.raise_for_status() # 检查HTTP状态码
        words = response.json()
        if words:
            random_word = random.choice(words)
            print(f"获取到的随机 {category} 单词: {random_word}")
            return random_word
        else:
            print(f"API未返回任何 {category} 单词。")
            return None
    except requests.exceptions.RequestException as e:
        print(f"请求API时发生错误: {e}")
        return None
    except ValueError as e:
        print(f"解析API响应失败: {e}")
        return None

# 尝试获取一个随机水果名称
fetch_random_word_by_category("fruits")

然而，运行上述代码时，我们可能会得到如下错误信息：

请求API时发生错误: 404 Client Error: Not Found for url: https://random-word-api.herokuapp.com/word?number=1&category=fruits

这表明API返回了一个404（未找到）错误，或者在我们的except块中捕获到了异常。这通常意味着API不支持我们尝试使用的category参数。

立即学习“Python免费学习笔记（深入）”；

API文档的重要性与解决方案

出现上述问题时，首要且最关键的步骤是查阅所使用API的官方文档。对于random-word-api.herokuapp.com，其文档（例如：https://random-word-api.herokuapp.com/home）会明确指出其支持的参数和功能。

通过查阅该API的文档，我们可以发现它不提供按特定类别筛选单词的功能。它主要用于获取通用的随机单词，不具备“水果”、“颜色”等分类筛选能力。因此，无论我们如何构造category参数，该API都无法满足按类别筛选的需求。

讯飞智作-讯飞配音

讯飞智作是一款集AI配音、虚拟人视频生成、PPT生成视频、虚拟人定制等多功能的AI音视频生产平台。已广泛应用于媒体、教育、短视频等领域。

67

查看详情

解决方案：

当遇到API不支持所需功能的情况时，有以下几种策略：

1. 更换API： 这是最直接且推荐的方法。寻找其他专门提供带分类筛选功能的单词API。市面上存在许多公共API，通过搜索“random word API with categories”或“vocabulary API”等关键词，可以找到合适的替代品。在选择新API时，务必仔细阅读其文档，确认其是否支持所需功能，并了解其使用限制（如请求频率、认证等）。
2. 构建本地数据集： 如果API选择有限或项目需求允许，可以自行维护一个包含分类单词的本地数据集（例如，JSON文件、CSV文件或数据库）。当需要特定类别的单词时，直接从本地数据源中随机选择。这需要前期投入来收集和整理数据，但一旦建立，可以完全掌控数据内容和访问方式。
3. 使用第三方库/服务： 有些Python库或服务可能已经封装了多种单词资源，并提供了更高级的查询接口。

总结与最佳实践

本教程展示了如何使用Python的requests模块获取随机单词，并强调了在API使用过程中，尤其是当特定功能（如按类别筛选）不按预期工作时，查阅API官方文档的极端重要性。

核心要点：

• API文档是金： 任何API集成的起点和终点都应该是其官方文档。它详细说明了可用端点、支持的参数、认证方式、响应格式以及使用限制。
• 错误处理： 始终在代码中加入健壮的错误处理机制（如try...except块和response.raise_for_status()），以便优雅地处理网络问题、API错误响应或数据解析失败。
• 选择合适的工具： 如果当前API无法满足项目需求，不要强行改造或绕过其限制，而是应该积极寻找更适合的API或解决方案。

通过遵循这些最佳实践，您将能够更高效、更可靠地在Python项目中与各种外部API进行交互。

以上就是Python requests模块获取随机单词：API限制与分类筛选策略的详细内容，更多请关注php中文网其它相关文章！