如何用Flask构建API

你有没有想过你最喜欢的应用是如何互相通信的？点击手机上的按钮是如何立刻连接到一个信息的世界的？背后的魔力就是我们称之为API的东西，它代表着应用程序编程接口。它就像一个信使，接受请求，告诉系统你想要什么，然后带回响应。听起来很酷，对吧？

computer and desktop 今天，我们将学习如何使用Flask构建你自己的API，Flask是一个非常简单且轻量的Python Web框架。别担心，如果你觉得听起来有些复杂——我们会一步一步地以有趣且简单的方式来拆解。

第1步：准备工作

在我们开始之前，你需要在VS code中安装以下工具：

安装Python（如果你还没有安装，可以从Python官网获取！）。
安装Flask库（在终端或命令提示符中输入 pip install flask 安装）。

就这些！我们准备好开始了。

第2步：什么是Flask？

Flask就像是一个小型工具箱，用于构建Web应用和API。它不像其他框架那样庞大笨重，但非常适合简单的项目，而且容易上手！可以把它想象成一个小餐馆的厨房，在那里你可以快速做出美味的菜肴。🧑‍🍳

第3步：设置一个简单的API

让我们来构建一个可以接收请求并返回响应的API。以下是基本结构：

打开你喜欢的代码编辑器（VS Code、Sublime，或者你如果很勇敢，也可以使用记事本）。创建一个新文件并命名为 app.py。 以下是你需要的代码：

from flask import Flask, jsonify

app = Flask(__name__)

# 创建一个简单的API端点
@app.route('/hello', methods=['GET'])
def hello_world():
    return jsonify({"message": "Hello, World!"})

if __name__ == '__main__':
    app.run(debug=True)

让我们分解一下这个代码：

导入Flask和jsonify： 我们需要Flask来构建Web应用，而jsonify用于将数据以JSON格式返回（这是一种计算机喜欢用来交流的格式）。
@app.route(‘/hello’, methods=[‘GET’]): 这里我们告诉Flask我们希望响应的URL是哪里（在本例中是/hello）。当有人访问这个URL时，他们会收到来自我们API的消息。
return jsonify({"message": "Hello, World!"}): 这将以JSON格式发送一个响应，内容是“Hello, World！”这样其他系统也能理解。

第4步：运行你的API

要运行这个API，打开终端，导航到你保存 app.py 文件的位置，然后输入：

python app.py

Boom！你的第一个API就在本地机器上运行了。打开浏览器，访问 http://127.0.0.1:5000/hello，你会看到魔法发生。🎉 你将看到类似这样的信息： {"message": "Hello, World!"}

第5步：让你的API做更多事情

假设你想让你的API返回一组水果列表。你可以这样做：

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/fruits', methods=['GET'])
def get_fruits():
    fruits = ['apple', 'banana', 'cherry', 'date', 'elderberry']
    return jsonify(fruits)

if __name__ == '__main__':
    app.run(debug=True)

现在，如果你访问 http://127.0.0.1:5000/fruits，你将得到一个JSON格式的水果列表。很简单，对吧？

第6步：处理用户请求（动态路由）

让我们进一步提升！如果你想创建一个API，根据用户输入提供特定的信息呢？例如，如果有人想要了解某种水果的详细信息，我们可以使用动态路由来实现这一点。

具体方法如下：

from flask import Flask, jsonify

app = Flask(__name__)

fruits_info = {
    'apple': 'A sweet red fruit.',
    'banana': 'A long yellow fruit.',
    'cherry': 'A small red fruit.'
}

@app.route('/fruits/<fruit_name>', methods=['GET'])
def get_fruit_info(fruit_name):
    info = fruits_info.get(fruit_name, "Fruit not found!")
    return jsonify({"fruit": fruit_name, "info": info})

if __name__ == '__main__':
    app.run(debug=True)

现在，如果你访问 http://127.0.0.1:5000/fruits/apple，你将看到“这是一个甜美的红色水果。如果你请求的水果不在列表中，它会告诉你，水果未找到！”