Generador de Esquemas JSON Schema Validador de Objetos Estructuras: Crea el Esquema y Valida tu JSON Gratis

Qué es y para quién

El generador de esquemas JSON Schema observa un objeto JSON válido y produce el esquema equivalente: tipos de cada propiedad, cuáles son obligatorias (required), el tipo de los elementos de cada array y los formatos detectables, como email, date-time o uri. Después, su validador de objetos comprueba si otro JSON cumple ese esquema y enumera cada incumplimiento con su ruta ($.precio, $.contacto.email…).

Está pensado para desarrolladores que documentan contratos de API, integradores que reciben JSON de terceros, equipos de QA que necesitan casos de prueba negativos y cualquiera que mantenga ficheros de configuración con una estructura que no debería cambiar.

Cómo se usa

Pega un JSON representativo en el paso 1 y pulsa «Generar esquema JSON Schema». Revisa el resultado: el esquema marca como obligatorias todas las propiedades presentes en el ejemplo, así que conviene pegar un objeto completo. Después pega en el paso 2 cualquier otro objeto y pulsa «Validar objeto»: verás un conforme en verde o la lista de problemas, distinguiendo entre propiedades que faltan, tipos incorrectos y límites incumplidos si editas el esquema a mano para añadir minimum, maximum, minLength o enum.

Ejemplo resuelto

Del JSON de partida {"producto":"Camiseta","precio":19.99,"stock":42,"activo":true,"etiquetas":["ropa","verano"],"contacto":{"email":"tienda@example.com"}} la herramienta genera un esquema donde precio es number, stock es integer, etiquetas es un array de textos y contacto.email lleva format: email, con las seis propiedades como obligatorias.

Al validar {"producto":"Camiseta","precio":"19.99","activo":true} aparecen exactamente 4 problemas: faltan stock, etiquetas y contacto, y $.precio debería ser un número pero es un texto («19.99» entre comillas). Ese es el tipo de error que en producción se convierte en un «no funciona» sin más pistas.

Casos de uso

• Documentar una API: genera el esquema base desde una respuesta real y retócalo para publicarlo en tu documentación.
• Detectar cambios rotos: valida respuestas nuevas contra el esquema acordado antes de desplegar.
• Datos de prueba: comprueba que tus fixtures cumplen el contrato antes de lanzar la batería de tests.
• Aprender JSON Schema: ver cómo se describe una estructura conocida ayuda más que empezar de una página en blanco.

Limitaciones y consejos

La inferencia parte de un solo ejemplo: si un campo a veces es null o un array mezcla tipos, el esquema generado será más estricto que la realidad y tendrás que suavizarlo a mano. El validador integrado cubre el núcleo práctico de JSON Schema (tipos, obligatorias, propiedades, items, mínimos, longitudes y enum), pero no la especificación completa: no evalúa $ref, allOf/anyOf ni formatos con validación real (detecta el patrón de email, no comprueba que exista). Para contratos críticos, confirma con un validador completo en tu servidor. Privacidad: todo ocurre en tu navegador; el JSON que pegas nunca sale de tu dispositivo.

Preguntas frecuentes

¿Qué versión de JSON Schema genera?

Declara el borrador 2020-12 en la clave $schema, aunque las construcciones que usa (type, properties, required, items, format) son compatibles con borradores anteriores.

¿Por qué marca obligatorias todas las propiedades?

Porque la inferencia solo ve tu ejemplo: si una propiedad está presente, la considera parte del contrato. Si alguna es opcional, elimínala de la lista required del esquema generado.

¿Puedo pegar mi propio esquema en vez de generar uno?

El validador usa el último esquema generado en el paso 1. Si necesitas validar contra un esquema externo complejo, esta herramienta te sirve para una primera comprobación rápida y la definitiva hazla con el validador de tu stack.

¿Funciona con arrays en la raíz?

Sí: si el ejemplo es un array, el esquema describe su tipo y el de sus elementos a partir del primero. Si el array mezcla tipos, ajusta el esquema generado a mano.