Validador OpenAPI en línea — Conformidad del esquema

Comprueba la conformidad de esquema OpenAPI 3.0–3.2 en local. 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 vía @scalar/openapi-parser. No es un linter de estilo — 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. Autodetección con eliminación de BOM; si un documento {…} falla como JSON, se intenta fallback YAML flow.

¿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

Minificar

Reduce código y assets para producción — minifica JavaScript, CSS, HTML, JSON y XML antes de gzip o un despliegue CDN.

Embellecer

Haz el código legible con una indentación coherente — embellece JavaScript, CSS, TypeScript, SCSS, LESS, Markdown, GraphQL, SQL, YAML y más en tu navegador.

Desminificar

Expande código minificado o comprimido — desminifica JavaScript, CSS, TypeScript, SCSS, LESS, SQL, YAML y otros formatos al depurar o revisar.

Conversión

Transforma datos entre JSON, YAML, XML y CSV en local — sin subidas a un servidor.

Preprocesadores CSS

Compila SCSS o LESS a CSS estándar en el navegador — combínalo con embellecer o minificar para un flujo de hoja de estilos completo.

Herramientas JSON

Valida, formatea, compara y explora payloads JSON — complementarias a minificadores y convertidores.

Herramientas SVG

Previsualiza, optimiza con SVGO, exporta Data URI, redimensiona, embellece, convierte a JSX y valida SVG — todo en tu navegador.

DevOps e Infra

Formato, validación y minificación de Terraform HCL, formato y lint de Dockerfile, validación de Docker Compose y .env.

CI/CD

GitHub Actions y GitLab CI — formatear YAML y comprobar la estructura de workflows/jobs en el navegador.

Logs y observabilidad

JSON/NDJSON línea a línea y access logs de Nginx/Apache — formato, filtro, validación y CSV/TSV.

Kubernetes

Manifiestos multi-doc, validación estructural, starters Ingress/Deployment y formato de values de Helm.

Red / IP

CIDR, subredes y ayudas IPv4/IPv6 — en tu navegador.

Seguridad y tokens

JWKS, certificados X.509 y escaneo de secretos — en local en el navegador.

Codificación

Codifica o decodifica Base64, componentes URL y entidades HTML — solo en el cliente.

Utilidades para desarrolladores

Timestamps, UUID, ULID, Nanoid, cron, contraseñas, regex, slugify, bases numéricas, mayúsculas, diff de texto y chmod — todo en el cliente.

Texto y Markdown

Cuenta palabras, genera TOC Markdown y limpia listas de líneas — todo en tu navegador.

IA y LLM

Conteo de tokens, estimación de costes y ajuste a la ventana de contexto — 100 % en el navegador.

Datos de prueba

Valores de campo sintéticos para fixtures y seed de BD — primero números de teléfono en rangos reservados.

Serialización

Serializa y deserializa estructuras PHP junto a los flujos JSON.