Convertidor JSON Schema a OpenAPI — Gratis en línea

Convierte un JSON Schema (Draft-07 / 2020-12) en un documento OpenAPI mínimo — elige openapi 3.0.3 o 3.1.0 (campo version ; los Schema Objects siguen orientados a OAS 3.0). 100 % en el navegador, no se envía nada.

Cargando…
Documentación JSON Schema a OpenAPI
Convertir JSON Schema en un documento OpenAPI mínimo (campo openapi 3.0.3 o 3.1.0).

Notas para desarrolladores

• Convierte JSON Schema Draft-07 / 2020-12 a Schema Objects de OpenAPI vía @openapi-contrib/json-schema-to-openapi-schema. • Salida: documento OpenAPI mínimo (info, paths vacíos, components.schemas) con openapi 3.0.3 (predeterminado) o 3.1.0. • Elige salida JSON (predeterminado) o YAML — pega el resultado directamente en un archivo de spec OpenAPI existente. • Conversión en vivo al pegar/ejemplo; Convertir explícito (⌘↵) para ediciones manuales; entrada Monaco JSON + salida Shiki. • $defs / definitions pasan a esquemas con nombre; un esquema solo en la raíz se convierte en Root (o title). • Los $ref externos / http(s) se rechazan — nunca se descargan. • Solo entrada JSON (YAML rechazado) — solo el formato de salida es seleccionable. • Máximo 512 KiB.

Opciones

Versión OpenAPI
Fija el campo openapi del documento en 3.0.3 (predeterminado) o 3.1.0. Los objetos esquema siguen procediendo del convertidor orientado a OAS 3.0 (p. ej. nullable); elige 3.1.0 si tu toolchain espera esa cadena de versión.
Formato de salida
Elige JSON (predeterminado) o YAML para el documento OpenAPI generado. OpenAPI acepta ambas serializaciones — prefiere YAML al pegar el resultado en un archivo de spec existente en YAML, o JSON para herramientas que esperan JSON.

Casos de uso

• Convertir un modelo JSON Schema en un arranque de components.schemas OpenAPI. • Encadenar con Validar OpenAPI después de la conversión. • Compartir un stub OpenAPI de un solo archivo desde un esquema existente.

Ejemplos

JSON Schema $defs → OpenAPI components.schemas

Antes

{ "$schema": "https://json-schema.org/draft/2020-12/schema", "$defs": { "Pet": { "type": "object", "required": [ "id", "name" ], "properties": { "id": { "type": "integer" }, "name": { "type": "string" } } } } }

Después

{ "openapi": "3.0.3", "info": { "title": "Converted from JSON Schema", "version": "1.0.0" }, "paths": {}, "components": { "schemas": { "Pet": { ... } } } }

$ref externo rechazado

Antes

{ "$ref": "https://example.com/schemas/pet.json" }

Después

Error: external $ref not supported

FAQ JSON Schema a OpenAPI

Preguntas frecuentes

¿Qué versión de OpenAPI se produce?

Elige 3.0.3 (predeterminado) o 3.1.0 en la barra de herramientas. Esto fija el campo openapi del documento. Los Schema Objects siguen procediendo del convertidor orientado a OAS 3.0 (p. ej. nullable) — no es una reescritura completa de Schema Object OAS 3.1. Consulta Opciones.

¿Se admiten $ref externos?

No. Los $ref externos y http(s) producen un error duro. Solo se permiten referencias internas #/… dentro del documento pegado.

¿Puedo pegar YAML?

No en el lado JSON Schema — pega solo JSON. El YAML OpenAPI está soportado en el convertidor inverso y en las herramientas OpenAPI. El documento OpenAPI generado, sin embargo, puede ser JSON o YAML — elígelo en la opción Formato de salida de la barra de herramientas.

¿Herramientas relacionadas?

Sentido inverso: OpenAPI to JSON Schema; validar datos: JSON Schema Validator; solo sintaxis JSON: JSON Validator.

API y esquemas

Herramientas OpenAPI para formatear, validar y analizar tus specs.

Formatear OpenAPI

Validar OpenAPI

Lint OpenAPI

OpenAPI a JSON Schema

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.