Ambas herramientas residen en tu terminal, ambas entienden OpenAPI, y ambas aparecen cuando un equipo decide que quiere un flujo de trabajo de línea de comandos para sus especificaciones de API. Ahí es donde termina la superposición. Resuelven problemas adyacentes desde direcciones opuestas, y elegir la incorrecta significa o bien luchar contra un linter que no ejecuta pruebas o recurrir a una plataforma cuando todo lo que querías era una verificación estructural rápida.
Esta es una comparación directa, a nivel de comando, entre la CLI de Apidog y la CLI de Redocly. Sin argumentos falsos. La CLI de Redocly es un software de código abierto genuinamente bueno, y verás exactamente dónde destaca antes de que se emita cualquier veredicto.
Veredicto TL;DR
Resuelven problemas superpuestos pero diferentes.
Redocly CLI (@redocly/cli, binario redocly) es un especialista en OpenAPI que prioriza el código: lint con conjuntos de reglas personalizados, agrupa especificaciones multifichero, las divide y une, y construye documentos HTML independientes. Es de código abierto, se rige por configuración y es nativo de la terminal. Si tu especificación es la fuente de verdad y reside en git, esta es la gobernanza que ejecutas desde la línea de comandos.
Apidog CLI (apidog-cli, binario apidog) es la interfaz de línea de comandos de una plataforma API todo en uno. Importa y exporta definiciones contra un proyecto y ejecuta escenarios de prueba de API en CI con informes JUnit y HTML. Se gana su lugar cuando la misma especificación también necesita ser simulada, probada y documentada en un solo espacio de trabajo en lugar de unirse con herramientas separadas.
Elige Redocly CLI cuando quieras un linter, bundler y constructor de documentos ligero y de código abierto que ejecutes puramente desde la terminal. Elige Apidog cuando prefieras tener una única herramienta para todo el ciclo de vida de la API. También pueden trabajar lado a lado, y la última sección explica cómo.
Dos filosofías diferentes
Redocly CLI se centra en los archivos y prioriza el código. El documento OpenAPI en disco es sobre lo que actúas. Cada comando, redocly lint, redocly bundle, redocly build-docs, toma una ruta a un archivo y realiza su trabajo localmente, sin cuenta ni servidor involucrados. El comportamiento se configura mediante un archivo redocly.yaml que se guarda en el repositorio junto a la especificación. Este modelo se adapta a equipos que tratan su descripción de API como código fuente: revisado en pull requests, controlado en CI, versionado como todo lo demás. La Especificación OpenAPI es el contrato, y Redocly CLI es el conjunto de herramientas que lo supervisa.
Apidog se centra en proyectos y prioriza la plataforma. Diseñas endpoints, construyes servidores mock y elaboras escenarios de prueba visualmente en la aplicación de escritorio o web, y la CLI es la interfaz sin cabeza para un subconjunto de ese trabajo. La mayoría de los comandos de la CLI operan contra un proyecto de Apidog en el servidor, identificado por un ID de proyecto y autenticado con un token de acceso. La especificación no es un archivo suelto que verificas en su lugar; se importa a un espacio de trabajo vivo donde también puede ser simulada, probada y publicada como documentación. Un entorno, muchos trabajos.
Ninguna filosofía es incorrecta. Se adaptan a equipos diferentes. La distinción honesta es esta: Redocly te ofrece una CLI enfocada y de código abierto para la gobernanza de especificaciones, y Apidog te ofrece una CLI hacia una plataforma más amplia.
Comando por comando
Aquí está la parte importante, mapeada tarea por tarea. Cada comando a continuación es real; nada es inventado.
| Tarea | CLI de Redocly | CLI de Apidog |
|---|---|---|
| Validar / lint | redocly lint con conjuntos de reglas integrados y personalizados a través de redocly.yaml |
Valida la estructura solo en la importación; sin comando lint independiente, sin conjuntos de reglas personalizados |
| Agrupar especificación multifichero | redocly bundle openapi.yaml |
apidog export ... --format openapi (consolida en un solo archivo) |
| Dividir un archivo en muchos | redocly split |
No disponible |
| Unir múltiples archivos | redocly join (experimental) |
No disponible |
| Construir docs HTML estáticos | redocly build-docs openapi.yaml -o docs.html |
apidog export ... --format html |
| Ejecutar pruebas de API en CI | No disponible | apidog run ... -r "cli,html,json,junit" |
| Servidor mock | No disponible | Integrado en la aplicación (no es un comando de CLI) |
| Reglas lint personalizadas | Sí, reglas estilo Spectral en redocly.yaml |
No |
| Informes de prueba de CI (JUnit/HTML) | No disponible | Sí, a través de -r/--reporters |
| Código abierto | Sí | No (freemium) |
Algunas de estas filas merecen una nota clara, porque la diferencia es real y el artículo sería deshonesto sin ella.
El linting es el terreno de Redocly, no de Apidog. Redocly CLI verifica OpenAPI, AsyncAPI, Arazzo y Open-RPC contra conjuntos de reglas configurables, y puedes crear tus propias reglas. Apidog valida la estructura de una definición cuando la importas, pero no hay un comando apidog lint, ni una configuración al estilo redocly.yaml, ni forma de escribir reglas personalizadas de guía de estilo a través de la CLI. Si tu objetivo es una guía de estilo que priorice el código y se aplique en la terminal, Redocly es la herramienta. Apidog no compite aquí, y decir lo contrario sería incorrecto.
Dividir y unir pertenecen a Redocly. redocly split descompone una descripción en una estructura de múltiples archivos, y redocly join (experimental) fusiona varios archivos en uno. Apidog no tiene ninguno de estos comandos. Su importación resuelve $refs multifichero en recursos unificados, y su exportación emite un único archivo consolidado, pero eso no es lo mismo que una utilidad independiente de dividir/unir que ejecutas en archivos sueltos.
La ejecución de pruebas y el mocking pertenecen a Apidog. Redocly CLI no ejecuta pruebas de API ni aloja un servidor mock; eso está fuera de su alcance por diseño. Apidog ejecuta escenarios de prueba sin interfaz gráfica con apidog run y produce informes JUnit, HTML, JSON y CLI para tu pipeline, y el mocking es una característica de primera clase de la plataforma (creado en la aplicación, no manejado desde la CLI).
Ambos construyen documentos HTML desde la terminal. redocly build-docs produce un archivo HTML Redoc independiente. apidog export --format html escribe un archivo de documentos HTML desde tu proyecto. Diferentes motores, mismo resultado en la terminal.
Comandos reales de la CLI de Redocly
Instálalo globalmente, o salta la instalación y ejecútalo a través de npx:
npm install -g @redocly/cli@latest
# o, sin instalación global:
npx @redocly/cli@latest lint openapi.yaml
Verifica una especificación. Con un redocly.yaml presente, esto aplica el conjunto de reglas elegido (minimal, recommended, recommended-strict, spec, o reglas personalizadas):
redocly lint openapi.yaml
Si solo quieres una validación estructural simple, del tipo que solía hacer la ya obsoleta swagger-cli, configura redocly.yaml solo con la regla spec y ejecuta el mismo redocly lint. Redocly publica una guía de migración desde swagger-cli porque Redocly CLI es su sucesor designado. El repositorio de swagger-cli ahora incluye un aviso de obsolescencia por la misma razón; esa antigua herramienta solo validaba y agrupaba, nunca verificaba con reglas de estilo.
Agrupa una definición multifichero en un solo archivo, siguiendo cada $ref:
redocly bundle openapi.yaml --output bundled.json
Si vienes de swagger-cli, los flags se mapean limpiamente: -o/--outfile se convierte en --output, -t/--type se convierte en --ext (json, yaml o yml), y -r/--dereference se convierte en -d/--dereferenced.
Construye documentación HTML independiente con Redoc:
redocly build-docs openapi.yaml -o docs.html
Divide una única descripción en un diseño multifichero, lo inverso de agrupar:
redocly split openapi.yaml --outDir ./split-spec
Para una visión más amplia de cómo Redocly se compara con otras herramientas en esta categoría, la guía de configuración de linter OpenAPI cubre Spectral, Redocly y Vacuum lado a lado, y el resumen de alternativas a Redocly cubre específicamente la plataforma de documentos.
Comandos reales de la CLI de Apidog
Instala la CLI y autentícate con un token desde la aplicación (avatar, luego Configuración de la cuenta, luego Token de acceso a la API):
npm install -g apidog-cli@latest
apidog login --with-token <TOKEN>
El token se guarda en ~/.apidog/config.toml. No lo imprimas ni lo subas al repositorio.
Importa una definición a un proyecto. Esto valida la estructura y la ingiere, resolviendo los $refs multifichero en recursos unificados:
apidog import --project 123456 --format openapi --file ./openapi.json
La importación acepta más que OpenAPI: Postman, HAR, Insomnia, JMeter, WSDL, YApi, RAP2, apiDoc, Hoppscotch, Markdown, JSON Schema y el propio formato de Apidog.
Exporta un único archivo consolidado, actualizando opcionalmente la versión de OpenAPI. Esto es agrupar más un incremento de versión opcional en un solo paso:
apidog export --project 123456 --format openapi --output ./openapi.json --oas-version 3.1
Exporta documentos HTML directamente desde el proyecto:
apidog export --project 123456 --format html --output ./docs.html
Ejecuta un escenario de prueba en CI y emite informes que tu pipeline puede leer:
apidog run --project 123456 -t <testScenarioId> -e <environmentId> -r "cli,html,json,junit"
También puedes ejecutar completamente offline desde un archivo de colección exportado, sin necesidad de proyecto ni token:
apidog run ./collection.apidog-cli.json
La referencia completa de los flags, incluyendo --out-dir, -n/--iteration-count, -d/--iteration-data y --env-var, se encuentra en la guía completa de la CLI de Apidog. La documentación oficial de la CLI de Apidog cubre la instalación y cada comando de recursos. Para una comparación de runners de CI, consulta Apidog CLI vs Newman y Bruno CLI vs Apidog CLI.
Cuándo elegir la CLI de Redocly
Recurre a la CLI de Redocly cuando la especificación sea tu fuente de verdad y quieras gestionarla como código.
Quieres un linter real con reglas personalizadas. El comando lint de Redocly y su configuración redocly.yaml son la característica distintiva: elige un conjunto de reglas incorporado o escribe el tuyo propio, y aplica convenciones de nomenclatura, campos requeridos y estilo de la casa en cada commit. Nada en la CLI de Apidog se compara con esto. Si la gobernanza de estilo nativa de la terminal es la tarea, Redocly es la respuesta.
Quieres código abierto sin necesidad de cuenta. La CLI se ejecuta completamente en tu máquina o en el runner de CI. Sin inicio de sesión, sin token, sin llamadas al servidor para lint, bundle, split o build-docs. Para entornos aislados o reglas estrictas de manejo de datos, este es un requisito estricto que Redocly cumple y que una CLI de plataforma generalmente no lo hace.
Quieres un conjunto de herramientas ligero y enfocado. Si todo lo que necesitas es lint, agrupar, dividir, unir y documentos HTML desde la terminal, Redocly hace exactamente eso y nada más. Puedes instalarlo o ejecutarlo a través de npx con cero configuración. El conjunto completo de comandos se encuentra en la documentación de la CLI de Redocly y en la página del paquete npm.
Cuándo elegir Apidog
Recurre a Apidog cuando la especificación sea una parte de un ciclo de vida más amplio que prefieras no ensamblar a partir de herramientas separadas.
Quieres diseño, simulación, pruebas y documentación en un solo lugar. La CLI importa tu especificación, exporta un archivo consolidado limpio en la versión de OpenAPI que elijas y ejecuta escenarios de prueba en CI. El mismo proyecto también te ofrece diseño visual, un servidor mock y documentación publicada, todo compartiendo una única definición. Dejas de conectar un linter, una herramienta de simulación, un ejecutor de pruebas y un generador de documentos.
Quieres ejecución de pruebas en tu pipeline con informes utilizables. apidog run produce XML JUnit para tu panel de CI, además de artefactos HTML y JSON, y sale con un código distinto de cero cuando una prueba falla. Redocly no ejecuta pruebas en absoluto, por lo que si el control de pruebas de CI está en tu lista, aquí es donde encaja Apidog. Los patrones en la validación OpenAPI en CI se combinan naturalmente con una ejecución de pruebas en el mismo pipeline.
Quieres una única fuente de verdad para todo un equipo. Los recursos residen en un proyecto de Apidog en el que trabajan diseñadores, probadores y redactores. La CLI es la superficie de automatización sobre ese espacio de trabajo compartido, lo que se adapta a equipos que prefieren colaborar en una plataforma en lugar de pasar archivos de especificación de un lado a otro.
Descarga Apidog para seguir el proceso. Es gratis para empezar, no se requiere tarjeta de crédito.
Pueden ser complementarios
Esto no es estrictamente uno u otro, y fingir que lo es pasaría por alto la configuración más práctica.
Un flujo de trabajo robusto ejecuta la CLI de Redocly (o Spectral) como puerta de lint en CI, aplicando tu guía de estilo en cada pull request, y utiliza Apidog para el diseño, mocking, ejecución de pruebas y documentos publicados. Realiza linting donde el linting es mejor, con conjuntos de reglas de código abierto en la terminal. Simula, prueba y documenta donde una plataforma es mejor. La especificación fluye entre ellos: verifica el archivo en CI, impórtalo en Apidog para todo lo posterior.
Esa combinación aprovecha la verdadera fortaleza de cada herramienta en lugar de forzar a una a hacer el trabajo de la otra.
Preguntas frecuentes
¿La CLI de Apidog tiene un comando lint con reglas personalizadas como Redocly?
No. Apidog valida la estructura de una definición cuando la importas, pero no hay un comando apidog lint ni forma de crear reglas personalizadas de guía de estilo a través de la CLI. Para un linting configurable y que prioriza el código, usa Redocly CLI o Spectral.
¿Puede la CLI de Redocly ejecutar pruebas de API en CI?
No. La CLI de Redocly verifica, agrupa, divide, une y construye documentos. No ejecuta pruebas de API ni aloja un servidor mock. Para ejecuciones de pruebas sin interfaz gráfica con informes JUnit y HTML, usa apidog run.
¿Apidog es de código abierto como la CLI de Redocly?
No. Redocly CLI y Spectral son de código abierto. Apidog es freemium: la CLI es gratuita para instalar desde npm, pero opera contra una cuenta y proyecto de Apidog en lugar de ser un software completamente de código abierto.
Usaba swagger-cli para validar y agrupar. ¿A qué debería migrar?
Ambas herramientas lo cubren. La CLI de Redocly es la sucesora designada de swagger-cli, con redocly lint (configura la regla spec para una validación simple) y redocly bundle. Apidog cubre el mismo terreno a través de apidog import (validar) y apidog export (agrupar, con una actualización opcional de la versión OpenAPI), y añade simulación, pruebas y documentación en el mismo espacio de trabajo.