Jak tworzyć API w Pythonie za pomocą Flask lub Django?

Wprowadzenie do API

API (Application Programming Interface) to zestaw reguł i protokołów umożliwiających różnym aplikacjom komunikację ze sobą. W kontekście tworzenia aplikacji webowych, API pozwala na wymianę danych między serwerem a klientem. W Pythonie, dwa popularne frameworki do tworzenia API to Flask i Django. W tym artykule omówimy, jak tworzyć API za pomocą tych dwóch narzędzi.

Flask: Lekki i Elastyczny Framework

Flask to mikroframework, który jest idealny do tworzenia prostych i elastycznych aplikacji webowych. Jego lekka struktura pozwala na szybkie prototypowanie i łatwe rozszerzanie funkcjonalności.

Instalacja Flask

Aby zainstalować Flask, wystarczy użyć pip:

pip install Flask

Tworzenie Prostego API w Flask

Oto przykład prostego API w Flask, które zwraca listę użytkowników:

from flask import Flask, jsonify

app = Flask(__name__)

@app.route('/api/users', methods=['GET'])
def get_users():
    users = [
        {'id': 1, 'name': 'John Doe'},
        {'id': 2, 'name': 'Jane Doe'}
    ]
    return jsonify(users)

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

W powyższym kodzie definiujemy endpoint /api/users, który zwraca listę użytkowników w formacie JSON.

Zalety Flask

• Prostota i elastyczność
• Łatwość w nauce i użyciu
• Możliwość szybkiego prototypowania

Django: Kompleksowy Framework

Django to bardziej rozbudowany framework, który oferuje wiele wbudowanych funkcji, takich jak autoryzacja użytkowników, zarządzanie bazą danych i wiele innych. Jest idealny do tworzenia dużych i złożonych aplikacji webowych.

Instalacja Django

Aby zainstalować Django, użyj pip:

pip install Django

Tworzenie API w Django za pomocą Django REST Framework

Django REST Framework (DRF) to potężne narzędzie do tworzenia API w Django. Oto jak można stworzyć proste API za pomocą DRF:

Instalacja Django REST Framework

pip install djangorestframework

Konfiguracja Django REST Framework

Dodaj DRF do swojego pliku settings.py:

INSTALLED_APPS = [
    ...
    'rest_framework',
]

Tworzenie Modelu i Serializera

Najpierw stwórzmy model użytkownika:

from django.db import models

class User(models.Model):
    name = models.CharField(max_length=100)

Następnie stwórzmy serializer:

from rest_framework import serializers
from .models import User

class UserSerializer(serializers.ModelSerializer):
    class Meta:
        model = User
        fields = ['id', 'name']

Tworzenie Widoku i URL

Stwórzmy widok, który zwraca listę użytkowników:

from rest_framework import generics
from .models import User
from .serializers import UserSerializer

class UserList(generics.ListCreateAPIView):
    queryset = User.objects.all()
    serializer_class = UserSerializer

Dodajmy URL do naszego widoku:

from django.urls import path
from .views import UserList

urlpatterns = [
    path('api/users/', UserList.as_view(), name='user-list'),
]

Zalety Django

• Wiele wbudowanych funkcji
• Silne wsparcie społeczności
• Bezpieczeństwo i skalowalność

Porównanie Flask i Django

Cecha	Flask	Django
Prostota	Wysoka	Średnia
Elastyczność	Wysoka	Średnia
Funkcjonalność	Niska	Wysoka
Szybkość prototypowania	Wysoka	Średnia

Podsumowanie

Tworzenie API w Pythonie za pomocą Flask lub Django zależy od specyficznych potrzeb projektu. Flask jest idealny do prostych i elastycznych aplikacji, podczas gdy Django oferuje więcej wbudowanych funkcji i jest lepszy do dużych, złożonych projektów. Wybór odpowiedniego narzędzia zależy od wymagań projektu i preferencji programisty.