Generador de JSON a JSON Schema (Draft 2020-12) Online

Genere definiciones JSON Schema Draft 2020-12 desde cualquier JSON online. Infiere propiedades required, additionalProperties: false, integer vs number y uniones anyOf.

Entrada JSON

Generación de JSON Schema Draft 2020-12 para OpenAPI 3.1, Ajv y LLMs

JSON Schema Draft 2020-12 (https://json-schema.org/draft/2020-12/schema) es el estándar universal para validación de datos con Ajv, contratos OpenAPI 3.1 y salidas estructuradas (Structured Outputs / Function Calling) en modelos de lenguaje como Gemini, OpenAI y Claude.

Este generador analiza su documento JSON de muestra, distingue entre números enteros (integer) y decimales (number), fusiona elementos de arreglos para deducir qué propiedades son obligatorias (required) y añade additionalProperties: false de forma 100% local en su navegador.

  • Contratos Estrictos (required y additionalProperties: false): Calcula automáticamente el arreglo required y establece additionalProperties: false para máxima compatibilidad con Ajv y APIs de IA.
  • Soporte para Nulos y Tipos Mixtos mediante anyOf: Representa campos anulables o arreglos heterogéneos utilizando bloques estándar anyOf.

Integración con Validadores Ajv, Especificaciones OpenAPI 3.1 y Agentes de IA

La especificación OpenAPI 3.1 adopta de forma nativa el vocabulario de JSON Schema Draft 2020-12, por lo que puede insertar el esquema generado directamente dentro de components.schemas en sus contratos de API o compilarlo con Ajv (new Ajv2020({ allErrors: true, strict: true }).compile(schema)) para validar peticiones HTTP a alta velocidad.

Al configurar salidas estructuradas en modelos de lenguaje (como response_format: { type: "json_schema" } en OpenAI, responseSchema en Google Gemini o input_schema en herramientas de Anthropic), la decodificación restringida exige que cada objeto defina additionalProperties: false y enumere sus claves en required, reglas que este generador aplica de serie.

  • Distinción Semántica entre integer y number: Los valores sin decimales se tipan como "type": "integer" y los números en coma flotante como "type": "number", evitando errores de redondeo o truncamiento en clientes tipados.
  • Inferencia Inteligente de Propiedades en Arreglos: Al inspeccionar arreglos de objetos, solo las claves presentes en el 100% de los elementos se marcan dentro de required, manteniendo las demás como opcionales en properties.

Casos de Uso Prácticos en el Mundo Real

Ingenieros de APIs, plataformas de datos e IA emplean esquemas Draft 2020-12 para estandarizar contratos entre sistemas:

  • Salidas Estructuradas (Structured Outputs) en Gemini, OpenAI y Claude: Transforme un JSON de ejemplo en un contrato responseSchema estricto con arreglos required y additionalProperties: false listos para agentes de IA.
  • Documentación OpenAPI 3.1 y Validación Rápida con Ajv / Fastify: Genere bloques components.schemas para especificaciones OpenAPI y compile validadores Ajv de alto rendimiento en microservicios Node.js.
  • Autocompletado en VS Code ($schema) y Registros de Eventos: Cree esquemas para archivos de configuración internos o tópicos de mensajería permitiendo validación instantánea en el editor de código.

Preguntas Frecuentes (FAQ)

¿Qué versión del estándar JSON Schema genera esta herramienta?

Genera esquemas conformes a JSON Schema Draft 2020-12 ($schema: "https://json-schema.org/draft/2020-12/schema") con definiciones explícitas de properties, required y additionalProperties: false.

¿El esquema generado sirve para Structured Outputs de OpenAI/Gemini y Ajv?

Sí. Al incluir explícitamente el listado required y additionalProperties: false en cada objeto, el esquema cumple los requisitos del modo estricto de Ajv y de las APIs de salida estructurada para LLMs.