Desarrollo Backend y APIs · BAC-113

FastAPI: APIs asíncronas y documentadas

APIs asíncronas con FastAPI: tipado Pydantic, documentación automática, dependencias y concurrencia

Bajo demanda Avanzado 7 módulos · 33 clases

Formato asíncrono Desarrollo FastAPI, Python, Docker

DESARROLLO

Lo que aprenderás

Declarar contratos con modelos Pydantic aprovechando la validación y la conversión automáticas
Distinguir rutas síncronas de asíncronas y evitar bloqueos del bucle de eventos
Componer el sistema de inyección de dependencias para sesiones, autenticación y configuración
Generar y personalizar el esquema OpenAPI que FastAPI publica a partir del código
Acceder a base de datos de forma asíncrona controlando sesiones y transacciones
Ejecutar trabajo en segundo plano y llamadas concurrentes a servicios externos con clientes asíncronos
Empaquetar el servicio en Docker con Uvicorn y ajustar el número de procesos

Contenido del curso

7 módulos · 33 clases en vídeo · práctica guiada en cada módulo

Módulo 1 · Presentación y entorno 4 clases

Qué diferencia a FastAPI de otros marcos Python
Instalación, Uvicorn y recarga en desarrollo
Primera ruta con tipos y documentación automática
El proyecto que se construirá a lo largo del curso

Módulo 2 · Contratos con Pydantic 5 clases

Modelos, tipos y valores por defecto
Validadores propios y mensajes de error
Modelos de entrada y de salida separados
Respuestas anidadas y listas tipadas
Configuración de la aplicación con Settings

Módulo 3 · Rutas, parámetros y errores 5 clases

Parámetros de ruta, de consulta y de cuerpo
Enrutadores y organización por dominio
Códigos de estado y excepciones HTTP
Manejadores de error globales
Cabeceras, cookies y respuestas personalizadas

Módulo 4 · Inyección de dependencias 5 clases

Depends: qué resuelve y cuándo usarlo
Dependencias con estado y limpieza posterior
Dependencias anidadas y reutilización
Autenticación como dependencia
Sobrescribir dependencias en pruebas

Módulo 5 · Asincronía real 5 clases

El bucle de eventos explicado con ejemplos
Rutas def frente a rutas async def
Detectar llamadas bloqueantes en código asíncrono
Llamadas concurrentes a servicios externos
Tareas en segundo plano

Módulo 6 · Persistencia asíncrona 4 clases

Sesiones asíncronas con SQLAlchemy
Transacciones y control de errores
Migraciones del esquema
Consultas concurrentes y límites del grupo de conexiones

Módulo 7 · Pruebas y empaquetado 5 clases

Pruebas asíncronas de endpoints
Simular servicios externos en pruebas
Imagen Docker del servicio
Comprobaciones de salud, procesos y variables de entorno
Proyecto de cierre: API de agregación desplegada

Requisitos

Python avanzado: tipos, decoradores, generadores y programación asíncrona con async y await
Experiencia previa construyendo APIs REST con cualquier marco
Manejo básico de Docker para levantar contenedores y componer servicios

Descripción

Una API que consulta tres servicios externos y espera secuencialmente desaprovecha el tiempo de espera. La concurrencia asíncrona resuelve ese caso, pero mal aplicada introduce bloqueos silenciosos que solo aparecen bajo carga. FastAPI facilita el camino correcto uniendo tipado, validación y asincronía, siempre que se entienda qué ocurre por debajo en el bucle de eventos.

El curso construye una API de agregación que consulta varias fuentes y persiste resultados. Se define el contrato con Pydantic, se organiza la aplicación con enrutadores y dependencias, se accede a la base de datos de forma asíncrona y se comparan mediciones entre implementaciones bloqueantes y no bloqueantes. Se cierra empaquetando el servicio en Docker con Uvicorn y comprobaciones de salud.

El resultado es un servicio documentado automáticamente, con pruebas asíncronas y con criterio sobre cuándo la asincronía aporta y cuándo solo complica. Continúa de forma natural hacia arquitectura de microservicios, mensajería con colas o seguridad de APIs siguiendo el OWASP API Top 10.

¿Para quién es este curso?

Perfiles backend Python que construyen APIs que dependen de varios servicios externos
Equipos que migran servicios síncronos y necesitan medir si la asincronía compensa
Desarrolladoras y desarrolladores que quieren documentación de API generada desde el propio código