Generador de JSON Schema
Genera un JSON Schema a partir de datos JSON de ejemplo. Detecta los tipos, los objetos anidados, las matrices y las propiedades obligatorias para que puedas copiarlo o descargarlo. Se ejecuta en tu navegador.
Entrada
Salida
Leerme
¿Qué hace el generador de JSON Schema?
Escribe un JSON Schema a partir de un ejemplo de tus datos. Pega una muestra, como una respuesta de API, un archivo de configuración o un registro de una exportación de base de datos, y obtendrás un esquema que describe su estructura: el tipo de cada valor, las propiedades de cada objeto, cómo son los elementos de cada array y qué propiedades son obligatorias. Es un punto de partida rápido para la documentación de API, las especificaciones de OpenAPI, la validación de formularios o los contratos de datos, que luego puedes ajustar manualmente.
Cómo usarlo
- Pega o escribe un JSON de ejemplo en el cuadro de entrada.
- Elige el borrador de JSON Schema para la línea
$schema: Draft 2020-12 o Draft 7. - Elige si las propiedades deben marcarse como obligatorias.
- Copia el esquema o descárgalo como
schema.json.
Si la muestra no es un JSON válido, la herramienta indica la línea y la columna del problema y lo marca.
Cómo se obtiene el esquema
- A cada valor se le asigna su tipo JSON:
string,boolean,null,object,arrayeintegerpara números enteros onumberpara números con decimales. A un array de números enteros y decimales se le asignanumber, que abarca ambos casos. - A cada objeto se le añade una entrada
propertiespor cada clave, descrita del mismo modo y con la profundidad que permita la muestra. - A cada array se le asigna un único esquema
itemsque se ajusta a todos sus elementos. Si los elementos son objetos, sus propiedades se combinan, de modo que una lista de registros genera un solo esquema para un registro. - A los valores de tipos distintos se les asignan todos los tipos en una lista, como
["string", "null"], o unanyOfcuando se mezclan objetos y otros valores. - A un array vacío se le asigna
"type": "array"sinitems, ya que no hay nada que describir.
Propiedades obligatorias
Con la opción «Marcar las propiedades como obligatorias» activada, cada objeto incluye sus claves en required. En un array de objetos, una propiedad solo es obligatoria si está presente en todos los elementos: en una lista de miembros donde solo algunos tienen favorite, esa propiedad es opcional. Desactiva la opción para obtener un esquema sin listas required.
Lo que no se puede deducir de una muestra
Un esquema creado a partir de un único ejemplo solo conoce lo que muestra ese ejemplo. No puede saber qué valores de tipo string son direcciones de correo electrónico o fechas, qué rangos pueden tener los números ni si una propiedad que aparece una vez también podría faltar. Añade manualmente format, minimum, maxLength, enum o pattern cuando los necesites y valida los datos con el resultado usando el validador de JSON Schema.
Cómo funciona
La herramienta utiliza genson-js, una adaptación de GenSON para JavaScript que crea esquemas. Las palabras clave que genera significan lo mismo en Draft 7 y Draft 2020-12, así que el borrador solo cambia la línea $schema. Todo se ejecuta en tu navegador: la muestra nunca se carga en un servidor.
Características
- JSON Schema a partir de cualquier muestra JSON
- Tipos, objetos anidados y arrays identificados automáticamente
- Elementos de array combinados en un único esquema, con las propiedades opcionales identificadas
- Draft 2020-12 o Draft 7
- Propiedades obligatorias activadas o desactivadas
- Copia o descarga como
schema.json - Se ejecuta en tu navegador