Aprender Django Django REST Framework

Django REST Framework

El módulo de Django REST Framework cubre la creación de APIs REST robustas y escalables: instalación, serializadores, ViewSets, routers, autenticación JWT, permisos y paginación con filtrado avanzado.

Instalación y configuración

pip install djangorestframework djangorestframework-simplejwt django-filter

DRF se activa añadiendo 'rest_framework' a INSTALLED_APPS y configurando REST_FRAMEWORK en settings.py con los valores por defecto de autenticación, permisos y paginación.

Serializadores

Los serializadores transforman instancias de modelos en JSON y viceversa. ModelSerializer genera los campos automáticamente a partir del modelo. Los serializadores anidados, SerializerMethodField y la validación personalizada (validate_campo, validate) permiten adaptar la representación a las necesidades de la API.

ViewSets y routers

ModelViewSet proporciona las seis operaciones CRUD de manera declarativa. El DefaultRouter genera todas las URLs automáticamente. Las acciones personalizadas con el decorador @action añaden endpoints adicionales al ViewSet sin necesidad de URLs manuales.

Autenticación JWT y permisos

djangorestframework-simplejwt implementa autenticación con tokens JWT en dos líneas de configuración. El sistema de permisos de DRF (IsAuthenticated, IsAdminUser, IsAuthenticatedOrReadOnly) controla el acceso a nivel de vista, con soporte para permisos personalizados extendiendo BasePermissión.

Paginación y filtrado

DRF incluye paginadores PageNumberPagination, LimitOffsetPagination y CursorPagination. django-filter integra filtros por campo, mientras que SearchFilter y OrderingFilter añaden búsqueda por texto y ordenación declarativa a cualquier ViewSet.