Django REST Framework (DRF) est la norme de facto pour construire des API REST avec Django, et les sérialiseurs en sont le concept fondamental. Un sérialiseur convertit des données complexes (instances de modèle, querysets) en JSON pour les réponses d'API, et convertit le JSON entrant en retour en objets Python validés — gérant à la fois la sérialisation et la validation, un peu comme les formulaires le font pour l'HTML.
from rest_framework import serializers
from .models import Article
class ArticleSerializer(serializers.ModelSerializer):
class Meta:
model = Article # build from a model (DRY)
fields = ["id", "title", "body", "published", "created_at"]
read_only_fields = ["id", "created_at"]
Un ModelSerializer génère automatiquement les champs à partir du modèle (comme une ModelForm) — code minimal pour sérialiser et valider un modèle.
article = Article.objects.get(pk=1)
serializer = ArticleSerializer(article)
serializer.data # {"id": 1, "title": "Hello", "body": "...", ...} → return as JSON
# serialize a queryset (many objects)
serializer = ArticleSerializer(Article.objects.all(), many=True)
serializer.data # a list of dicts
serializer = ArticleSerializer(data=request.data) # incoming JSON
if serializer.is_valid(): # VALIDATE (like a form)
article = serializer.save() # create/update the model
else:
return Response(serializer.errors, status=400) # validation error details
Le pattern reflète les formulaires : is_valid() valide les données entrantes contre les règles de champ et le modèle, et save() les persiste. Les données invalides produisent des messages d'erreur structurés.
class ArticleSerializer(serializers.ModelSerializer):
word_count = serializers.SerializerMethodField() # a computed, read-only field
def get_word_count(self, obj):
return len(obj.body.split())
def validate_title(self, value): # field-level validation
if "spam" in value.lower():
raise serializers.ValidationError("No spam")
return value
class AuthorSerializer(serializers.ModelSerializer):
class Meta: model = Author; fields = ["name"]
class ArticleSerializer(serializers.ModelSerializer):
author = AuthorSerializer(read_only=True) # embed related author data
class Meta: model = Article; fields = ["title", "author"]
Les sérialiseurs peuvent s'imbriquer pour représenter des objets associés (en intégrant les données de l'auteur dans le JSON de l'article) — et vous contrôlez la forme de l'API indépendamment de la base de données.
Les sérialiseurs sont la pierre angulaire de la construction d'API REST avec Django REST Framework, qui est l'outil standard pour les API Django — donc les comprendre est essentiel pour tout développeur backend Django moderne servant du JSON aux frontends, applications mobiles ou autres services.
Les sérialiseurs résolvent les deux besoins fondamentaux d'une API : convertir les données Python/modèle en JSON pour les réponses (sérialisation) et convertir le JSON entrant en objets Python validés pour créer/mettre à jour les données (désérialisation + validation).
L'aspect validation est critique pour la sécurité et la robustesse — comme les formulaires pour l'HTML, les sérialiseurs garantissent que vous ne faites jamais confiance à l'entrée brute de l'API, en la validant contre les règles de champ avant qu'elle n'atteigne votre base de données. ModelSerializer offre un gain de productivité majeur en générant automatiquement les champs à partir des modèles (DRY, comme ModelForm), ce qui rend trivial d'exposer les modèles comme ressources d'API, tandis que le pattern is_valid()/save() gère l'ensemble du cycle de création/mise à jour de manière propre.
Comprendre comment sérialiser des objets et des querysets, désérialiser et valider l'entrée, ajouter une validation personnalisée et des champs calculés, et utiliser les sérialiseurs imbriqués pour les données associées (en contrôlant la forme de l'API indépendamment du schéma de la base de données) est fondamental pour construire des API.
Les sérialiseurs sont l'endroit où DRF gère les préoccupations API fondamentales de transformation et validation des données, ce qui en fait une connaissance centrale et essentielle — analogue en importance aux formulaires pour le Django traditionnel, mais pour les applications orientées API qui dominent le développement web moderne.