Utilizzo di Django con API REST
Partiremo dalla configurazione iniziale dell’ambiente, passando per la creazione di un’applicazione dedicata alle API, fino all’implementazione di serializer e router. Successivamente mostreremo come strutturare le view con i classici endpoint CRUD, come proteggere le risorse con permessi e meccanismi di autenticazione, e come verificare il corretto funzionamento usando strumenti come Postman o curl. Concluderemo con un esempio pratico di gestione di una libreria di libri, fornendo risorse per approfondire l’argomento.
L’obiettivo è fornire una panoramica completa ma concisa, in modo che chiunque abbia già dimestichezza con Django possa rapidamente aggiungere al proprio progetto funzionalità RESTful, mantenendo un codice pulito e facilmente estendibile.
Cos’è Django e perché utilizzarlo con API REST
Django è un framework open‑source scritto in Python, noto per la rapidità di sviluppo e per il suo ORM che semplifica l’interazione con il database. Integrarlo con le API REST permette di esporre i dati dell’applicazione attraverso richieste HTTP, rendendo le funzionalità disponibili a client esterni, come app mobile o altri servizi web.
Il pacchetto Django REST Framework (DRF) aggiunge un set di strumenti specifici per costruire API: view, serializer e router pronti all’uso, riducendo drasticamente la quantità di codice necessario. Grazie a DRF, è possibile creare endpoint conformi alle migliori pratiche REST senza dover riscrivere logica di serializzazione o gestione delle risposte.
Questa combinazione consente di realizzare applicazioni complete, modulabili e pronte per l’integrazione, mantenendo al contempo la leggibilità e la manutenzione del codice.
Configurazione di un progetto Django per l’utilizzo con API REST
-
Installazione dei pacchetti
Creazione del progetto e dell’applicazione
Registrazione di DRF
Aggiungi 'rest_framework' e la tua app alla lista INSTALLED_APPS in settings.py.
Definizione del modello (esempio di libro)
Creazione del serializer
Implementazione della viewset
Configurazione delle rotte
Con questi passaggi il progetto è pronto a gestire le operazioni CRUD sui libri tramite endpoint http://localhost:8000/books/.
Creazione di modelli e view per le API REST
Creazione dei modelli
Il modello rappresenta la struttura dei dati. Dopo aver definito la classe Book (come mostrato sopra) è necessario creare le migrazioni e applicarle:
Creazione delle view
Le view di DRF, in particolare i ViewSet, automatizzano le operazioni CRUD. Se si preferisce una view basata su funzioni, è possibile usare i decoratori @api_view e @permission_classes:
Entrambe le soluzioni possono coesistere; il router registrerà i ViewSet mentre le view basate su funzioni possono essere collegate manualmente alle URL.
Implementazione di metodi HTTP e autenticazione
DRF gestisce automaticamente i metodi HTTP fondamentali (GET, POST, PUT, PATCH, DELETE) quando si utilizza un ModelViewSet. Per personalizzare il comportamento è sufficiente sovrascrivere i metodi corrispondenti nella viewset.
L’autenticazione può essere impostata globalmente in settings.py oppure a livello di vista mediante i decoratori. Esempio di configurazione globale:
Se si desidera applicare l’autenticazione solo a una vista specifica:
In questo modo le API rimangono sicure, consentendo l’accesso solo a utenti autenticati.
Test delle API REST e risoluzione dei problemi
Per verificare il corretto funzionamento delle API è consigliato utilizzare Postman, Insomnia o curl. Un tipico test di endpoint books con curl:
Se si riscontrano errori, i primi step sono:
- Controllare i log di Django (
python manage.py runserver) per messaggi di eccezione. - Verificare le impostazioni di autenticazione e permessi.
- Utilizzare il pannello di amministrazione (
/admin/) per ispezionare i dati nel database.
Quando si modificano query o logica di serializzazione, è buona pratica eseguire nuovamente i test per assicurarsi che il problema sia stato risolto.
Esempi pratici di utilizzo di Django con API REST
Immaginiamo di gestire una libreria digitale. Dopo aver creato il modello Book, il serializer BookSerializer e il BookViewSet, le rotte sono disponibili all’indirizzo /books/.
Per aggiungere funzionalità di ricerca per titolo, è sufficiente estendere il queryset nella viewset:
Ora, una chiamata GET /books/?title=django restituisce solo i libri il cui titolo contiene la parola “django”.
Questo esempio mostra come, con poche righe di codice, DRF permette di arricchire le API con filtri, paginazione e altre funzionalità avanzate, mantenendo al contempo una struttura leggibile.
Approfondire l’utilizzo di Django con API REST
Per approfondire, visita la documentazione ufficiale di Django (https://www.djangoproject.com/) e quella di Django REST Framework (https://www.django-rest-framework.org/). Entrambe le risorse offrono guide, tutorial e best practice per sfruttare al meglio le potenzialità del framework.
Ricorda che la pratica è fondamentale: crea piccoli progetti, sperimenta nuove configurazioni, e partecipa alle community (Stack Overflow, forum Django) per confrontarti con altri sviluppatori. Con Django e le API REST a disposizione, avrai a disposizione una base solida per costruire applicazioni web moderne, scalabili e integrate. Buon lavoro!