RESTful API 在现代开发中至关重要，它允许不同的系统以高效且可扩展的方式进行通信。 Python 及其 Flask 框架提供了一种简单而强大的方法来创建 API。在本指南中，我们将探索如何使用 Flask 创建 RESTful API，涵盖从基础知识到 HTTP 客户端的身份验证和使用的所有内容。
在开始编写代码之前，了解什么是 RESTful API 非常重要。 API（应用程序编程接口）是一组允许一个软件与另一个软件通信的规则。 REST（表述性状态传输） 样式定义了 API 必须遵循的一组原则：
现在我们将创建一个简单的 API 来管理用户列表。该 API 将允许您添加、编辑、查看和删除用户。
首先，确保你已经安装了 Flask。如果没有，您可以使用 pip 安装：
pip install Flask
我们的项目将具有以下结构：
/api_flask │ ├── app.py └── requirements.txt
在 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'}
]
现在，让我们为查看、添加、更新和删除用户创建端点。
我们将使用GET方法列出所有用户：
@app.route('/users', methods=['GET'])
def get_users():
return jsonify(users), 200
我们将使用 GET 方法和用户 ID 来获取特定用户的详细信息：
@app.route('/users/<int:user_id>', 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
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
这里我们使用PUT方法来更新现有用户的数据：
@app.route('/users/<int:user_id>', 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
我们使用DELETE方法来删除用户：
@app.route('/users/<int:user_id>', 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
现在，只需运行我们的应用程序：
if __name__ == '__main__':
app.run(debug=True)
运行app.py文件，我们的API将在http://127.0.0.1:5000/users可用。
要为我们的 API 添加一层安全性，我们可以使用 JWT（JSON Web 令牌）。使用 JWT，我们可以确保只有经过身份验证的用户才能访问某些端点。
安装所需的扩展：
pip install Flask-JWT-Extended
更新您的 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 令牌来验证用户身份。
要使用 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，根据您的需求和要求进行自定义。
以上是如何使用 Flask 和 Python 创建 RESTful API的详细内容。更多信息请关注PHP中文网其他相关文章！
