Herramientas CLI gratuitas de código abierto para simulación de API

Cuando simulas una API desde la línea de comandos, la licencia importa tanto como la lista de características. Un servidor de simulación del que puedes leer el código fuente, autoalojar y ejecutar en CI sin contar asientos es algo muy diferente de una simulación SaaS alojada detrás de un inicio de sesión. Esta guía cubre el lado de código abierto: herramientas que puedes clonar, inspeccionar y ejecutar de forma gratuita.

Cada herramienta aquí está disponible bajo una licencia permisiva (MIT o Apache-2.0), reside en un repositorio público de GitHub y puede autoalojarse sin necesidad de una cuenta. Ese es el filtro. Si deseas las opciones más pequeñas y de un solo binario, clasificadas por velocidad de inicio y tamaño de instalación, lee en su lugar las opciones de servidores de simulación ligeros; esta lista trata sobre el código fuente y el autoalojamiento, por lo que una plataforma autoalojable más pesada aún puede ganarse un lugar.

Para cada herramienta, obtendrás la licencia, el comando de instalación y ejecución que prueba su funcionamiento, en qué es mejor y cuáles son sus limitaciones. Si deseas un campo más amplio que incluya opciones comerciales, el resumen de las mejores herramientas de simulación de API y la visión general de las herramientas de simulación de API REST son más amplios.

Una nota rápida y honesta antes de la lista. Apidog no es de código abierto; es una plataforma comercial freemium. Aparece una vez al final como una alternativa integrada a estas herramientas, claramente etiquetada, no como una entrada de código abierto. Todo lo que se encuentra en las secciones numeradas a continuación es genuinamente de código abierto.

Qué hace que una herramienta de simulación CLI sea de código abierto

Tres cosas deciden si una herramienta pertenece a esta lista.

Licencia. El código fuente debe ser público bajo una licencia permisiva. Cada opción aquí es MIT o Apache-2.0, por lo que puedes leerlo, bifurcarlo y enviarlo dentro de tu propio producto sin una tarifa de licencia o un recuento de asientos.

Autoalojable. Lo ejecutas en tu portátil, en un contenedor o en tu propio servidor. Sin plano de control alojado, sin llamadas a casa, sin puerta de cuenta. Eso es lo que mantiene una simulación utilizable en un ejecutor de CI aislado.

Mantenido en abierto. Un repositorio público de GitHub con historial de confirmaciones real, problemas y lanzamientos. Las estrellas son una señal aproximada; las confirmaciones recientes y los lanzamientos etiquetados son la mejor.

Observa lo que no está en la lista: velocidad bruta o tamaño de instalación. Esos son el ángulo ligero. Aquí, una plataforma grande, basada en contenedores y autoalojable es válida siempre que el código fuente sea abierto y la licencia sea gratuita.

Prism (Stoplight)

Prism convierte un archivo OpenAPI o Postman en un servidor de simulación en vivo. Apúntalo a una especificación y servirá respuestas de ejemplo, validará las solicitudes entrantes contra el esquema y podrá ejecutarse como un proxy de validación frente a una API real. Licencia: Apache-2.0. Repositorio: stoplightio/prism.

npm install -g @stoplight/prism-cli
prism mock https://raw.githubusercontent.com/stoplightio/prism/master/examples/petstore.oas2.yaml

Ese comando inicia una simulación en http://127.0.0.1:4010 impulsada completamente por la especificación. GET /pets devuelve el ejemplo de tu documento OpenAPI; envía una carga útil incorrecta y Prism te indicará qué parte del esquema violaste.

Mejor en: simulación de contratos basada en especificaciones donde el archivo OpenAPI es la fuente de la verdad. El modo de proxy de validación es lo más destacado; detecta desviaciones entre tu especificación y tu API real.

Límites: las respuestas provienen de tus ejemplos y esquema, por lo que las simulaciones son tan ricas como la especificación. No hay un comportamiento con estado incorporado (no hay "crear y luego leerlo"). Es una herramienta Node, por lo que necesitas un entorno de ejecución Node.

Mockoon CLI

Mockoon es más conocido por su aplicación de escritorio, pero la CLI envía el mismo motor sin GUI, diseñado para CI y autoalojamiento. Diseñas un entorno (en la aplicación o a mano) o le entregas un archivo OpenAPI, y este sirve esa simulación. Licencia: MIT. Repositorio: mockoon/mockoon.

