📰 ¿Sigues usando Swagger? Scalar ya le está ganando terreno

Si llevas años documentando APIs REST, seguramente lo primero que probaste fue Swagger UI. Funciona, sí, pero se le nota el paso del tiempo: interfaz de hace una década, sin cliente de pruebas decente integrado, sin generación automática de ejemplos de código en varios lenguajes. Y mientras tanto, un proyecto open source llamado Scalar lleva meses ganando terreno como su sustituto natural, hasta el punto de que Microsoft ya lo recomienda de forma oficial.

Qué es Scalar y por qué está sonando ahora

Scalar es una plataforma open source, con licencia MIT, para documentar y probar APIs a partir de especificaciones OpenAPI 3.x y Swagger 2.0. El repositorio ya supera las 15.500 estrellas en GitHub y el paquete principal roza los 20 millones de instalaciones mensuales en npm, cifras que explican por qué cada vez más tutoriales y canales técnicos lo están sacando a relucir como reemplazo directo de Swagger UI.

La propuesta es sencilla de resumir: coge tu fichero OpenAPI y, en lugar de la típica pantalla gris de Swagger UI, genera una documentación interactiva con temas oscuros y claros, un playground para lanzar peticiones reales desde la propia documentación, ejemplos de código listos para copiar en varios lenguajes y buscador integrado. Todo eso sin tocar una línea de tu backend, solo apuntando al mismo archivo OpenAPI que ya tenías generando para Swagger.

Y no se queda ahí. Scalar también incluye un apartado de documentación general en Markdown y MDX, con sincronización bidireccional contra tu repositorio Git, más un generador de SDKs tipados y un cliente de API propio, offline-first, pensado como alternativa abierta a Postman. En vez de tratar el fichero OpenAPI como un documento estático que solo sirve para pintar una tabla de endpoints, Scalar lo convierte en un espacio de trabajo donde puedes leer el detalle de cada endpoint, inspeccionar los esquemas, entender la autenticación y probar la llamada real sin salir de la documentación.

Scalar vs Swagger UI vs Redoc

Antes de cambiar de herramienta conviene ver qué ofrece cada una. Esta es la comparativa real a día de hoy:

Herramienta	Precio	Cliente de pruebas (“Try it”)	Experiencia de desarrollo
Swagger UI	Gratis, open source	Sí, básico	Interfaz anticuada, poca personalización
Redoc	Gratis (open source) / de pago en versión Pro	No en la versión gratuita	Diseño limpio de tres paneles, muy usada por Docker o Netlify
Scalar	Gratis (open source, self-hosted) / desde 72 dólares al mes en la nube con Pro	Sí, con generación automática de snippets	Moderna, con modo cliente de API completo y soporte OpenAPI 3.1

Redoc lleva años siendo la alternativa “bonita” a Swagger, pero sin capacidad real de probar peticiones desde la propia documentación. Scalar se ha colado justo en ese hueco: tan cuidada como Redoc, pero con el “Try it” interactivo que Swagger UI sí tenía, y encima con cosas que ninguna de las dos ofrecía, como el generador automático de código o el modo cliente de API completo, pensado como alternativa a Postman pero offline-first.

Cómo se instala en un proyecto real

Aquí está la parte que de verdad importa si trabajas con backend. Si tu API está montada con Express, instalar Scalar es cuestión de un paquete:

npm install @scalar/express-api-reference

Y montarlo como middleware apuntando a tu documento OpenAPI, algo del estilo:

import { apiReference } from '@scalar/express-api-reference'

app.use(
  '/reference',
  apiReference({
    spec: { url: '/openapi.json' },
  }),
)

Con eso ya tienes la documentación interactiva sirviéndose en /reference, sin tocar el resto de tu API. Existen integraciones equivalentes para Next.js, Hono, Fastify y varios frameworks más, además de paquetes para generar SDKs tipados en TypeScript, Python, Go, PHP, Java y Ruby directamente desde el mismo fichero OpenAPI.

