Django REST Framework (DRF) es el estándar de facto para construir APIs REST con Django, y los serializadores son su concepto central. Un serializador convierte datos complejos (instancias de modelo, querysets) a JSON para respuestas de API, y convierte JSON entrante de vuelta a objetos Python validados — manejando tanto serialización como validación, muy similar a como los formularios lo hacen para 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 genera automáticamente campos a partir del modelo (como un ModelForm) — código mínimo para serializar y validar un modelo.
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
El patrón refleja formularios: is_valid() valida datos entrantes contra reglas de campo y el modelo, y save() los persiste. Los datos inválidos producen mensajes de error estructurados.
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"]
Los serializadores pueden anidarse para representar objetos relacionados (insertando datos del autor dentro del JSON de un artículo) — y controlas la forma de la API independientemente de la base de datos.
Los serializadores son la piedra angular para construir APIs REST con Django REST Framework, que es la herramienta estándar para APIs de Django — por lo que comprenderlos es esencial para cualquier desarrollador back-end moderno de Django que sirva JSON a frontends, aplicaciones móviles u otros servicios.
Los serializadores resuelven las dos necesidades fundamentales de una API: convertir datos de Python/modelo a JSON para respuestas (serialización) y convertir JSON entrante a objetos Python validados para crear/actualizar datos (deserialización + validación).
El aspecto de validación es crítico para seguridad y robustez — como formularios para HTML, los serializadores garantizan que nunca confíes en entrada bruta de API, validándola contra reglas de campo antes de que llegue a tu base de datos. ModelSerializer proporciona una ganancia importante de productividad al generar automáticamente campos a partir de modelos (DRY, como ModelForm), haciendo trivial exponer modelos como recursos de API, mientras que el patrón is_valid()/save() maneja el ciclo de vida completo de crear/actualizar de forma limpia.
Comprender cómo serializar objetos y querysets, deserializar y validar entrada, agregar validación personalizada y campos calculados, y usar serializadores anidados para datos relacionados (controlando la forma de la API independientemente del esquema de base de datos) es fundamental para construir APIs.
Los serializadores son donde DRF maneja las preocupaciones principales de la API: transformación y validación de datos, haciéndolos un conocimiento central imprescindible — análogo en importancia a formularios para Django tradicional, pero para las aplicaciones impulsadas por API que dominan el desarrollo web moderno.