使用 Python 构建一个简单的 REST API

1. 简介

本文档介绍如何使用 Python 和 Flask 框架构建一个简单的 REST API，该 API 提供关于天气数据的查询功能。

2. 安装

首先，需要安装 Python 和 Flask。

• 安装 Python: 可以从 https://www.python.org/ 下载并安装 Python。
• 安装 Flask: 使用 pip 安装 Flask：

bash pip install Flask

3. 代码结构

以下代码展示了 API 的核心结构：

```python from flask import Flask, jsonify

app = Flask(name)

模拟天气数据

weather_data = { "city": "London", "temperature": 15, "condition": "Cloudy" }

@app.route('/weather') def get_weather(): """ 获取天气数据 """ return jsonify(weather_data)

if name == 'main': app.run(debug=True) ```

4. 代码说明

• Flask 应用程序: app = Flask(__name__) 创建一个 Flask 应用程序。
• 天气数据: weather_data 是一个字典，模拟了天气数据。
• 路由: @app.route('/weather') 定义了一个路由 /weather。
• 函数: get_weather() 函数用于处理路由请求。
• JSON 响应: return jsonify(weather_data) 将天气数据转换为 JSON 格式返回。
• 运行服务器: app.run(debug=True) 启动 Flask 服务器，在开发模式下运行。

5. 使用 API

在浏览器中访问 http://127.0.0.1:5000/weather，即可获取 JSON 格式的天气数据。

6. 扩展功能

• 添加更多数据: 可以将 weather_data 扩展为包含更多天气数据，例如湿度、风速等。
• 数据库集成: 可以使用数据库存储天气数据，并使用 Flask-SQLAlchemy 等工具进行操作。
• 认证和授权: 可以添加认证和授权机制，限制对 API 的访问。
• 错误处理: 可以实现错误处理机制，并返回有意义的错误信息。

7. 总结

本文档介绍了使用 Python 和 Flask 框架构建一个简单的 REST API。您可以根据自己的需求进行扩展和完善。