SwaggerHub se consolidó como una herramienta seria para diseñar APIs con OpenAPI. Ahora SmartBear lo integra en la plataforma Swagger junto con Portal, Contract Testing y Functional Testing. Antes de elegir un plan, revisa los límites: según la página de precios de Swagger, Individual cuesta $22.80 por usuario/mes, Team $34.44 y Enterprise $58.80; las ejecuciones de pruebas se limitan a 50 o 100 al mes según el plan, SSO cuesta $6 adicionales por usuario/mes y el portal mantiene la marca SmartBear por debajo de Enterprise Plus.
La alternativa directa es Apidog para equipos que necesitan un flujo spec-first sin contabilizar ejecuciones de pruebas ni sumar complementos. Combina diseño visual de OpenAPI, pruebas sin límite de ejecuciones, mocking basado en esquemas y documentación en dominio propio. Es gratuito para hasta 4 usuarios y cuesta $9 por usuario/mes a partir de ahí.
Cuánto cuesta realmente el nuevo paquete de Swagger
La plataforma agrupa cuatro módulos —Studio, Portal, Contract Testing y Functional Testing—, pero los límites determinan el coste operativo real.
- El precio por puesto crece rápido. Team cuesta $34.44 por usuario/mes, frente a $9 por usuario/mes en Apidog. Un equipo de 10 personas paga aproximadamente $4,133 al año antes de complementos. Consulta el desglose en precios de SmartBear y las principales alternativas.
- Las ejecuciones de prueba están medidas. Individual y Team incluyen 50 ejecuciones mensuales; Enterprise, 100. Una pipeline de CI que ejecute pruebas en cada merge puede consumir ese límite en pocos días. Las pruebas paralelas solo están disponibles en Enterprise Plus.
- El portal conserva la marca SmartBear. Los planes permiten publicar entre uno y cinco productos, según el nivel, pero el dominio personalizado y la eliminación completa de marca requieren Enterprise Plus.
- SSO es un complemento. SSO empresarial añade $6 por usuario/mes. Portal Pro ($29.40), Contract Testing Pro ($23) y Test Pro ($30) son complementos adicionales por usuario.
- Las APIs están limitadas. Individual permite 10 APIs y Team, 50. Los equipos de plataforma pueden alcanzar ese límite antes de lo esperado.
Las capacidades de diseño y gobernanza de SwaggerHub siguen siendo sólidas. El punto es que el modelo de precios cobra por separado tareas habituales alrededor de la especificación: publicarla, probarla y gestionar el acceso.
La respuesta: Apidog
Apidog es una plataforma de desarrollo de APIs utilizada por más de 500,000 desarrolladores. Mantiene un enfoque spec-first similar al de SwaggerHub, pero incluye el resto del ciclo de vida sin medir las ejecuciones.
Estas son las diferencias prácticas principales:
- Sin límites en los recursos que Swagger mide. APIs, ejecuciones de pruebas y ejecuciones programadas son ilimitadas en todos los planes, incluido el gratuito. Puedes ejecutar la suite en cada commit sin supervisar un contador.
- La especificación genera artefactos utilizables. Desde OpenAPI puedes generar documentación interactiva, un mock basado en esquema y escenarios de prueba ejecutables. Los cambios de diseño se propagan a esos recursos.
- Documentación en tu dominio. Los dominios y diseños personalizados, así como las páginas Markdown, forman parte de la publicación estándar.
- Precio simple por usuario. Hasta 4 usuarios pueden usar el plan gratuito; después, el precio es de $9 por usuario/mes. SSO, SCIM y RBAC están disponibles en Enterprise como parte del plan.
El cálculo por puestos
Con las tarifas de Team, la diferencia aumenta con cada incorporación. Este cálculo compara Swagger Team a $34.44 por usuario/mes frente a Apidog gratuito para 4 usuarios y $9 por cada usuario adicional.
| Tamaño del equipo | Swagger Team por año | Apidog por año | Diferencia |
|---|---|---|---|
| 4 personas | $1,653 | $0 (plan gratuito) | $1,653 |
| 10 personas | $4,133 | $1,080 | $3,053 |
| 20 personas | $8,266 | $2,160 | $6,106 |
Si añades SSO empresarial de Swagger a $6 por usuario/mes, un equipo de 20 personas suma otros $1,440 al año solo por inicio de sesión. Además, este cálculo asume que no necesitas superar los límites de 50 APIs o 50 ejecuciones mensuales.
Funcionalidad por funcionalidad frente a los módulos de Swagger
Studio → edición visual y de código para especificaciones
Apidog incluye diseñador visual y editor de código para OpenAPI. También permite usar ramas para proponer, revisar y fusionar cambios en la especificación.
Para migrar componentes reutilizables de SwaggerHub, exporta los Dominios compartidos como esquemas dentro de components en OpenAPI:
components:
schemas:
User:
type: object
required:
- id
- email
properties:
id:
type: string
email:
type: string
format: email
La diferencia importante está en la gobernanza: Apidog cubre validación básica, pero no ofrece reglas de linting personalizadas a nivel de organización. Si necesitas gobernanza con Spectral sobre cientos de especificaciones, SwaggerHub mantiene una ventaja real.
Portal → documentación alojada
Apidog publica documentación interactiva con una consola de pruebas conectada a entornos reales o al servidor mock integrado.
Pasos recomendados:
- Importa tu archivo OpenAPI.
- Configura los entornos, por ejemplo
stagingyproduction. - Publica la documentación.
- Asigna tu dominio personalizado.
- Redirige las rutas del portal anterior a la nueva URL.
No necesitas gestionar límites de productos publicados ni mantener la marca del proveedor en el portal.
Pruebas funcionales → escenarios ilimitados
Esta es una de las diferencias más operativas. SwaggerHub mide ejecuciones mensuales; Apidog permite crear escenarios visuales con pasos encadenados, extracción de datos, aserciones y entradas desde CSV o JSON.
Puedes integrarlos en CI con la CLI de Apidog:
npm install -g apidog-cli
apidog run scenario --scenario-id 12345 --env staging
Úsalo en tu pipeline después del despliegue:
- name: Ejecutar pruebas de API
run: apidog run scenario --scenario-id 12345 --env staging
Cada ejecución genera un informe HTML y no consume un presupuesto mensual de pruebas.
Automocking → mocks inteligentes
El automocking de SwaggerHub devuelve respuestas basadas en ejemplos y no está disponible en Individual. Apidog genera respuestas a partir de tipos y nombres de campos del esquema.
Por ejemplo, una definición como esta:
properties:
email:
type: string
format: email
avatar_url:
type: string
format: uri
puede producir valores realistas para email y avatar_url sin crear reglas manuales. También puedes definir expectativas para respuestas fijas y usar una opción autohospedada en redes internas.
Consulta más opciones en las mejores alternativas a Swagger.
Más allá de los módulos
Apidog también funciona como cliente de solicitudes para la depuración diaria. Esto permite que la especificación no sea solo un documento de gobernanza: el equipo puede usarla al diseñar, probar y depurar endpoints.
La especificación también puede publicarse mediante un servidor MCP para que agentes de codificación con IA la consuman directamente. Consulta qué es Apidog MCP Server.
SwaggerHub (Swagger) vs Apidog: comparación rápida
| Característica | Swagger / SwaggerHub | Apidog |
|---|---|---|
| Precio de entrada | $22.80 por usuario/mes (Individual) | Gratis hasta 4 usuarios |
| Precio para equipos | $34.44 por usuario/mes + complementos | $9 por usuario/mes |
| APIs | 10 (Individual) / 50 (Team) | Ilimitadas |
| Ejecuciones de prueba | 50–100 por mes; ilimitadas solo en Enterprise Plus | Ilimitadas en todos los planes |
| Pruebas paralelas | Solo Enterprise Plus | Incluidas |
| Mocking | Automocking, no disponible en Individual | Mocks basados en esquema y autohospedables |
| Marca del portal | Marca SmartBear por debajo de Enterprise Plus | Tu dominio y tu marca |
| SSO | Complemento de $6 por usuario/mes | Plan Enterprise |
| Gobernanza y linting personalizado | Fuerte, con estandarización basada en Spectral | Validación básica; sin reglas organizacionales |
| Pruebas de contrato con Pact | Sí, módulo dedicado | No |
| Sincronización con gateways AWS, Azure y Apigee | Sí | Sin envío nativo a gateway |
| Cliente de solicitudes para depuración | No | Sí |
Las últimas filas muestran dónde SwaggerHub sigue justificando su posición: gobernanza avanzada, pruebas de contrato e integraciones de gateway. Para equipos que principalmente diseñan, prueban, documentan y simulan APIs, los límites y complementos pueden tener más impacto que esas capacidades.
Migrando desde SwaggerHub
Como ambas herramientas trabajan de forma nativa con OpenAPI, la migración puede seguir un proceso directo.
- Exporta las especificaciones desde SwaggerHub en YAML o JSON.
- Resuelve los Dominios compartidos como componentes reutilizables dentro de cada especificación exportada.
- Importa los archivos en Apidog. Endpoints, esquemas, ejemplos y descripciones deberían conservar su estructura.
- Crea ramas para el flujo de revisión. Usa una rama por cambio y fusiona cuando la revisión esté aprobada.
- Configura la publicación de documentación en tu dominio personalizado.
- Añade redirecciones desde el portal antiguo a la nueva documentación.
- Activa automatizaciones antes limitadas. Programa pruebas tras cada despliegue y comparte las URLs de mock con los equipos frontend.
Un espacio de trabajo con 50 especificaciones, que coincide con el límite de Team, puede migrarse normalmente en menos de una semana. La exportación también sirve como auditoría para detectar especificaciones obsoletas.
Cuándo SwaggerHub aún tiene sentido
SwaggerHub sigue siendo una opción sólida en tres escenarios:
- Gobernanza de APIs a escala organizacional. Si necesitas guías de estilo personalizadas, reglas de Spectral, informes de estandarización y control sobre cientos de especificaciones, SwaggerHub está más preparado.
- Pruebas de contrato basadas en Pact. Si son una parte central de la coordinación entre microservicios, Contract Testing es un diferenciador relevante.
- Sincronización con gateways. Si debes sincronizar especificaciones con AWS API Gateway, Azure API Management o Apigee como parte del despliegue, las integraciones de SwaggerHub son maduras.
El cambio tiene más sentido cuando el trabajo principal del equipo consiste en diseñar, probar, documentar y simular APIs, y cuando las ejecuciones medidas, la marca del portal y los complementos añaden coste al trabajo diario.
Para comparar más herramientas de diseño design-first, revisa esta comparación de Stoplight, ya que Stoplight también está bajo el paraguas de SmartBear.
Preguntas frecuentes
¿Cuánto cuesta SwaggerHub ahora?
En la plataforma Swagger relanzada, Individual comienza en $22.80 por usuario/mes, Team en $34.44, Enterprise en $58.80 y Enterprise Plus se cotiza de forma personalizada. SSO empresarial ($6), Portal Pro ($29.40), Contract Testing Pro ($23) y Test Pro ($30) son complementos mensuales por usuario.
¿Apidog es realmente ilimitado donde SwaggerHub aplica límites?
Sí. APIs, solicitudes, ejecuciones de pruebas y ejecuciones programadas son ilimitadas en todos los planes de Apidog, incluido el gratuito. SwaggerHub limita las ejecuciones de prueba a 50 o 100 mensuales por debajo de Enterprise Plus y las APIs a 10 o 50 en los niveles inferiores.
¿Puedo importar especificaciones de SwaggerHub en Apidog?
Sí. Exporta tus especificaciones como OpenAPI YAML o JSON e impórtalas directamente. Los esquemas, endpoints, ejemplos y descripciones se transfieren; los Dominios compartidos deben resolverse dentro de la especificación antes de exportar.
¿Apidog soporta diseño spec-first como SwaggerHub?
Sí. Apidog ofrece editores visuales y de código para OpenAPI, revisión basada en ramas y generación de documentación, mocks y pruebas desde la especificación. No incluye conjuntos de reglas de linting personalizados para toda la organización.
¿Qué ocurre con las integraciones de gateway de SwaggerHub?
Apidog no envía especificaciones de forma nativa a AWS API Gateway, Azure API Management o Apigee. Si la sincronización con esos gateways es un requisito obligatorio, evalúa ese flujo antes de migrar. La exportación e importación mediante OpenAPI está disponible en ambas herramientas.
Diseña la especificación y ejecútala
Importa una especificación de SwaggerHub y conviértela en documentación para tu dominio, un servidor mock y escenarios de prueba programables. Descarga Apidog, evalúalo gratis con un equipo de hasta 4 personas y calcula el coste para el resto del equipo: $9 por usuario/mes frente a $34.44 más complementos.
Top comments (0)