Elegir un ejecutor de pruebas CLI para tu pipeline depende de dos cosas: dónde vive hoy la definición de tus APIs y qué necesitas automatizar en CI. Si tu equipo ya usa Insomnia, inso encaja de forma natural. Si buscas una plataforma integrada para diseñar, simular, documentar y probar APIs, Apidog CLI cambia el flujo de trabajo.
Qué es cada herramienta
inso es el CLI de Insomnia, el cliente API de código abierto de Kong. Desde la terminal permite:
- Ejecutar colecciones de solicitudes.
- Ejecutar suites de pruebas.
- Hacer linting de especificaciones OpenAPI.
inso lee los mismos datos que usa la aplicación de escritorio de Insomnia. Si defines solicitudes en la GUI, puedes ejecutarlas en CI sin abrir la interfaz gráfica.
Apidog CLI es el ejecutor de terminal para Apidog, una plataforma API todo en uno para diseño, depuración, simulación, documentación y pruebas. El CLI ejecuta escenarios y colecciones de un proyecto Apidog, admite pruebas basadas en datos y genera informes en varios formatos.
La diferencia práctica es esta:
-
insoes un ejecutor y linter enfocado en el ecosistema Insomnia. - Apidog CLI es la capa de automatización de una plataforma API más amplia.
Apidog CLI vs inso: comparación rápida
| Capacidad | inso / Insomnia CLI | Apidog CLI |
|---|---|---|
| Instalación |
brew install inso, Docker kong/inso o descarga directa |
Instalador de Apidog CLI |
| Qué ejecuta | Suites de prueba y colecciones de solicitudes | Escenarios de prueba y colecciones de un proyecto |
| Fuente de datos | Carpeta .insomnia o base de datos local de Insomnia |
Proyecto sincronizado en Apidog |
| Pruebas basadas en datos | No como flag nativo | Sí, con -d y datasets CSV/JSON |
| Informes | Salida en consola y código de salida | CLI, HTML, JSON e informes en la nube con --upload-report
|
| Linting OpenAPI | Sí, con inso lint spec vía Spectral |
No tiene linter OpenAPI autónomo |
| Recursos/rama como código | No | Sí, gestiona endpoints, esquemas, entornos, ramas y solicitudes de fusión |
| Integración de plataforma | Cliente Insomnia | Diseño, simulación, documentación y pruebas en una plataforma |
| Código abierto | Sí | Plataforma comercial |
| Precios | Gratis | Nivel gratuito disponible |
Instalación
Instalar inso
Los métodos habituales son Homebrew, Docker o descarga directa:
# Homebrew
brew install inso
# Docker
docker pull kong/inso:latest
La imagen Docker es útil en CI porque evita instalar dependencias adicionales en el runner.
Instalar Apidog CLI
Apidog CLI se instala desde la página de descarga de Apidog. Después, ejecuta escenarios que ya existen dentro de tu proyecto Apidog.
Para configurar el CLI paso a paso, consulta:
Cómo ejecuta pruebas cada herramienta
Esta es la diferencia más importante en la práctica.
Ejecutar pruebas con inso
inso referencia suites, colecciones y especificaciones por nombre. Normalmente lee desde:
- Una carpeta
.insomniagenerada por Git Sync. - La base de datos local de la aplicación Insomnia.
- Una ubicación personalizada con
--workingDiro--src.
Ejemplos:
inso run test "Smoke Suite" --env "CI"
inso run collection "User API" --env "Staging"
inso script seed-data --env env_staging
Este modelo funciona bien si tu equipo confirma la carpeta .insomnia en Git y la trata como fuente de verdad. El punto a vigilar es que los nombres deben mantenerse estables, porque los comandos dependen de ellos.
Ejecutar pruebas con Apidog CLI
Apidog CLI ejecuta escenarios o colecciones existentes en un proyecto Apidog. El CLI se autentica y ejecuta la definición sincronizada del proyecto.
Ejemplo:
apidog run -t "<scenario-or-collection>" -e "<environment>"
Este enfoque evita mantener una carpeta local sincronizada manualmente. Lo que el equipo construye en la interfaz de Apidog es lo que se ejecuta en CI.
Pruebas basadas en datos
Si necesitas ejecutar el mismo flujo con muchas entradas, Apidog CLI tiene una ventaja directa.
Con Apidog puedes pasar un dataset CSV o JSON usando -d:
apidog run -t "Checkout Flow" -e "Staging" -d ./datasets/orders.csv
Cada fila del dataset se convierte en una iteración con sus propias variables. Esto permite cubrir múltiples casos sin duplicar escenarios.
Más detalles: pruebas basadas en datos con Apidog CLI.
inso no expone un flag equivalente para datasets. Puedes parametrizar con entornos o crear scripts externos que iteren sobre archivos CSV/JSON, pero no es una capacidad nativa del CLI.
Informes en CI
Ambas herramientas pueden fallar el pipeline mediante códigos de salida. La diferencia está en los artefactos que generan.
Informes con Apidog CLI
Apidog CLI puede generar reportes en:
- CLI
- HTML
- JSON
- Nube, usando
--upload-report
Ejemplo:
apidog run -t "Smoke Suite" -e "CI" -r html,json --upload-report
Usa HTML si quieres guardar un artefacto legible para el equipo. Usa JSON si necesitas procesar resultados con otra herramienta.
Guía relacionada: informes de prueba de Apidog CLI.
Informes con inso
inso imprime los resultados en consola y devuelve un código de salida. Para muchos pipelines eso es suficiente:
inso run test "Smoke Suite" --env "CI"
Si necesitas un reporte HTML o un informe alojado sin construir tooling adicional, Apidog CLI ofrece más opciones listas para usar.
Linting OpenAPI
Aquí inso tiene una ventaja clara.
inso incluye linting de especificaciones OpenAPI mediante Spectral:
inso lint spec "Payments API"
inso export spec "Payments API" --output openapi.yaml
Esto es útil si tu equipo trabaja con un flujo spec-first y quiere bloquear merges cuando una especificación no cumple la guía de estilo.
Apidog CLI no tiene un comando autónomo equivalente a lint. Apidog valida especificaciones al importarlas, pero eso no reemplaza un paso de linting OpenAPI con reglas personalizadas en CI.
Si el linting con Spectral es un requisito obligatorio y quieres hacerlo desde la misma CLI que ejecuta pruebas, inso encaja mejor.
Recursos y ramas como código
Apidog CLI puede gestionar recursos de API desde la terminal, incluyendo:
- Importación de OpenAPI.
- Endpoints.
- Esquemas.
- Entornos.
- Ramas.
- Solicitudes de fusión.
Esto permite automatizar cambios en el diseño de la API y conectarlos con las ejecuciones de prueba.
inso, en cambio, se mantiene enfocado en ejecutar pruebas, colecciones y linting/exportación de especificaciones. No actúa como CLI de gestión de recursos para editar endpoints o gestionar ramas.
Integración de plataforma, código abierto y precios
inso forma parte del ecosistema de Insomnia, que es de código abierto. Es una buena opción para equipos que ya usan Insomnia, quieren un ejecutor gratuito y valoran el linting OpenAPI integrado.
También conviene tener contexto histórico: Insomnia 8 introdujo en 2023 una cuenta de inicio de sesión/nube obligatoria que generó críticas, además de incidentes de migración y pérdida de datos. Si necesitas revisar ese tema, consulta:
Apidog es una plataforma comercial con nivel gratuito. Su propuesta es integrar diseño, simulación, documentación, depuración y pruebas en un solo espacio de trabajo.
Para una comparación más amplia:
Si quieres probar primero contra una API real:
Ejemplo de integración en CI
El patrón para ambas herramientas es similar:
- Instalar el CLI.
- Autenticar o apuntar a la fuente de datos.
- Ejecutar la suite o escenario.
- Dejar que el código de salida controle el estado del pipeline.
Ejemplo genérico en YAML:
# inso en CI
- run: brew install inso
- run: inso run test "Smoke Suite" --env "CI"
# Apidog CLI en CI
- run: apidog run -t "Smoke Suite" -e "CI" -r html,json
Para Apidog CLI, revisa estas guías si necesitas configurar autenticación, caché o carga de informes:
Veredicto
Elige inso si:
- Tu equipo ya trabaja con Insomnia.
- Confirmas una carpeta
.insomniaen Git. - Quieres ejecutar pruebas y linting OpenAPI con Spectral desde la misma CLI.
- Prefieres un ejecutor gratuito y alineado con el ecosistema Insomnia.
Elige Apidog CLI si:
- Quieres una plataforma integrada para diseño, simulación, documentación y pruebas.
- Necesitas pruebas basadas en datos con
-d. - Quieres reportes CLI, HTML, JSON o alojados.
- Necesitas gestionar recursos y ramas de API como código.
- Prefieres ejecutar en CI los mismos escenarios que el equipo mantiene en el proyecto Apidog.
Apidog CLI no reemplaza a Spectral como linter OpenAPI autónomo. A cambio, ofrece un flujo más integrado: lo que diseñas en la plataforma es lo que pruebas en automatización.
Si ya tienes una configuración con Insomnia CLI, puedes revisar cómo migrarla aquí: migrar de inso / Insomnia CLI a Apidog CLI.
¿Listo para comparar con tu propia API? Descarga Apidog y ejecuta un escenario real en tu entorno.
Top comments (0)