Visor de especificaciones OpenAPI

El Visor de Especificaciones OpenAPI es una herramienta online gratuita que analiza y explora especificaciones OpenAPI/Swagger con navegación de endpoints, inspección de esquemas y generación de cURL. Funciona por completo en tu navegador, sin necesidad de instalación ni registro.

OpenAPI 3.x y Swagger 2.0 tanto en JSON como en YAML. Detecta el formato automáticamente.

Exporta como JSON o YAML independientemente del formato de entrada. Copia la especificación completa al portapapeles.

Haz clic en cualquier endpoint y usa Copiar como cURL. Genera el comando con la URL del servidor, el método, las cabeceras y los marcadores de posición del cuerpo.

Sí, el Visor de Especificaciones OpenAPI es 100 % gratuito, sin registro, sin tarifas ocultas y sin límites de uso. Todo el procesamiento ocurre localmente en tu navegador, garantizando una privacidad total.

Por completo. El Visor de Especificaciones OpenAPI procesa todo del lado del cliente, en tu navegador. No se sube ningún dato a ningún servidor ni se almacena en él. Tu contenido permanece siempre privado en tu dispositivo.

Sí, el Visor de Especificaciones OpenAPI es totalmente adaptable y funciona en smartphones y tablets. Puedes usarlo en cualquier dispositivo con un navegador web moderno, sin necesidad de descargar ninguna app.

No hace falta ninguna cuenta ni registro. Solo abre el Visor de Especificaciones OpenAPI en tu navegador y empieza a usarlo de inmediato. No hay barreras de registro ni restricciones de uso.

El Visor de Especificaciones OpenAPI admite una amplia variedad de formatos y lenguajes populares. Consulta la interfaz de la herramienta para ver la lista completa de opciones compatibles.

Solo introduce tu entrada en el campo correspondiente, ajusta las opciones a tu gusto y la herramienta la procesará al instante. Después puedes copiar el resultado al portapapeles o descargarlo.

Swagger fue el nombre original de la especificación, y la versión 2.0 todavía se conoce ampliamente como "Swagger". En 2016 el formato se donó a la OpenAPI Initiative y se renombró como OpenAPI, por lo que la versión 3.x se llama propiamente OpenAPI. Hoy en día "Swagger" suele referirse a las herramientas — Swagger UI, Swagger Editor, Codegen —, mientras que "OpenAPI" se refiere al documento de especificación en sí. Ambas pertenecen a la misma familia: las dos describen los endpoints, parámetros, cuerpos de solicitud, respuestas y modelos de datos de una API REST en un único archivo JSON o YAML. El principal cambio estructural en 3.x es que los parámetros de cuerpo y los modelos de respuesta se trasladaron a una sección reutilizable "components/schemas", y "definitions" pasó a llamarse "schemas". Este visor lee tanto Swagger 2.0 como OpenAPI 3.x, detecta qué versión usa tu documento y lo renderiza de la misma manera, así que pega cualquiera de los dos formatos para explorarlo.

Sí. Como el visor analiza tu especificación y la convierte en un objeto estructurado en memoria, puede devolverte el mismo documento en cualquiera de los dos formatos de serialización, sin importar cómo lo hayas pegado. Introduce una especificación en YAML y usa Export JSON para descargar una versión JSON correctamente formateada, o pega JSON y usa Export YAML para obtener el equivalente en YAML con la indentación adecuada — la descripción de la API, los endpoints y los esquemas se mantienen idénticos, solo cambia la sintaxis. Esto resulta útil cuando una herramienta de build, un servidor simulado o un generador de clientes espera un formato pero tu equipo redactó la especificación en el otro. También puedes copiar todo el documento convertido directamente a tu portapapeles. Todo se ejecuta localmente en tu navegador, así que incluso una especificación interna o no publicada nunca sale de tu máquina. Pega tu archivo y elige el formato de exportación que necesites.

El formato se detecta automáticamente a partir del primer carácter que no sea un espacio en blanco. Si el texto que pegas empieza con una llave de apertura, se trata como JSON y se analiza en consecuencia; cualquier otra cosa se interpreta como YAML, ya que un JSON válido para una especificación siempre empieza con un objeto. Tras el análisis, el visor comprueba si existe un campo "openapi" o "swagger" para confirmar que el documento es una especificación genuina y no datos arbitrarios. Si el análisis falla — una tabulación suelta, una comilla faltante, una indentación incorrecta —, se muestra el mensaje de error exacto en lugar de una pantalla en blanco, para que puedas encontrar y corregir el problema rápidamente. Esto significa que nunca tienes que indicar qué formato estás usando ni eliminar comentarios antes. Solo pega el contenido en bruto de tu archivo de especificación y el visor se encarga del resto, y luego renderiza la API para ti.

Las especificaciones OpenAPI evitan la repetición definiendo los modelos una sola vez bajo "components/schemas" y apuntando a ellos en otros lugares mediante referencias "$ref" — una respuesta puede referenciar un esquema Pet que a su vez referencia una Category y un array de Tags. En la pestaña Schemas, el visor renderiza cada modelo como un árbol expandible y resuelve esos punteros "$ref" hacia el modelo al que apuntan, para que puedas navegar por objetos y arrays anidados sin desplazarte por texto en bruto buscando definiciones. Cada propiedad muestra su tipo, formato, si es obligatoria y cualquier opción de enum, lo que deja clara de un vistazo la forma real de cada modelo. Eso te ahorra tener que cruzar manualmente una parte del archivo con otra para entender cómo encajan los datos. Abre la pestaña Schemas después de analizar tu especificación para recorrer las relaciones entre modelos de forma visual.

La codificación por colores es una ayuda de legibilidad que te permite escanear una API grande sin leer cada etiqueta. Cada operación lleva una insignia de método — GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS — coloreada según el verbo, de modo que las lecturas seguras se distinguen de las escrituras y eliminaciones al recorrer una lista larga de endpoints agrupados por etiqueta. Dentro de un endpoint expandido, los códigos de estado de respuesta se colorean por clase: 2xx éxito, 3xx redirecciones, 4xx errores de cliente y 5xx errores de servidor se distinguen cada uno de un vistazo, así que puedes ver de inmediato qué respuestas puede devolver una operación. Las operaciones obsoletas se marcan por separado para que no construyas nada sobre un endpoint que está en camino de desaparecer. Juntas, estas señales convierten una especificación densa en algo que puedes clasificar rápidamente. Pega una especificación, o carga el ejemplo integrado de Petstore, para ver el esquema de colores en acción.