¿Qué son OpenAPI y Swagger?
OpenAPI (anteriormente Swagger) es la especificación estándar del sector para describir API RESTful. Un documento OpenAPI define variables, formatos de solicitud y respuesta, métodos de autenticación y schemas de datos de la API en un archivo YAML o JSON legible por máquina. Se utiliza ampliamente para documentación de API, generación de SDK de cliente y pruebas automatizadas.
How to use Visor de OpenAPI / Swagger
- 1Paste, upload, or enter the openapi, swagger, api, rest, yaml, json input required by the tool.
- 2Adjust any options such as format, mode, output style, size, or validation behavior.
- 3Review the generated result, parsed details, warnings, or converted output in the preview area.
- 4Copy or download the result for a project, document, form, message, or shared file.
Casos de uso comunes
Revisión rápida de la documentación de la API
Visualice una especificación de API sin necesidad de ejecutar un servidor completo de Swagger UI.
Validación de schemas
Compruebe si los modelos de datos y las definiciones de los endpoints son correctos antes de generar código cliente.
Colaboración en el diseño de API
Comparte y revise los diseños de API pegando especificaciones durante revisiones de código o reuniones de planificación.
Preguntas frecuentes
¿Hay soporte a OpenAPI 2.0 (Swagger)?
Este visor está optimizado para OpenAPI 3.x. Especificaciones Swagger 2.0 pueden funcionar parcialmente, pero algunos campos, como consumes y produces, no son renderizados.
¿Mi especificación de API se envía a algún servidor?
No. Toda la revisión y renderización ocurre localmente en el navegador. Ningún dato sale de su dispositivo.
¿Puedo importar una especificación por URL?
En el momento, es necesario pegar directamente el contenido de la especificación. Copie YAML o JSON bruto del archivo o de la URL y lo recogí aquí.