Construir servicios fiables va más allá de escribir código limpio; requiere una estrategia de pruebas sólida que valide el comportamiento de la aplicación en escenarios reales. Mientras que las pruebas unitarias verifican la lógica de negocio en aislamiento, las pruebas de integración validan la interacción entre componentes cuando se consumen dependencias externas como bases de datos, proveedores cloud o APIs de terceros.
En este artículo explico cómo combinar Testcontainers y Mockoon para crear un entorno de pruebas realista para una API .NET. Testcontainers permite arrancar componentes de infraestructura reales y desechables dentro de contenedores ligeros, y Mockoon facilita la simulación de APIs externas para controlar respuestas, probar condiciones de error y validar casos límite.
Contexto de la API .NET. Para el ejemplo asumimos una API mínima que expone un endpoint para enviar SMS usando el servicio Twilio. La API usa el Options Pattern para manejar configuraciones como la BaseUrl de Twilio según el entorno, lo que facilita reemplazar la URL real por la del mock durante las pruebas.
Implementación resumida del servicio. El servicio Twilio se registra en el contenedor de dependencias y consume un HttpClient configurado con las credenciales y la BaseUrl obtenida desde las opciones. En tiempo de ejecución la API apunta al servicio Twilio real, pero en el contexto de pruebas la BaseUrl se reasigna para apuntar al contenedor Mockoon.
Creación del mock con Mockoon. Mockoon permite definir respuestas estáticas y reglas para simular el endpoint de Twilio. En el ejemplo se definen al menos dos respuestas: una que devuelve Ok para peticiones válidas y otra que devuelve BadRequest para casos de prueba que validan manejos de error. La definición se exporta a JSON que sirve como entrada para el servidor Mockoon.
Construcción de la imagen Docker del mock. Con una imagen base de Node se instala la CLI de Mockoon, se copia el archivo JSON y se expone el puerto donde correrá el mock. El contenedor resultante expone la API simulada que las pruebas consumirán.
Integración con Testcontainers. Testcontainers es una librería que facilita ejecutar contenedores Docker desde el proceso de pruebas, gestionando ciclo de vida y puertos. En el proyecto de pruebas se crea una clase que arranca el contenedor Mockoon antes de ejecutar los tests y obtiene el puerto mapeado para inyectarlo en las opciones de Twilio de la WebApplicationFactory.
Ejemplo de WebApplicationFactory. Se implementa una fábrica personalizada que crea y arranca el contenedor Mockoon y luego sobreescribe la opción BaseUrl para que apunte al host y puerto del contenedor. De este modo, cuando la API dentro del entorno de pruebas haga llamadas HTTP al servicio Twilio usará el mock.
Configuración del ciclo de vida de las pruebas. Usando las facilidades del framework de pruebas como NUnit se crea un setup global que instancia la WebApplicationFactory, arranca servicios y se asegura de liberar recursos al finalizar la suite de pruebas.
Casos de prueba. Con la WebApplicationFactory es sencillo crear un HttpClient que consuma la API minimal. Se definen escenarios como enviar un mensaje que devuelve éxito y enviar un mensaje que provoca un error, verificando el comportamiento de la API y las respuestas HTTP esperadas. Gracias a Testcontainers las pruebas tocan un servicio HTTP real en un contenedor, lo que aumenta la fiabilidad respecto a usar solo mocks en memoria.
Beneficios y buenas prácticas. Combinar Testcontainers y Mockoon aporta realismo sin sacrificar velocidad ni repetibilidad. Testcontainers asegura dependencias containerizadas similares a producción y Mockoon aporta flexibilidad para simular distintos escenarios del proveedor externo. Mantener las definiciones de mocks versionadas y automatizar la construcción de la imagen del mock facilita la integración continua y la reproducibilidad.
Sobre Q2BSTUDIO. En Q2BSTUDIO somos una empresa de desarrollo de software y aplicaciones a medida especializada en soluciones escalables y seguras. Ofrecemos servicios de software a medida y desarrollo de aplicaciones adaptadas al negocio, además de arquitecturas en la nube y modernización de sistemas. Si necesita una solución a medida puede conocer nuestras capacidades en desarrollo en la página de aplicaciones a medida.
Además, en Q2BSTUDIO complementamos las pruebas y la calidad con servicios cloud y despliegues seguros para entornos AWS y Azure. Para más información sobre migración y servicios cloud visite nuestra sección de servicios cloud aws y azure. También ofrecemos consultoría en inteligencia artificial, agentes IA y soluciones de IA para empresas, ciberseguridad y auditorías de pentesting, servicios de inteligencia de negocio y Power BI para extraer valor de los datos.
Palabras clave y cierre. Aplicaciones a medida, software a medida, inteligencia artificial, ciberseguridad, servicios cloud aws y azure, servicios inteligencia de negocio, ia para empresas, agentes IA y power bi son áreas en las que Q2BSTUDIO aporta experiencia para acompañar proyectos desde el desarrollo hasta la puesta en producción y la supervisión. Adoptar estrategias de pruebas que incluyan Testcontainers y Mockoon es un paso importante para garantizar que las integraciones con terceros sean robustas y predecibles en producción.
