Validaciones custom en Django Rest Framework

La confiabilidad de una API inicia con datos limpios. Aquí verás, paso a paso, cómo implementar validaciones personalizadas en Django Rest Framework desde los serializers para controlar correos corporativos y reglas que combinan varios campos, generando mensajes de error claros en JSON y respuestas consistentes en el backend.

¿Cómo validar correos corporativos en Django Rest Framework?

La idea central es restringir el correo a un dominio específico, por ejemplo, @example.com, dentro del serializer del doctor. Aunque el campo email del modelo ya es de tipo EmailField y valida el formato, se necesita una validación custom de dominio. La estrategia es usar un método con nombre especial: validate_<campo>.

• Usa el método validate_email para validar solo el campo email.
• Retorna el valor si es válido. Lanza excepción si es inválido.
• La excepción es serializers.ValidationError y DRF la muestra como JSON con estado 400.

Ejemplo basado en lo explicado:

from rest_framework import serializers

class DoctorSerializer(serializers.ModelSerializer):
    def validate_email(self, value):
        # valida que el dominio corporativo esté presente
        if "example.com" in value:
            return value
        raise serializers.ValidationError("el correo debe incluir @example.com")

• Este método se activa automáticamente al correr el sistema de validación.
• Si el valor es inválido, la respuesta será un 400 con el detalle del error.
• También podrías pasar código o detalles extra en la excepción, pero aquí basta el texto.

¿Qué pasa si el correo no es válido?

• Se lanza serializers.ValidationError con un mensaje claro.
• El serializer serializa el error a JSON y lo muestra ligado al campo email.
• El mensaje visto en pantalla es directo: "el correo debe incluir @example.com".

¿Cuándo usar validate para varias reglas de negocio?

Cuando la regla depende de más de un campo, se emplea el método validate(self, attrs). En el ejemplo, se cruza contact_number con is_on_vacation: si el doctor se marca en vacaciones sin un teléfono válido (mínimo 10 caracteres), se bloquea la actualización.

• attrs es un diccionario con todos los valores validados por campo.
• Accede con attrs.get("nombre_del_campo").
• Lanza serializers.ValidationError para errores que no pertenecen a un único campo.

Ejemplo basado en lo explicado:

from rest_framework import serializers

class DoctorSerializer(serializers.ModelSerializer):
    def validate(self, attrs):
        contact_number = attrs.get("contact_number")
        is_on_vacation = attrs.get("is_on_vacation")

        if is_on_vacation and (not contact_number or len(contact_number) < 10):
            # error general: no asociado a un solo campo
            raise serializers.ValidationError(
                "por favor, ingresa un número válido antes de irte a vacaciones"
            )

        return super().validate(attrs)

¿Cómo se muestran los errores en JSON?

• Al subir reglas cruzadas a validate, DRF agrupa el error como non-field error.
• El arreglo de mensajes aparece bajo la clave "non_field_errors".
• En pruebas con PATCH, si todo es correcto, la respuesta es 200 ok y los cambios se reflejan.

¿Qué habilidades y keywords refuerzas con estas validaciones?

Aplicar estas técnicas mejora la calidad de datos y la experiencia de uso en endpoints sensibles.

• Manejo de errores de validación con serializers.ValidationError y estado 400.
• Validación custom con validate_<campo> para email corporativo.
• Reglas de negocio cruzadas con validate(self, attrs) y errores tipo non-field errors.
• Mensajes de error claros y consistentes en JSON.
• Uso de booleanos true/false y verificación de longitud mínima para teléfonos.
• Buenas prácticas en serializer: retornar el valor si es válido y delegar a super().validate(attrs).
• Palabras clave: Django Rest Framework, serializer, serializers, JSON, validate_email, validate, ValidationError, dominio corporativo, contact_number, is_on_vacation, PATCH, 200 ok, endpoints, backend, API.

¿Tienes ideas para validar datos de pacientes? Comparte tus reglas personalizadas y ejemplos en los comentarios.