Generador de JSON Schema Gratis

El JSON Schema Generator es una herramienta en línea gratuita que crea automáticamente definiciones de JSON Schema a partir de datos JSON de ejemplo, para validar y documentar API.

Sí, es completamente gratuito y no requiere registro. Toda la generación del esquema se realiza en el lado del cliente, dentro de tu navegador.

No, todo el procesamiento se realiza localmente en tu navegador. Tus datos JSON nunca se envían a ningún servidor.

Sí, el JSON Schema Generator es totalmente adaptable y funciona en smartphones y tabletas. Puedes usarlo en cualquier dispositivo con un navegador web moderno, sin necesidad de descargar ninguna aplicación.

No se necesita ninguna cuenta ni registro. Simplemente abre el JSON Schema Generator en tu navegador y empieza a usarlo de inmediato. No hay muros de registro ni restricciones de uso.

El JSON Schema Generator admite una amplia variedad de formatos y lenguajes populares. Consulta la interfaz de la herramienta para ver la lista completa de opciones compatibles.

Simplemente introduce tu contenido en el campo correspondiente, ajusta las opciones a tu gusto y la herramienta lo procesará al instante. Luego puedes copiar el resultado al portapapeles o descargarlo.

El JSON Schema Generator funciona en todos los navegadores modernos, incluidos Chrome, Firefox, Safari, Edge y Opera. Para una mejor experiencia, usa la última versión de tu navegador preferido.

JSON son los datos en sí — el objeto real con valores concretos, como el registro de un usuario o la respuesta de una API. JSON Schema es un documento aparte que describe la forma de esos datos: qué campos existen, de qué tipo es cada uno (string, integer, boolean, array, object), cuáles son obligatorios y qué valores se permiten. Piensa en el JSON como un formulario rellenado y en el JSON Schema como la plantilla en blanco junto con sus reglas. Los validadores leen el schema para comprobar si un payload JSON determinado cumple con él antes de que tu código confíe en esos datos, que es como las APIs detectan solicitudes malformadas a tiempo. Escribes JSON a mano constantemente, pero escribir el schema correspondiente es tedioso cuando los datos están anidados. Esta herramienta invierte ese proceso: pega un objeto JSON de ejemplo y ella infiere un schema completo para que lo termines de ajustar.

Este generador admite cuatro drafts, y la versión correcta depende de tu validador. Draft-07 es el valor por defecto recomendado para proyectos nuevos — es el más compatible entre librerías como Ajv, y es el que asumen la mayoría de los tutoriales. Elige Draft-04 solo si trabajas con herramientas antiguas o heredadas que no se han actualizado. Draft-2019-09 introdujo $defs y las referencias recursivas, mientras que Draft-2020-12 es el más reciente y usa palabras clave de array actualizadas y $dynamicRef; elige estas versiones cuando tu stack las admita explícitamente o cuando necesites sus funciones más nuevas. Cambiar la versión aquí actualiza la URL de $schema en la parte superior del resultado, para que tu validador cargue el conjunto de reglas correcto. Si tienes dudas, empieza con Draft-07 en el selector de versión y cámbialo después si alguna herramienta se queja.

Por defecto, esta herramienta añade additionalProperties: false a cada objeto, lo que indica al validador que rechace cualquier payload que contenga claves ausentes en tu muestra. Es un punto de partida deliberadamente estricto: fija el contrato exactamente a los campos que proporcionaste, de modo que las claves inesperadas o mal escritas fallan la validación en lugar de pasar desapercibidas. Esto es ideal para APIs internas donde quieres una forma estricta y predecible. Sin embargo, puede resultar demasiado rígido para APIs públicas o en evolución que puedan añadir campos opcionales con el tiempo — en esos casos, un campo nuevo rompería a los clientes que usan el schema estricto. La solución es sencilla: elimina esa línea o cámbiala a true para permitir propiedades adicionales. Genera tu schema aquí y luego relaja additionalProperties en los objetos donde tu API realmente permita extensión.

El generador enumera todas las claves no nulas de tu muestra dentro del array required del schema, bajo la suposición de que un campo presente en tu ejemplo se espera que también esté presente en los datos reales. También separa integer de number para que los números enteros queden tipados con precisión, y con la detección de formato activada etiqueta las cadenas que coinciden con patrones conocidos como email, uri, date-time, uuid, ipv4 e ipv6. La advertencia importante es que los campos obligatorios reflejan una sola muestra. Si una clave está ausente o es nula en un payload pero en la práctica es opcional, la herramienta no puede saberlo a partir de un solo ejemplo — así que revisa la lista required y elimina los campos que sean realmente opcionales antes de publicar. Trata el resultado como un buen primer borrador. Pega tu muestra más completa y representativa para obtener de esta herramienta la inferencia de campos obligatorios más precisa.

No sin revisarlas antes. Cuando activas las restricciones, la herramienta añade límites inferidos de tu muestra — minLength y maxLength para strings, minimum y maximum para números, y minItems, maxItems y uniqueItems para arrays cuando los elementos de la muestra son todos distintos. Estos valores se calculan a partir de un solo ejemplo, así que describen lo que tu muestra contenía por casualidad, no las verdaderas reglas de negocio. Por ejemplo, si el nombre de usuario de tu muestra tenía ocho caracteres, el maxLength podría fijarse en ocho aunque nombres más largos sean válidos, lo que rechazaría erróneamente datos reales. Trata cada restricción generada como un valor por defecto razonable para ajustar o relajar, nunca como una regla definitiva. La insignia de estadísticas que muestra el número de propiedades y la profundidad de anidamiento te ayuda a confirmar que la estructura coincide con lo esperado. Genera el schema aquí y luego ajusta los límites según los rangos reales de tus datos antes de desplegarlo.