Cómo usar: Validador OpenAPI / Swagger
- Pega tu
openapi.yaml/swagger.jsono abre el archivo. - La versión (OpenAPI 3.1, 3.0 o Swagger 2.0) se detecta automáticamente.
- Corrige primero los errores de esquema: cada uno muestra su ubicación en el documento.
- Revisa las comprobaciones adicionales y la lista de endpoints.
Qué se comprueba
| Comprobación | Detalles |
|---|---|
| Esquema oficial | El documento se valida con el JSON Schema de la OpenAPI Initiative para su versión (3.1, 3.0 o Swagger 2.0): campos obligatorios, claves permitidas y tipos de valor |
$ref rotos | Cada referencia local (#/components/schemas/Pet) debe apuntar a algo que exista |
operationId únicos | Los duplicados rompen los generadores de SDK y los enlaces de la documentación |
| Parámetros de ruta | Cada {param} de una ruta debe declararse con in: path y required: true, y viceversa |
| Respuestas | Cada operación necesita al menos una respuesta |
| Sugerencias | operationId, servers o info.description que faltan |
Versiones de OpenAPI
- Swagger 2.0 —
swagger: "2.0",definitions,host/basePath. - OpenAPI 3.0 —
components,servers,requestBody; los esquemas son un subconjunto del draft-04 de JSON Schema connullable. - OpenAPI 3.1 — totalmente alineado con JSON Schema 2020-12 (
type: [string, "null"]en lugar denullable), y añadewebhooks.
Limitaciones
Las referencias externas a otros archivos o URL no se descargan: une antes las especificaciones de varios archivos (por ejemplo, con redocly bundle). La validación de esquema detecta problemas estructurales; las reglas de estilo, como las convenciones de nombres, necesitan un linter como Spectral. Valida los payloads de ejemplo con tus esquemas usando el validador de JSON Schema, comprueba la sintaxis YAML con el validador de YAML y prueba la API en vivo con el probador de API.
También se busca como: validador swagger, validador openapi, validar openapi, validador openapi 3.1, validador swagger 2.0, lint openapi, validar especificación api, validar yaml openapi.
Herramientas que combinan con: Validador OpenAPI / Swagger
- Formateador JSON — Pega el código JSON para formatearlo, minimizarlo o validarlo.
- cURL a código — Pega un comando curl, ya sea de la documentación de una API o de «Copiar como cURL» en las DevTools de tu navegador, y obtén código listo para ejecutar en seis lenguajes, con las cabeceras, el cuerpo y la autenticación incluidos.
- Probador de JSONPath — Escribe una consulta JSONPath y verás al instante qué selecciona, con la ruta exacta de cada coincidencia.
- JSON a YAML — Pega tu JSON y obtén YAML limpio para manifiestos de Kubernetes, Docker Compose, GitHub Actions o cualquier archivo de configuración.
Preguntas frecuentes
¿Es compatible con OpenAPI 3.1?
Sí: OpenAPI 3.1.x, 3.0.x y Swagger 2.0 se validan cada uno contra su esquema oficial.
¿Por qué aparecen tantos errores por un solo fallo?
Los esquemas oficiales usan alternativas (oneOf), así que un valor incorrecto puede hacer fallar varias ramas. La herramienta filtra los mensajes hasta los más específicos: corrige el primero y vuelve a comprobar.
¿Puede seguir $refs a otros archivos?
No, solo las referencias dentro del mismo documento. Une antes en un solo archivo las especificaciones de varios archivos.
¿Se sube mi especificación de API?
No. La validación se ejecuta por completo en tu navegador, así que los diseños de API internos permanecen privados.
¿Puedo instalar Validador OpenAPI / Swagger como aplicación web y utilizarla sin conexión?
Sí. Validador OpenAPI / Swagger es una aplicación web instalable (PWA): se instala desde el navegador, no se descarga desde una tienda de aplicaciones. Haz clic en «Instalar aplicación» en la parte superior de esta página en Chrome o Edge (Windows, macOS, Linux, ChromeOS) o, en Android, utiliza «Compartir» → «Añadir a la pantalla de inicio» en iPhone y iPad, o «Archivo» → «Añadir al Dock» en Safari 17+ en un Mac. A continuación, se abrirá en su propia ventana con su propio icono y, como se ejecuta íntegramente en tu navegador, seguirá funcionando sin conexión. Firefox en el ordenador de sobremesa no permite instalar aplicaciones web. Cómo funciona la instalación.