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 para el campo de versión. Los objetos Schema 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 Schema siguen procediendo del convertidor orientado a OAS 3.0 (p. ej. nullable). Elige 3.1.0 si tu cadena de herramientas espera esa versión.
Formato de salida
Elige JSON (predeterminado) o YAML para el documento OpenAPI generado. OpenAPI acepta ambas serializaciones. Prefiere YAML para 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 objetos Schema siguen procediendo del convertidor orientado a OAS 3.0 (p. ej. nullable), así que no es una reescritura completa para 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 de JSON Schema solo se pega JSON. El convertidor inverso y las herramientas OpenAPI admiten YAML OpenAPI. El documento OpenAPI generado puede ser JSON o YAML: elígelo en la opción Formato de salida de la barra de herramientas.

¿Herramientas relacionadas?

Para el sentido inverso usa OpenAPI to JSON Schema. Para validar datos usa JSON Schema Validator, y para comprobar solo la sintaxis JSON usa JSON Validator.

API y esquemas

Herramientas OpenAPI para formatear, validar y analizar tus specs.

Explorar otras categorías de herramientas