Crear APIs profesionales con confianza es más simple con Django REST Framework. Basado en Python y apoyado en Django, permite desarrollar APIs rápidas, sencillas y escalables reutilizando modelos, admin y seguridad de Django, y añadiendo lo que hacía falta para APIs REST.
¿Qué es Django REST Framework y por qué usarlo con Django?
Django REST Framework se construye sobre Django y reutiliza su ecosistema: modelos, admin y autenticación. Encima, añade vistas, serialización y herramientas específicas para servicios REST. Así, el flujo es más ágil, manteniendo buenas prácticas y escalabilidad.
- Usa Python y el framework web Django.
- Añade funcionalidades REST que Django no traía por defecto.
- Aprovecha la comunidad de Python para crecer el proyecto.
¿Cómo instalar y preparar el entorno con Python, venv y pip?
Antes de escribir código, valida tu entorno. La clave es confirmar Python, crear un entorno virtual y instalar las librerías con pip para trabajar de forma aislada y reproducible.
¿Cómo comprobar la versión de Python?
Verifica que tienes Python y cuida la compatibilidad con versiones recientes (ejemplo: 3.12), que suelen traer correcciones de bugs y seguridad.
- Mantén tu código compatible con la última versión estable.
- Evita depender de versiones obsoletas.
¿Cómo crear y activar un entorno virtual venv?
Aísla dependencias por proyecto. Crea el entorno y actívalo; verás el nombre al inicio del prompt.
python3 -m venv vm
ls
source vm/bin/activate
- Confirma la carpeta creada con ls.
- En Windows, activa el entorno según tu sistema.
¿Cómo instalar Django y preparar Django REST Framework?
Instala las librerías con pip. Tras instalar Django, tendrás disponible el comando django-admin.
- Instala las dependencias que uses con pip.
- django-admin habilita utilidades para crear proyectos.
¿Cómo configurar el proyecto, dependencias y servidor de desarrollo?
Con las librerías listas, crea el proyecto base, fija versiones en un requirements y habilita REST Framework en Django. Finaliza corriendo el servidor de desarrollo para validar tu entorno.
¿Cómo crear el proyecto con django-admin startproject?
Crea el proyecto “doctor app” en el directorio actual. El punto indica: crear en el folder donde estás ubicado.
django-admin startproject "doctor app" .
- Abre la carpeta en tu editor para revisar archivos.
- El objetivo: una app de manejo de citas de un médico.
¿Cómo fijar versiones con requirements y pip freeze?
Evita sorpresas al desplegar en otro servidor. Congela versiones en un archivo requirements.
pip freeze
pip freeze | grep django
- Copia “Django” y “django-rest-framework” con su versión al requirements.txt.
- Prevenir cambios inesperados por actualizaciones mantiene tu app estable.
¿Cómo activar REST Framework y optimizar el editor?
Agrega REST Framework en INSTALLED_APPS dentro de settings.py para habilitar sus componentes.
# settings.py
INSTALLED_APPS = [
# ...
"rest_framework",
]
- Revisa la documentación oficial para guías, vistas genéricas y referencia.
- Instala extensiones del editor: Python (Microsoft) y Black (Microsoft) como formatter.
- Beneficios: coloreado, debug fácil y formateo automático con PEP 8.
- Mantener un formato consistente evita “ruido” en los cambios de código.
¿Cómo ejecutar el servidor y crear nuevos endpoints?
Levanta el servidor de desarrollo y valida que Django quedó bien configurado.
python manage.py runserver
- Abre la URL y verifica el mensaje de bienvenida de Django.
- Usa el servidor para probar cada vez que agregues o modifiques endpoints.
¿Te animas a empezar con la API de citas médicas? Comparte en comentarios qué recursos vas a modelar: por ejemplo: paciente, con operaciones para crear, listar y modificar.
