Generador de Esquema JSON

Lo que la inferencia hace bien

• Tipos: string, number, integer, boolean, null, array, object.
• Nullabilidad: un campo que es null en una muestra y un string en otra se convierte en ["string", "null"].
• Elementos de array: arrays homogéneos producen un único esquema items; arrays heterogéneos producen prefixItems.
• Enumeraciones (enum): si todos los valores observados provienen de un pequeño conjunto (configurable, por defecto 10 valores distintos), emite un enum.
• Requeridos: con múltiples muestras, la intersección de claves se convierte en required; con una muestra, todas las claves son requeridas a menos que optes por no incluirlas.
• Formatos: strings que coinciden con fechas ISO-8601, correos electrónicos o URIs obtienen un format inferido.

Lo que la inferencia no puede saber

• Intención vs ejemplo: una muestra age: 25 infiere type: integer, pero no puede saber que también aceptas null. Pasa múltiples muestras que cubran casos extremos.
• Restricciones: minLength, maximum, pattern, debes añadir estos manualmente. La inferencia no adivina límites a partir de muestras.
• Lógica de negocio: “exactamente uno de estos tres campos debe estar establecido” requiere oneOf, no es inferible.
• Referencias: el generador emite un esquema plano. Si deseas factorizar formas repetidas en $defs, hazlo después de la generación.

Ejemplo de salida

De una sola muestra:

{ "name": "Alice", "age": 30, "tags": ["admin", "user"] }

El esquema inferido (borrador 2020-12):

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "integer" },
    "tags": { "type": "array", "items": { "type": "string" } }
  },
  "required": ["name", "age", "tags"]
}

Errores comunes

• Inferir de una sola muestra. El esquema se ajustará demasiado, cada campo se vuelve requerido, sin tolerancia a null. Siempre proporciona al menos 5-10 muestras variadas.
• Usar integer cuando querías number. Si alguna muestra tiene un decimal, el tipo inferido se convierte en number; si todas son enteras, se convierte en integer. Para campos que podrían ser cualquiera, incluye una muestra decimal.
• Olvidar campos opcionales. Un campo presente en 4 de 5 muestras pero ausente en 1 se convierte en opcional, intencionado. Si las 5 muestras lo incluyen, el esquema lo marcará como requerido aunque en realidad sea opcional en tu API.