Skip to content
jsonforge.app

Visor OpenAPI y Swagger

Visor interactivo de especificaciones OpenAPI 3.x y Swagger 2.0 con generadores de código cURL y Fetch.

OpenAPI / Swagger Spec (JSON or YAML)

Loading editor…

OpenAPI Interactive ViewerOpenAPI 3 3.0.3

Petstore API

v1.0.0

A sample Petstore API spec for demonstrating OpenAPI / Swagger rendering

Header Auth / Security:bearerAuth (bearer) → AuthorizationapiKeyAuth → X-API-KEY
Servers:https://petstore.swagger.io/v2
GET/petsList all pets
apiKeyAuth
POST/petsCreate a pet
bearerAuth
GET/pets/{petId}Info for a specific pet

¿Qué es Visor OpenAPI y Swagger?

El Visor de Especificaciones OpenAPI y Swagger te permite pegar o subir cualquier especificación OpenAPI 3.0, 3.1 o Swagger 2.0 en formato JSON o YAML y la transforma al instante en una interfaz de documentación de API interactiva y visual. Los endpoints se agrupan automáticamente por etiquetas, con insignias de método HTTP (GET, POST, PUT, DELETE, PATCH), tablas de parámetros, definiciones del cuerpo de petición y esquemas de respuesta por código de estado. También muestra los requisitos de autenticación por cabeceras (Bearer JWT, claves de API, autenticación básica) y ofrece generación de snippets de código cURL y JavaScript Fetch de un clic para probar los endpoints.

Cómo usar Visor OpenAPI y Swagger

  1. Pega tu especificación OpenAPI 3.x o Swagger 2.0 (JSON o YAML) en el editor del panel izquierdo.
  2. El visor interactivo de la derecha parsea tu especificación al instante y renderiza todos los endpoints de la API.
  3. Usa los filtros de método (GET, POST, PUT, etc.) o la barra de búsqueda para filtrar endpoints por ruta, resumen o etiqueta.
  4. Pulsa cualquier acordeón de endpoint para ver los parámetros obligatorios, los cuerpos de petición y los esquemas de respuesta.
  5. Pulsa 'cURL' o 'Fetch' para copiar snippets de código listos para ejecutar en terminal o navegador.

Ejemplos

Inspeccionar una especificación OpenAPI 3.0

Entrada

openapi: 3.0.3 info: title: My API version: 1.0.0 paths: /users: get: summary: List Users

Salida

Documentación interactiva que muestra el endpoint GET /users con códigos de estado y esquemas de parámetros

Generar cURL para un endpoint POST

Entrada

openapi: 3.0.0 info: title: Orders API version: 1.0.0 paths: /orders: post: summary: Create Order

Salida

Copia con un clic el comando cURL con cabeceras de payload JSON y token de autorización Bearer

Errores comunes

  • Pegar YAML o JSON inválido con errores de sintaxis — asegúrate de que tu documento es válido antes de verlo.
  • Olvidar definir securitySchemes en components — sin definiciones de seguridad, se generan tokens bearer por defecto para la autorización.
  • Esperar que se ejecuten peticiones de red reales dentro del visor — esta herramienta está pensada para el renderizado de especificaciones y la generación de snippets de código.

Por qué usar esta herramienta

  • Se ejecuta 100% en el cliente — tus contratos de API, endpoints internos y tokens permanecen privados.
  • Generación instantánea de código cURL y Fetch para pruebas rápidas.
  • Soporta tanto OpenAPI 3.x como Swagger 2.0 en JSON y YAML.

Preguntas frecuentes

Herramientas relacionadas

Visor de Árbol JSON

Explora JSON como un árbol plegable y buscable en lugar de un bloque de texto plano.

/json-tree-viewer

Vista Previa JSON

Previsualiza JSON como texto embellecido, una tabla, un diagrama de relaciones o un árbol — cambia de vista al instante.

/json-preview

JSON a YAML

Convierte JSON a YAML y viceversa, con inferencia de tipos y formato limpio.

/json-to-yaml

Validador JSON

Valida JSON contra esquemas con informes de error detallados. Genera esquemas a partir de JSON.

/json-validator