### 使用Python构建RESTful API框架 以下是基于Flask框架的一个简单示例，用于演示如何使用Python创建一个基本的RESTful API。 #### Flask RESTful API 的基础结构 Flask 是一种轻量级的 Web 应用程序框架，支持快速开发和部署。通过结合 `flask-restful` 扩展包，可以更方便地设计和实现 RESTful 风格的服务[^1]。 #### 安装依赖项 在开始之前，请确保安装了必要的 Python 包： ```bash pip install flask flask-restful ``` #### 示例代码：创建一个简单的 RESTful API 下面是一个完整的代码示例，展示了如何定义一个返回 JSON 数据的 RESTful API： ```python from flask import Flask, jsonify from flask_restful import Api, Resource # 初始化 Flask 应用 app = Flask(__name__) api = Api(app) # 创建一个资源类 class HelloWorld(Resource): def get(self): # 处理 HTTP GET 请求 response_data = { 'message': 'Welcome to the RESTful API!', 'status': 'success' } return jsonify(response_data) # 返回 JSON 响应 # 将资源添加到 API 中，并指定路由路径 api.add_resource(HelloWorld, '/') if __name__ == '__main__': app.run(debug=True) # 启动应用程序并启用调试模式 ``` 上述代码实现了以下功能： - 定义了一个名为 `/` 的端点 (endpoint)，当客户端发送 HTTP GET 请求时会触发该端点。 - 返回的数据是以 JSON 格式呈现的消息字符串[^2]。 运行此脚本后，在浏览器或 Postman 工具中访问地址 `http://localhost:5000/` 即可看到响应数据。 #### 进一步扩展的功能 如果希望增加更多复杂度或者处理其他类型的请求（如 POST 或 PUT 方法），可以通过继承自 `Resource` 类的方法来完成。例如，下面是另一个例子，展示如何接受参数并通过查询传递给服务器[^3]： ```python from flask import request class GreetUser(Resource): def post(self): user_name = request.json.get('name', 'Guest') # 获取 JSON 负载中的 name 字段，默认值为 Guest greeting_message = f'Hello {user_name}!' return {'greeting': greeting_message}, 201 # 自定义状态码 201 表明已成功创建新实体 api.add_resource(GreetUser, '/greet') ``` 在这个新增加的例子里，我们还引入了对 POST 请求的支持以及从请求体读取输入的能力。 --- ###