Convertidor OpenAPI a JSON Schema — Gratis en línea

Q: ¿Qué pasa si no hay esquema Root?

Todos los esquemas quedan bajo $defs (o definitions si eliges Draft-07), sin type/properties raíz inventados. Un esquema llamado Root también obtiene un $ref de nivel superior hacia esa entrada.

Extrae components.schemas OpenAPI 3.0–3.2 a JSON Schema — Draft 2020-12 ($defs) por defecto, Draft-07 (definitions) opcional. Local en el navegador, sin subida.

Opciones

Draft

La salida es JSON Schema autónomo — valida los datos de instancia por separado. Usa el validador JSON Schema para comprobar los datos contra el esquema extraído.

Resultados de la conversión

Listo

Pega un documento OpenAPI — la conversión se ejecuta al pegar/cargar ejemplo o al pulsar Convertir (⌘↵).

Documento OpenAPI

0car.0 B1líneas

JSON Schema

0car.0 B1líneas

La conversión se ejecuta en el navegador — no se sube nada.

Compartir esta herramienta:

Cargando…

Documentación OpenAPI a JSON Schema

Extrae components.schemas OpenAPI a JSON Schema (2020-12 o Draft-07).

Notas para desarrolladores

• Los esquemas OpenAPI 3.0 se convierten con @openapi-contrib/openapi-schema-to-json-schema. • OpenAPI 3.1 / 3.2 usan un strip best-effort de palabras clave solo OAS. • Salida predeterminada: $schema 2020-12 + $defs; remap opcional a Draft-07 ($schema + definitions + refs #/definitions). • Conversión en vivo al pegar/ejemplo; Convertir explícito (⌘↵) para ediciones manuales; entrada Monaco JSON/YAML + salida Shiki JSON. • components.schemas vacío → error. • $ref externos rechazados. • Máximo de entrada 512 KiB.

Opciones

Draft de destino

2020-12 (predeterminado) emite $schema + $defs. Draft-07 remapea a la URI $schema Draft-07, definitions en lugar de $defs, y refs #/definitions/… — solo un rename estructural; las palabras clave exclusivas de 2020-12 no se reescriben.

Cuándo elegir esta herramienta

• Reutilizar modelos OpenAPI como JSON Schema independiente. • Alimentar los esquemas extraídos al validador de JSON Schema. • Comparar formas de esquema fuera de un documento OpenAPI completo.

Ejemplos prácticos

OpenAPI YAML → JSON Schema $defs

Antes

openapi: "3.0.3"
info:
  title: Pets
  version: 1.0.0
paths: {}
components:
  schemas:
    Foo:
      type: object
      properties:
        id:
          type: string
    Bar:
      type: object
      properties:
        name:
          type: string

Después

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$defs": {
    "Foo": { ... },
    "Bar": { ... }
  }
}

Esquemas vacíos rechazados

Antes

openapi: "3.0.3"
info:
  title: t
  version: "1"
paths: {}
components:
  schemas: {}

Después

Error: components.schemas vacío

FAQ de OpenAPI a JSON Schema

Preguntas frecuentes

¿La conversión 3.1 es idéntica a Draft-07?

No. La conversión OpenAPI 3.1/3.2 es un strip best-effort de palabras clave. La salida predeterminada es Draft 2020-12 ($defs). Elige Draft-07 para un remap estructural (definitions + $schema Draft-07) — no una reescritura completa de palabras clave. Ver Opciones.

¿Qué pasa si no hay esquema Root?

Todos los esquemas quedan bajo $defs (o definitions si eliges Draft-07), sin type/properties raíz inventados. Un esquema llamado Root también obtiene un $ref de nivel superior hacia esa entrada.

¿Herramientas relacionadas?

Convierte al revés con JSON Schema a OpenAPI, o valida la fuente OpenAPI con Validar OpenAPI.

API y esquemas

Herramientas OpenAPI para formatear, validar y analizar tus specs.

Formatear OpenAPI

Validar OpenAPI

Lint OpenAPI

JSON Schema a OpenAPI

Validador JSON Schema

Validar GraphQL

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.