Visor de especificaciones OpenAPI / Swagger

Previsualiza e interactúa con especificaciones de APIs REST OpenAPI y Swagger (en formato JSON o YAML).

Acerca de Visor de especificaciones OpenAPI / Swagger — Guía detallada

Categoría: DevOps y estándares 100 % local en el navegador

El visor de OpenAPI es un lector de documentación en el lado del cliente diseñado para inspeccionar contratos de API RESTful. Renderiza especificaciones Swagger 2.0 y OpenAPI 3.0 / 3.1 en JSON o YAML sin necesidad de instalar Swagger UI localmente ni depender de servicios en la nube.

Presenta una barra lateral de navegación organizada y agrupada para todos los endpoints, mostrando rutas, métodos HTTP (GET, POST, PUT, DELETE), parámetros de encabezado, cadenas de consulta (query strings), cuerpos de solicitud estructurados, códigos de respuesta HTTP y esquemas de datos.

#openapi #swagger #api #docs #rest #yaml #json

Funciones y capacidades clave

  • Compatible con especificaciones Swagger 2.0 y OpenAPI 3.0 / 3.1 en JSON y YAML
  • Barra lateral interactiva con endpoints categorizados, métodos HTTP y códigos de estado
  • Resolución profunda de esquemas `$ref` que muestra modelos de datos anidados y restricciones de propiedades
  • Procesamiento 100% en el cliente y sin conexión que mantiene seguros los contratos de API corporativos confidenciales

Cómo usarlo

  1. 1

    Pega el texto de tu `swagger.json` o `openapi.yaml`, o sube directamente el archivo de especificación.

  2. 2

    Explora la documentación estructurada de la API renderizada en el visor interactivo.

  3. 3

    Despliega cualquier endpoint para inspeccionar los encabezados de solicitud, los esquemas de carga útil (payload) y los ejemplos de respuesta.

Casos de uso comunes

  • → Auditar definiciones de API de backend sin necesidad de aprovisionar un servidor Swagger UI dedicado
  • → Verificar especificaciones OpenAPI escritas a mano para detectar punteros `$ref` no válidos
  • → Proporcionar a los desarrolladores de frontend referencias precisas del esquema durante integraciones de API

Herramientas relacionadas

Preguntas frecuentes y privacidad

¿Puede esta herramienta leer especificaciones YAML directamente?

Sí. Un analizador sintáctico de YAML integrado procesa especificaciones de contratos OpenAPI tanto en formato `.yaml` como `.json` completamente en el navegador.

¿Se sube mi especificación de API confidencial a servidores externos?

No. Todo el análisis del documento y el renderizado del esquema se ejecutan estrictamente en la memoria local de tu navegador.