Validador OpenAPI en línea — Conformidad del esquema

Comprueba en local la conformidad de esquema de OpenAPI 3.0 a 3.2, en JSON y YAML. Los $ref externos nunca se recuperan.

Cargando…
Documentación Validate OpenAPI
Comprobar conformidad de esquema OpenAPI 3.x en local.

Notas para desarrolladores

Usa @scalar/openapi-parser vía import dinámico (solo validate). OpenAPI 3.0, 3.1 y 3.2. Validación en vivo con debounce; entrada Monaco JSON/YAML con autodetección. Los $ref externos / URL nunca se descargan. Las referencias internas #/… las comprueba Scalar validate (referencias rotas = fallo). Swagger 2.0 se rechaza con un mensaje claro. Máximo 512 KiB. El panel Resultados muestra veredicto, rutas de incidencias Scalar y estadísticas de la spec.

Casos de uso

Detectar info faltante, versiones openapi inválidas y errores de esquema antes de la CI. Pegar una spec de un solo archivo (JSON o YAML) para una comprobación local rápida. Confirmar que las referencias $ref internas resuelven.

Ejemplos

Spec mínima válida

Antes

{ "openapi": "3.1.0", "info": { "title": "Pets", "version": "1.0.0" }, "paths": { "/pets": { "get": { "operationId": "listPets", "tags": ["pets"], "summary": "List pets", "responses": { "200": { "description": "OK" } } } } } }

Después

Estado: válido

Swagger 2 rechazado

Antes

{"swagger":"2.0","info":{"title":"t","version":"1"},"paths":{}}

Después

Unsupported: Swagger 2.0

FAQ Validate OpenAPI

Preguntas frecuentes

¿Qué comprueba la validación?

Conformidad de esquema OpenAPI 3.0–3.2 mediante @scalar/openapi-parser. No es un linter de estilo, así que usa Linter OpenAPI para eso.

¿Se admiten $ref?

Los $ref externos / URL nunca se descargan. Las referencias internas #/… se comprueban: un destino faltante hace fallar la validación.

¿Está soportado Swagger 2.0?

No. Los documentos con clave swagger se rechazan con un mensaje claro. Estas páginas no prometen validación Swagger.

¿JSON y YAML?

Ambos. La detección es automática y elimina el BOM. Si un documento {…} falla como JSON, se recurre a YAML en estilo de flujo.

¿Herramientas relacionadas?

Consulta también JSON Validator, Beautify YAML y el hub herramientas API.

API y esquemas

Herramientas OpenAPI para formatear, validar y analizar tus specs.

Explorar otras categorías de herramientas