npm install -g @mockoon/cli
mockoon-cli start --data ./environment.json --port 3000

También puedes iniciar directamente desde un archivo OpenAPI con --data ./openapi.yaml. Agrega --watch para recargar en los cambios de archivo y --log-transaction para imprimir registros completos de solicitud/respuesta.

Mejor en: respuestas ricas y basadas en reglas sin escribir código. Mockoon admite plantillas de respuesta, reglas condicionales y modo proxy, por lo que un punto final puede devolver diferentes cuerpos según la solicitud. Diseñar visualmente en la aplicación y ejecutar sin cabeza a través de la CLI es una división limpia.

Límites: la ruta de autoría más agradable es la aplicación de escritorio, por lo que editar manualmente el JSON del entorno es complicado. La sintaxis de las plantillas dinámicas tiene su propia curva de aprendizaje.

json-server

json-server es la forma más rápida de simular una API REST. Dale un archivo JSON y generará rutas CRUD completas (GET, POST, PUT, PATCH, DELETE) con persistencia real en ese archivo. Licencia: MIT. Repositorio: typicode/json-server.

npx json-server db.json

Con un db.json que tiene una matriz "posts" de nivel superior, obtienes inmediatamente GET /posts, GET /posts/1, POST /posts y el resto, además de filtrado, clasificación y paginación a través de parámetros de consulta. Publica un nuevo registro y se escribe en el archivo; léelo de nuevo y ahí está.

Mejor en: desarrollo frontend antes de que exista el backend. Tiene estado de forma predeterminada, lo que Prism y la mayoría de las simulaciones basadas en especificaciones no tienen. Configuración cero, y npx significa que ni siquiera lo instalas.

Límites: es dogmático sobre la forma de REST, por lo que no coincidirá con una API personalizada arbitraria. No hay importación de OpenAPI; el archivo JSON es el contrato. No está destinado a pruebas de carga o comportamientos similares a los de producción.

WireMock

WireMock es el peso pesado de la simulación HTTP de código abierto, con millones de descargas al mes. Se ejecuta como un proceso independiente configurado a través de una API de administración JSON o desde archivos de stubs JSON, y maneja la coincidencia de solicitudes, las plantillas de respuesta, los escenarios con estado, la inyección de fallos y la grabación y reproducción. Licencia: Apache-2.0. Repositorio: wiremock/wiremock.

docker run -it --rm -p 8080:8080 wiremock/wiremock:latest
curl -X POST http://localhost:8080/__admin/mappings \
  -H 'Content-Type: application/json' \
  -d '{"request":{"method":"GET","url":"/hello"},"response":{"status":200,"body":"world"}}'

La primera línea inicia WireMock; la segunda registra un stub a través de su API de administración. Ahora curl http://localhost:8080/hello devuelve world. También puedes colocar archivos stub en un directorio mappings/ y montarlo en el contenedor.

Mejor en: escenarios de prueba complejos. Comportamiento con estado, retrasos y fallos para simular a un tercero inestable, y proxy-plus-record para capturar una API real y reproducirla más tarde. Esta es la herramienta cuando tu simulación necesita comportarse como la cosa real bajo prueba.

Límites: es una herramienta JVM, por lo que el contenedor o un tiempo de ejecución de Java es el precio de entrada. La superficie de configuración es grande; las simulaciones simples parecen exageradas. No hay un solo comando de "leer una especificación y listo" como lo tiene Prism.

MockServer

MockServer es un simulador y proxy HTTP(S) en un solo puerto, dirigido directamente a las pruebas de integración. Simula APIs, puede hacer proxy y registrar tráfico en vivo, y te permite inyectar fallos para probar cómo los maneja tu cliente. Las versiones recientes añaden soporte para HTTP/2, gRPC y WebSocket. Licencia: Apache-2.0. Repositorio: mock-server/mockserver.

docker run -d --rm -p 1080:1080 mockserver/mockserver
curl -X PUT 'http://localhost:1080/mockserver/expectation' \
  -H 'Content-Type: application/json' \
  -d '{"httpRequest":{"path":"/order"},"httpResponse":{"body":"{\"status\":\"ok\"}"}}'

El PUT registra una "expectativa"; después de eso, curl http://localhost:1080/order devuelve tu JSON. Los clientes de MockServer (Java, JavaScript, Ruby y otros) te permiten establecer las mismas expectativas desde dentro de tu código de prueba en lugar de hacerlo a través de curl.

