Validar documento OpenAPI
Elige un OpenAPI 3.0 o 3.1 en JSON o YAML e indica el nombre de los archivos de referencia que aportes.
- Funciona en tu navegador
- Sin subir archivos
- Revisa antes de descargar
Elige un OpenAPI 3.0 o 3.1 en JSON o YAML e indica el nombre de los archivos de referencia que aportes. Revisa las operaciones, los destinos locales y los diagnósticos de estructura y de Schema Object. Solo se admite la versión fija del dialecto OAS. Los formatos son anotaciones y no se validan los datos de ejemplo.
Método: OAS 3.0 (2024-10-18) / 3.1 (2025-09-15); $schema: OAS3.1 (2024-11-10)
Procesamiento local
Lo que introduces se queda en el proceso de tu navegador, sin peticiones, sin almacenamiento y sin telemetría de contenido. Las copias de seguridad de los originales y las exportaciones que muestres de forma expresa pueden contener secretos; guárdalas solo en tu equipo.
Límites de recursos
Entrada total ≤ 1 MiB; texto ≤ 200.000 caracteres (XML: 100.000); profundidad 32 y 20.000 nodos por documento; hasta 1.000 filas u operaciones; salida ≤ 2 MiB; límite de 5 s. Al cancelar, se detiene el proceso. Estos límites de la aplicación no garantizan un tope de memoria total del navegador.
Hasta 20 archivos de referencia; hasta 1000 referencias y cadenas de hasta 32. Los ID de recursos anidados son identificadores lógicos locales y nunca se descargan de la red. Se comprueban los destinos base y la sintaxis de las referencias dinámicas, pero no se evalúan los enlaces dinámicos con instancias.
Elige el perfil y revisa los avisos antes de usar el resultado guardado. Si editas, restableces o sales, se cancela el trabajo y se descarta la vista previa. Guarda aparte las copias de los originales; no se sobrescribe ningún archivo de origen.
Copia del original: 1048576 B / Inspeccionar / generar
Cómo inspeccionar estos datos
- Origen
Carga el documento raíz en JSON o YAML, elige el dialecto OAS3.0/3.1 automático o uno concreto, y aporta los archivos de referencia locales con su nombre. Los nombres deben coincidir con las rutas relativas de $ref.
- Perfil declarado
Usa OAS3.1.0, info con title Demo y version 1, paths {} y components.schemas.Name.$ref = ./models.json. Aporta un models.json que contenga {"type":"string"} para resolver ese esquema.
- Revisar y guardar
Revisa los diagnósticos por ruta del documento y el grafo de referencias. Sin models.json, la referencia queda sin resolver; aporta ese archivo y vuelve a ejecutar antes de guardar el informe.
Preguntas sobre el perfil
¿Qué significa este resultado?
Las comprobaciones se refieren a la estructura del documento y a las reglas compatibles de los objetos de esquema. No envían peticiones a la API ni validan respuestas reales frente al contrato.
¿Cómo soluciono una entrada rechazada o que falta?
Un archivo con nombre que falta queda sin resolver; nunca se descargan URL remotas. Corrige la ortografía, el formato y el dialecto; que una referencia se resuelva no garantiza que el contenido sea válido.
¿Qué límites tiene esta herramienta?
Perfiles locales finitos de OAS3.0/3.1; no cubren todas las extensiones ni el comportamiento dinámico de vinculación de instancias. El texto y las referencias permanecen en este dispositivo.