Optimiza tu API en Django REST Framework con un endpoint que lista y crea pacientes en la misma URL, valida datos con serializadores y responde con códigos HTTP claros como 201 Created y 404 Not Found. Aprende a usar la variable request, el atributo method y a estructurar URLs por aplicación con include y parámetros int:pk.
¿Cómo crear y listar pacientes en un endpoint REST con GET y POST?
Un mismo recurso puede listar con GET y crear con POST usando la misma ruta. La clave está en leer request.method y aplicar un condicional por método para ejecutar la lógica correcta.
¿Qué hace la misma URL según el método?
En GET: se consulta la base de datos y se serializa con many=True.
En POST: se recibe request.data y se intenta crear un paciente.
La variable request expone el atributo method para decidir la acción.
¿Cómo validar y guardar con el serializador?
Se instancia el serializador con el parámetro data=request.data.
Se valida con isValid (en DRF se usa con excepciones para manejar errores automáticamente).
Si es válido, se guarda con serializer.save() como si fuera un ModelSerializer.
Se puede retornar sin body y comunicar éxito solo con status=HTTP_201_CREATED.
Los campos de solo lectura (como id) no se toman del body: el backend asigna el valor.
¿Cómo manejar errores y validaciones con serializadores y códigos HTTP?
Validar entradas del usuario es crítico. Un dato inválido (por ejemplo, una fecha con formato incorrecto) no debe causar un 500, sino una respuesta JSON con errores de campo.
¿Qué pasa con datos inválidos y raisedException?
Al usar raisedException en la validación, DRF captura los errores y los formatea en JSON.
El cliente recibe el detalle del campo y el formato esperado, evitando caídas del servidor.
¿Por qué eliminar el if tras las excepciones?
Si se lanza una excepción de validación, el flujo se detiene.
Por eso, se puede omitir el if “si es válido” y dejar la secuencia: validar → guardar → responder.
¿Cómo implementar detalle y rutas en Django con include y parámetros?
Para el detalle, el mismo recurso admite ver con GET y modificar con PUT (el reto propuesto). Es necesario capturar el pk desde la URL y manejar el caso de un paciente inexistente.
¿Cómo obtener un paciente o responder 404 not found?
Intentar con get y capturar la excepción Patient.DoesNotExist.
Optimiza tu API en Django REST Framework con un endpoint que lista y crea pacientes en la misma URL, valida datos con serializadores y responde con códigos HTTP claros como 201 Created y 404 Not Found. Aprende a usar la variable request, el atributo method y a estructurar URLs por aplicación con include y parámetros int:pk.
¿Cómo crear y listar pacientes en un endpoint REST con GET y POST?
Un mismo recurso puede listar con GET y crear con POST usando la misma ruta. La clave está en leer request.method y aplicar un condicional por método para ejecutar la lógica correcta.
¿Qué hace la misma URL según el método?
En GET: se consulta la base de datos y se serializa con many=True.
En POST: se recibe request.data y se intenta crear un paciente.
La variable request expone el atributo method para decidir la acción.
¿Cómo validar y guardar con el serializador?
Se instancia el serializador con el parámetro data=request.data.
Se valida con isValid (en DRF se usa con excepciones para manejar errores automáticamente).
Si es válido, se guarda con serializer.save() como si fuera un ModelSerializer.
@api_view(['GET', 'POST'])
def list_patients(request):
if request.method == 'GET':
patients = Patient.objects.all()
serializer = PatientSerializer(patients, many=True)
return Response(serializer.data)
if request.method == 'POST':
serializer = PatientSerializer(data=request.data)
serializer.is_valid(raise_exception=True) # raisedException en la explicación.
serializer.save()
return Response(status=status.HTTP_201_CREATED)
¿Qué responder al crear con HTTP 201 created?
Se puede retornar sin body y comunicar éxito solo con status=HTTP_201_CREATED.
Los campos de solo lectura (como id) no se toman del body: el backend asigna el valor.
¿Cómo manejar errores y validaciones con serializadores y códigos HTTP?
Validar entradas del usuario es crítico. Un dato inválido (por ejemplo, una fecha con formato incorrecto) no debe causar un 500, sino una respuesta JSON con errores de campo.
¿Qué pasa con datos inválidos y raisedException?
Al usar raisedException en la validación, DRF captura los errores y los formatea en JSON.
El cliente recibe el detalle del campo y el formato esperado, evitando caídas del servidor.
¿Por qué eliminar el if tras las excepciones?
Si se lanza una excepción de validación, el flujo se detiene.
Por eso, se puede omitir el if “si es válido” y dejar la secuencia: validar → guardar → responder.
¿Cómo implementar detalle y rutas en Django con include y parámetros?
Para el detalle, el mismo recurso admite ver con GET y modificar con PUT (el reto propuesto). Es necesario capturar el pk desde la URL y manejar el caso de un paciente inexistente.
¿Cómo obtener un paciente o responder 404 not found?
Intentar con get y capturar la excepción Patient.DoesNotExist.
Si no existe, retornar 404 Not Found.
@api_view(['GET', 'PUT'])
def detail_patient(request, pk):
try:
patient = Patient.objects.get(id=pk)
except Patient.DoesNotExist:
return Response(status=status.HTTP_404_NOT_FOUND)
if request.method == 'GET':
serializer = PatientSerializer(patient)
return Response(serializer.data)
if request.method == 'PUT':
# Reto: implementar la modificación del paciente.
pass
¿Cómo estructurar las URLs por aplicación con include y parámetros?
Crear un archivo urls.py en la app de pacientes.
En las URLs globales, usar include para incorporar las rutas de la app.
@api_view(["PUT"])
def update_patient(request, pk):
try:
# Look for the patient by their primary key (pk)
patient = Patient.objects.get(pk=pk)
except Patient.DoesNotExist:
# If the patient does not exist, return a 404 error
return Response({'error': 'Patient not found'}, status=status.HTTP_404_NOT_FOUND)
# Deserialize the incoming request data
serializer = PatientSerializer(patient, data=request.data)
# Validate the incoming data
if serializer.is_valid():
# Save the changes if the data is valid
serializer.save()
# Return the updated patient data
return Response(serializer.data)
# If the data is not valid, return the errors
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
EL codigo del reto:
(spoiler, para actualizar el usuario se debe actualizar toda la informacion, esto debido a que todos los campos estan obligatorios en el modelo)
Este código me quedó cómodo pero prueben ustedes qué les parece:
# Importaciones necesarias
from rest_framework.decorators import api_view
from rest_framework.response import Response
from rest_framework import status
from .models import Patient # Importar el modelo Patient
from .serializers import PatientSerializer # Importar el serializer del modelo
# 1. Método GET: Obtener todos los pacientes
@api_view(["GET"])
def list_patients(request):
patients = Patient.objects.all() # Obtener todos los pacientes
serializer = PatientSerializer(patients, many=True) # Serializar los datos
return Response(serializer.data) # Devolver los datos en formato JSON
# 2. Método POST: Crear un nuevo paciente
@api_view(["POST"])
def create_patient(request):
serializer = PatientSerializer(data=request.data) # Deserializar los datos del cliente
if serializer.is_valid(): # Validar los datos
serializer.save() # Guardar el nuevo paciente
return Response(serializer.data, status=status.HTTP_201_CREATED) # Respuesta exitosa
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST) # Devolver errores si los datos no son válidos
# 3. Método PUT: Actualizar un paciente existente
@api_view(["PUT"])
def update_patient(request, pk):
try:
patient = Patient.objects.get(pk=pk) # Obtener el paciente por su ID (pk)
except Patient.DoesNotExist:
return Response({'error': 'Paciente no encontrado'}, status=status.HTTP_404_NOT_FOUND)
serializer = PatientSerializer(patient, data=request.data) # Deserializar y actualizar con los nuevos datos
if serializer.is_valid():
serializer.save() # Guardar los cambios
return Response(serializer.data) # Respuesta con los datos actualizados
return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST) # Devolver errores si los datos no son válidos
# 4. Método DELETE: Eliminar un paciente
@api_view(["DELETE"])
def delete_patient(request, pk):
try:
patient = Patient.objects.get(pk=pk) # Obtener el paciente por su ID (pk)
except Patient.DoesNotExist:
return Response({'error': 'Paciente no encontrado'}, status=status.HTTP_404_NOT_FOUND)
patient.delete() # Eliminar el paciente
return Response({'message': 'Paciente eliminado correctamente'}, status=status.HTTP_204_NO_CONTENT)