Microsoft ya se ha bajado del barco de Swagger

Esto es lo que de verdad ha acelerado la conversación. En marzo de 2024, el equipo de ASP.NET Core anunció que retiraría la dependencia de Swashbuckle (el paquete que generaba Swagger UI en .NET) de las plantillas por defecto de los proyectos web. Y con la salida de .NET 9, lo cumplieron: las plantillas ya no traen Swashbuckle instalado de serie.

El motivo que dieron es tan directo como razonable: mantener como pieza de primera clase un paquete de terceros que ni mantenía ni controlaba ya no tenía sentido para Microsoft, sobre todo con incidencias sin resolver acumulándose por parte de su mantenedor comunitario. En su lugar, .NET 9 trae de serie el paquete propio Microsoft.AspNetCore.OpenApi para generar el documento OpenAPI, y en la documentación oficial señalan a Scalar como la opción recomendada para renderizarlo con una interfaz decente.

Que el fabricante del framework deje de defender a Swagger UI por defecto y apunte a Scalar en su lugar es la clase de señal que un desarrollador no puede ignorar, ni aunque lleve años acostumbrado a la pantalla gris de siempre.

Precio: gratis si te lo montas tú

Scalar es completamente gratuito si te lo autoalojas: el renderizador es open source con licencia MIT, así que puedes meterlo en tu proyecto sin pagar nada ni depender de la nube de nadie. Si prefieres que te lo gestionen, existe también una plataforma alojada con un plan gratuito, un plan Pro de 72 dólares al mes con dominios personalizados y funciones de SDK adicionales, y un plan Enterprise a medida para equipos grandes.

Es justo el modelo que suele funcionar bien en herramientas para desarrolladores: el núcleo abierto y gratis para quien quiera montárselo, y el servicio gestionado como opción para quien prefiera no ocuparse del mantenimiento. Si mantienes documentación de API para clientes o integraciones externas y quieres una experiencia moderna sin dedicarle tiempo de infraestructura, puedo ayudarte a integrarlo en tu stack.

Preguntas frecuentes

¿Scalar sustituye directamente a Swagger UI?

Sí, en la práctica funciona como un reemplazo directo: lee el mismo fichero OpenAPI 3.x o Swagger 2.0 que ya generabas para Swagger UI y lo renderiza con una interfaz moderna, sin que tengas que cambiar cómo documentas tu API.

¿Es de pago?

El renderizador open source es gratuito y con licencia MIT, pensado para autoalojarlo tú mismo. Scalar también ofrece una plataforma alojada con plan gratuito, un plan Pro de 72 dólares al mes y un plan Enterprise a medida.

¿Por qué Microsoft dejó de usar Swagger UI por defecto?

Porque Swashbuckle, el paquete que generaba Swagger UI en ASP.NET Core, era una dependencia de terceros que Microsoft no controlaba y que llevaba tiempo con incidencias sin resolver. Desde .NET 9 las plantillas ya no lo incluyen de serie, y la documentación oficial recomienda Scalar como alternativa para renderizar el documento OpenAPI.

¿Funciona con Node.js y Express?

Sí, instalando el paquete @scalar/express-api-reference como middleware apuntando a tu documento OpenAPI. También hay integraciones para Next.js, Hono, Fastify y otros frameworks.

Fuentes

• Vídeo: ¿Aún usas Swagger? Entonces tienes que ver esto
• Repositorio oficial de Scalar en GitHub
• C# Corner: Why Scalar is Replacing Swagger in .NET 9 and 10
• Tim Deschryver: What about my API documentation now that Swashbuckle is no longer a dependency in ASP.NET 9
• Qodex.ai: 9 Mejores Alternativas a Swagger para Documentación de API (2026)

Compártelo si te ha resultado útil, sobre todo con quien todavía documenta APIs con la pantalla gris de Swagger UI por costumbre.

¿Ya has probado Scalar en algún proyecto o sigues fiel a Swagger? Cuéntame.

Y… a ver cuánto tarda en volverse el nuevo estándar de facto.