¿Qué es JSON Schema?
JSON Schema es un vocabulario definido por la IETF (Internet Engineering Task Force) que permite describir la estructura, las restricciones y las reglas de validación de datos JSON. Un JSON Schema especifica qué propiedades debe tener un objeto, los tipos de datos permitidos, intervalos de valores, patrones de cadenas, tamaños de arrays y mucho más. Se utiliza ampliamente para validar las requisiciones y las respuestas de API, generar formularios, validar archivos de configuración y documentar datos. JSON Schema ofrece drafts del Draft-04 al Draft 2020-12. Esta herramienta permite generar automáticamente un JSON Schema a partir de datos JSON de ejemplo, útil como punto de partida, y validar cualquier documento JSON con un schema usando la biblioteca Ajv (Another JSON Validator), el validador de JSON Schema más utilizado en el ecosistema JavaScript.
Cómo usar esta herramienta de JSON Schema gratis en línea
- 1Elija entre 'Generate Schema' y 'Validate JSON'_ en las abas superiores.
- 2Para generar un schema, cole un objeto JSON de ejemplo en el área de entrada. La herramienta proporciona automáticamente los tipos y genera un JSON Schema que se puede usar como punto de partida.
- 3Para validar JSON, recopilar los datos JSON que desea validar en el primer campo y el JSON Schema en el segundo. Haga clic en el botón 'Validate'.
- 4Consulte el resultado de la validación: un mensaje verde indica que JSON está de acuerdo con el schema; un mensaje rojo lista todos los errores de validación y sus respectivos caminos.
- 5Haga clic en el botón Copiar para copiar el schema generado o los resultados de la validación.
Casos de uso comunes para JSON Schema
Generador y validador de JSON Schema — gratis en línea
Establezca JSON Schemas para los cuerpos de las requisiciones y respuestas de su API, garantizando que los clientes envíen datos válidos y los servidores vuelvan a las estructuras esperadas.
Generador y validador de JSON Schema — gratis en línea
Cree schemas para archivos de configuración de la aplicación y detecte errores antes de que produzcan fallos en tiempo de ejecución en la producción.
Generador y validador de JSON Schema — gratis en línea
Crea rápidamente la base de un JSON Schema con datos de ejemplo en lugar de escribirlo desde cero. Refine el schema generado añadiendo restricciones, como campos obligatorios y estándares.
Generador y validador de JSON Schema — gratis en línea
JSON Schema se utiliza por bibliotecas como react-jsonschema-form y vue-jsonschema-form para generar automáticamente formularios de UI con validación integrada.
Generador y validador de JSON Schema — gratis en línea
Valide datos recibidos en pipelines ETL con un schema para rechazar registros malformados antes de que corrompam su fecha warehouse.
Preguntas frecuentes
¿Qué draft de JSON Schema esta herramienta acepta?
El mecanismo de validación Ajv acepta JSON Schema Draft-07 por estándar, el draft más adoptado. El generador produce schemas compatibles con Draft-04 y versiones posteriores. Para recursos de Draft 2019-09 o 2020-12, tal vez sea necesario añadir los plugins ajv-formats o ajv-keywords.
¿Cuál es la precisión del schema generado automáticamente?
El schema generado infiere los tipos con base en los datos de ejemplo suministrados, identificando correctamente cadenas, números, booleanos, arrays y objetos. Sin embargo, no puede inferir restricciones como valores mínimos y máximos, patrones de cadenas (regex), campos obligatorios o valores enum. Trate el schema generado como punto de partida y lo refine manualmente.
¿Qué significa 'allErrors: true' en la validación?
Por estándar, Ajv para el primer error de validación. Con 'allErrors: true', continúa la verificación e informa todos los errores encontrados, ofreciendo una visión completa de los problemas en una sola ejecución. Esto es más útil para depuración, pero puede ser un poco más lento en documentos muy grandes.
¿Esta herramienta es gratuita y privada?
Sí. La generación de schemas y la validación se ejecutan completamente en el navegador con las bibliotecas JavaScriptto-json-schema y Ajv. Ningún dato es enviado a servidores y no es necesario crear una cuenta.