Mejor en: simulación y proxy en el mismo lugar, además de inyección de fallos. Si necesitas verificar que se realizó una solicitud específica un número específico de veces, la API de verificación de MockServer está diseñada para eso. Ideal para pilas con gran uso de JVM. Consulta nuestro artículo Alternativas a MockServer si no se ajusta del todo.

Límites: al igual que WireMock, se basa en JVM y el JSON de expectativas es verboso. La superposición con WireMock es real; elige uno según la biblioteca cliente que se adapte a tu pila de pruebas.

Microcks

Microcks es la opción de plataforma, y es un proyecto en incubación de Cloud Native Computing Foundation. Convierte proyectos OpenAPI, AsyncAPI, gRPC, GraphQL, colecciones de Postman y SoapUI en simulaciones en vivo, y reutiliza esos mismos contratos para ejecutar pruebas de conformidad contra tu implementación real. Cubre protocolos asíncronos y basados en eventos, no solo HTTP. Licencia: Apache-2.0. Repositorio: microcks/microcks.

docker run -d --name microcks -p 8585:8080 quay.io/microcks/microcks-uber:latest

Eso ejecuta la imagen todo en uno; abre http://localhost:8585 e importa una especificación para obtener puntos finales de simulación. La microcks-cli complementaria controla un servidor en ejecución desde CI:

microcks-cli import 'petstore.yaml:true' \
  --microcksURL=http://localhost:8585/api \
  --keycloakClientId=... --keycloakClientSecret=...

Mejor en: equipos que quieren un catálogo gobernado de simulaciones en muchas APIs y protocolos, con pruebas de contrato incorporadas. La simulación asíncrona/basada en eventos (Kafka, MQTT y similares) es rara en este espacio.

Límites: este es un servidor, no un único binario. Una advertencia importante: la microcks-cli activa pruebas e importa artefactos contra una instancia de Microcks en ejecución; no sirve simulaciones por sí misma. Por lo tanto, la CLI es un cliente, y todavía ejecutas la plataforma. Para una simulación local única, eso es más pesado que Prism o json-server.

Un aparte honesto: Apidog

Apidog no es de código abierto, por lo que no obtiene un espacio numerado aquí. Pero si has notado que las herramientas anteriores resuelven diferentes partes (simulaciones basadas en especificaciones, CRUD con estado, pruebas de contrato) y prefieres no unirlas, vale la pena mencionarlo. Apidog es una plataforma freemium cuyo nivel gratuito incluye simulación, y apidog mock en la apidog-cli te permite gestionar las expectativas de simulación desde el terminal junto con el diseño, las pruebas y la documentación en un solo proyecto. Smart mock genera automáticamente valores de campo realistas a partir de tu esquema, por lo que no tienes que escribir manualmente los cuerpos de ejemplo.

La compensación es clara: obtienes un flujo de trabajo integrado y un nivel gratuito en lugar de código abierto y autoalojamiento. Si el código abierto o el autoalojamiento aislado son un requisito estricto, una de las seis herramientas anteriores es tu respuesta. Si un bucle integrado de diseño a simulación importa más, Apidog es la alternativa a pegar varias herramientas.

Cómo elegir

Elige por la forma, no por la popularidad. Para una simulación que lea tu archivo OpenAPI y lo haga cumplir, comienza con Prism. Para un CRUD con estado antes de que el backend esté listo, json-server gana en velocidad. Para escenarios de prueba ricos con fallos y grabación y reproducción, WireMock o MockServer; elige por la biblioteca cliente. Para un catálogo compartido de múltiples protocolos con pruebas de contrato, Microcks. Para saber qué forma se adapta a cada situación, la guía de casos de uso de simulación de API mapea herramientas a escenarios.

Conclusión

Las herramientas de simulación CLI de código abierto te brindan un servidor de simulación que puedes leer, autoalojar y ejecutar en CI de forma gratuita. Prism y json-server cubren los casos comunes con un solo comando; WireMock y MockServer manejan los escenarios de prueba difíciles; Microcks lo escala a un catálogo gobernado entre protocolos. Las seis son MIT o Apache-2.0, todas autoalojables, todas en GitHub público.

Si prefieres gestionar las simulaciones junto a tu diseño de API, pruebas y documentación sin unir herramientas separadas, descarga Apidog y prueba apidog mock en la versión gratuita. No es de código abierto, pero es un único lugar para ejecutar todo el ciclo desde la línea de comandos hasta CI.