如何使用 Flask 和 Python 创建 RESTful API

小伙伴们对文章编程感兴趣吗？是否正在学习相关知识点？如果是，那么本文《如何使用 Flask 和 Python 创建 RESTful API》，就很适合你，本篇文章讲解的知识点主要包括。在之后的文章中也会多多分享相关知识点，希望对大家的知识积累有所帮助！

restful api 在现代开发中至关重要，它允许不同的系统以高效且可扩展的方式进行通信。 python 及其 flask 框架提供了一种简单而强大的方法来创建 api。在本指南中，我们将探索如何使用 flask 创建 restful api，涵盖从基础知识到 http 客户端的身份验证和使用的所有内容。

什么是 restful api？

在开始编写代码之前，了解什么是 restful api 非常重要。 api（应用程序编程接口）是一组允许一个软件与另一个软件通信的规则。 rest（表述性状态传输） 样式定义了 api 必须遵循的一组原则：

• 客户端-服务器：客户端（使用api​​）和服务器（提供数据）之间的分离。
• 无状态：客户端发出的每个请求都必须包含服务器处理所需的所有信息。
• 可缓存：可以缓存 api 响应以提高性能。
• 统一接口：客户端和服务器之间的通信必须以标准化的方式进行，使用http方法，例如get、post、put和delete。

使用 flask 创建 restful api

现在我们将创建一个简单的 api 来管理用户列表。该 api 将允许您添加、编辑、查看和删除用户。

1.安装flask

首先，确保你已经安装了 flask。如果没有，您可以使用 pip 安装：

pip install flask

2. 项目结构

我们的项目将具有以下结构：

/api_flask
│
├── app.py
└── requirements.txt

3. 配置 flask

在 app.py 文件中，我们首先导入必要的库并配置我们的 flask 应用程序：

from flask import flask, jsonify, request

app = flask(__name__)

# dados simulados
users = [
    {'id': 1, 'name': 'alice', 'email': 'alice@example.com'},
    {'id': 2, 'name': 'bob', 'email': 'bob@example.com'}
]

4. 创建端点

现在，让我们为查看、添加、更新和删除用户创建端点。

4.1.列出用户的端点

我们将使用get方法列出所有用户：

@app.route('/users', methods=['get'])
def get_users():
    return jsonify(users), 200

4.2.获取特定用户的端点

我们将使用 get 方法和用户 id 来获取特定用户的详细信息：

@app.route('/users/', methods=['get'])
def get_user(user_id):
    user = next((user for user in users if user['id'] == user_id), none)
    if user:
        return jsonify(user), 200
    else:
        return jsonify({'message': 'user not found'}), 404

4.3.创建新用户的端点

post 方法将用于添加新用户。客户端将以 json 格式发送数据。

@app.route('/users', methods=['post'])
def create_user():
    data = request.get_json()
    new_user = {
        'id': len(users) + 1,
        'name': data['name'],
        'email': data['email']
    }
    users.append(new_user)
    return jsonify(new_user), 201

4.4.更新用户的端点

这里我们使用put方法来更新现有用户的数据：

@app.route('/users/', methods=['put'])
def update_user(user_id):
    data = request.get_json()
    user = next((user for user in users if user['id'] == user_id), none)
    if user:
        user['name'] = data['name']
        user['email'] = data['email']
        return jsonify(user), 200
    else:
        return jsonify({'message': 'user not found'}), 404

4.5.删除用户的端点

我们使用delete方法来删除用户：

@app.route('/users/', methods=['delete'])
def delete_user(user_id):
    global users
    users = [user for user in users if user['id'] != user_id]
    return jsonify({'message': 'user deleted'}), 200

5. 运行api

现在，只需运行我们的应用程序：

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

运行app.py文件，我们的api将在http://127.0.0.1:5000/users可用。

6. 使用 flask 进行身份验证

要为我们的 api 添加一层安全性，我们可以使用 jwt（json web 令牌）。使用 jwt，我们可以确保只有经过身份验证的用户才能访问某些端点。

6.1.安装 flask-jwt-extend

安装所需的扩展：

pip install flask-jwt-extended

6.2.配置 jwt

更新您的 app.py 文件以包含 jwt 身份验证：

from flask_jwt_extended import jwtmanager, create_access_token, jwt_required

app.config['jwt_secret_key'] = 'your-secret-key'  # troque pela sua chave secreta
jwt = jwtmanager(app)

# login para obter o token
@app.route('/login', methods=['post'])
def login():
    data = request.get_json()
    if data['username'] == 'admin' and data['password'] == 'admin':
        access_token = create_access_token(identity={'username': 'admin'})
        return jsonify(access_token=access_token), 200
    else:
        return jsonify({'message': 'invalid credentials'}), 401

# exemplo de endpoint protegido
@app.route('/protected', methods=['get'])
@jwt_required()
def protected():
    return jsonify({'message': 'access granted to protected endpoint'}), 200

现在，当访问 /protected 端点时，需要在请求标头中发送 jwt 令牌来验证用户身份。

7. 通过 http 客户端使用 api

要使用 api，我们可以使用 postman 等工具或 python 中的 requests 等库。

如何使用请求使用 api 的示例：

import requests

# Consumindo o endpoint de listagem de usuários
response = requests.get('http://127.0.0.1:5000/users')
print(response.json())

结论

使用 flask 创建 restful api 既简单又灵活。 flask 提供了一个简约的框架，可以扩展以包含身份验证、错误处理和其他安全层等功能。通过遵循 rest 原则和良好的开发实践，可以使用 python 构建高效且可扩展的 api。

现在您可以使用 flask 构建自己的 restful api，根据您的需求和要求进行自定义。

以上就是本文的全部内容了，是否有顺利帮助你解决问题？若是能给你带来学习上的帮助，请大家多多支持golang学习网！更多关于文章的相关知识，也可关注golang学习网公众号。