¿Qué son los viewsets y routers de DRF?

Question

Accepted Answer

En Django REST Framework, los **viewsets** agrupan la lógica para un conjunto de puntos finales de API relacionados (las operaciones CRUD para un recurso) en una única clase, y los **routers** generan automáticamente el enrutamiento de URL para ellos. Juntos reducen dramáticamente el código repetitivo para construir APIs RESTful.

## ModelViewSet — CRUD completo en pocas líneas

```python
from rest_framework import viewsets

class ArticleViewSet(viewsets.ModelViewSet):
    queryset = Article.objects.all()             # the data
    serializer_class = ArticleSerializer          # how to serialize it
    # That's it! This provides ALL standard CRUD endpoints automatically:
    #   list (GET), create (POST), retrieve (GET /id), update (PUT/PATCH /id), destroy (DELETE /id)
```

Un `ModelViewSet` proporciona automáticamente el **conjunto completo de puntos finales CRUD RESTful** para un modelo — listar, crear, recuperar, actualizar, actualización parcial y eliminar — desde solo un queryset y un serializador. No es necesario escribir cada vista por separado.

## Routers — generación automática de URLs

```python
from rest_framework.routers import DefaultRouter

router = DefaultRouter()
router.register(r"articles", ArticleViewSet)     # register the viewset

urlpatterns = router.urls
# automatically creates the RESTful URLs:
#   GET    /articles/        → list
#   POST   /articles/        → create
#   GET    /articles/{id}/   → retrieve
#   PUT    /articles/{id}/   → update
#   PATCH  /articles/{id}/   → partial update
#   DELETE /articles/{id}/   → destroy
```

Un **router** mapea un viewset a un conjunto completo de URLs RESTful estándar automáticamente — registrar un viewset genera todos los puntos finales convencionales con los métodos HTTP correctos, eliminando la configuración manual de URLs.

## Personalizando viewsets

```python
class ArticleViewSet(viewsets.ModelViewSet):
    serializer_class = ArticleSerializer
    permission_classes = [IsAuthenticated]        # authorization

def get_queryset(self):                        # customize the data per request
        return Article.objects.filter(author=self.request.user)

# add CUSTOM endpoints beyond CRUD with @action
    @action(detail=True, methods=["post"])
    def publish(self, request, pk=None):           # POST /articles/{id}/publish/
        article = self.get_object()
        article.published = True
        article.save()
        return Response({"status": "published"})
```

Los viewsets se personalizan anulando métodos (`get_queryset`, `perform_create`), configurando permisos, y agregando **acciones personalizadas** (`@action`) para puntos finales más allá del CRUD estándar.

## Viewsets vs vistas genéricas de API

```text
ModelViewSet  → ALL CRUD in one class + router → least code for standard REST resources
Generic views (ListCreateAPIView, etc.) → more explicit, one class per endpoint group
APIView       → full manual control for non-standard/custom endpoints
→ Use viewsets+routers for conventional REST resources; generic/APIView for custom needs.
```

## Por qué es importante

Los viewsets y routers son una característica poderosa de DRF para construir APIs RESTful de manera eficiente — representan el nivel más alto de abstracción para el caso extremadamente común de exponer un modelo como un recurso REST completo, y comprenderlos es valioso para el desarrollo productivo de APIs.

El beneficio clave es la reducción dramática de **código repetitivo**: un `ModelViewSet` más un router te proporciona una API REST completa y convencional para un recurso (todos los puntos finales CRUD con los métodos HTTP y URLs correctas) desde solo un queryset y un serializador — reemplazando lo que de otro modo serían muchas vistas separadas y patrones de URL manuales.

Esto hace que construir APIs REST estándar sea notablemente rápido mientras se asegura que las **convenciones RESTful** (estructura de URL consistente y semántica de métodos HTTP) se siguen automáticamente.

Los viewsets siguen siendo flexibles — los personalizas anulando métodos (filtrando el queryset por usuario, controlando permisos, enganchándote en crear/actualizar) y agregando **acciones personalizadas** (`@action`) para puntos finales más allá del CRUD básico.

Comprender los viewsets y routers, cómo generan puntos finales, cómo personalizarlos, y **cuándo usarlos** (recursos REST convencionales) versus vistas genéricas más explícitas o APIView (puntos finales personalizados/no estándar) es conocimiento práctico importante para el desarrollo de DRF.

Ya que construir APIs REST es un uso principal de Django hoy en día, y viewsets+routers son la forma idiomática y más productiva de hacerlo para recursos estándar, son una parte frecuentemente utilizada e importante del toolkit de DRF que permite a los desarrolladores construir APIs robustas con código mínimo mientras conservan la flexibilidad para manejar requisitos personalizados.