Django REST Framework (DRF) este standardul de facto pentru construirea API-urilor REST cu Django, iar serializerele sunt conceptul său central. Un serializer convertește date complexe (instanțe de model, queryset-uri) în JSON pentru răspunsurile API, și convertește JSON-ul sosit înapoi în obiecte Python validate — gestionând atât serializarea cât și validarea, similar cu modul în care formularele funcționează pentru 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 generează automat câmpuri din model (ca un ModelForm) — cod minim pentru a serializa și valida un model.
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
Patternul reflectă formularele: is_valid() validează datele sosite împotriva regulilor câmpurilor și modelului, iar save() o persistă. Datele nevalide produc mesaje de eroare structurate.
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"]
Serializerele pot să fie imbricate pentru a reprezenta obiecte asociate (încorporând datele autorului în JSON-ul articolului) — și controlezi forma API-ului independent de baza de date.
Serializerele sunt piatra unghiulară a construirii API-urilor REST cu Django REST Framework, care este instrumentul standard pentru API-urile Django — deci înțelegerea lor este esențială pentru orice backend Django modern care servește JSON către frontend-uri, aplicații mobile sau alte servicii.
Serializerele rezolvă cele două nevoi fundamentale ale unui API: convertirea datelor Python/model în JSON pentru răspunsuri (serializare) și convertirea JSON-ului sosit în obiecte Python validate pentru crearea/actualizarea datelor (deserializare + validare).
Aspectul validării este critic pentru securitate și robustețe — ca formularele pentru HTML, serializerele se asigură că niciodată nu ai încredere în intrarea API brută, validând-o împotriva regulilor câmpurilor înainte să ajungă în baza ta de date. ModelSerializer oferă un câștig major de productivitate prin generarea automată a câmpurilor din modele (DRY, ca ModelForm), făcând banal să expui modele ca resurse API, în timp ce pattern-ul is_valid()/save() gestionează complet ciclul de viață create/update curat.
Înțelegerea modului de serializare a obiectelor și queryseturi-lor, deserializare și validare a intrării, adăugare de validare personalizată și câmpuri calculate, și utilizare a serializerelor imbricate pentru date asociate (controlând forma API-ului independent de schema bazei de date) este fundamentală pentru construirea API-urilor.
Serializerele sunt locul unde DRF gestionează preocupările API principale ale transformării și validării datelor, făcîndu-le centrale, cunoaștere esențială — analogă ca importanță formularelor pentru Django tradițional, dar pentru aplicațiile conduse de API care domină dezvoltarea web modernă.