Validador de JSON Schema gratis
Validar JSON contra borradores de esquemas compatibles con ubicaciones de error exactas y referencias locales.
Cargando herramienta…
Cómo validar JSON contra un esquema localmente
La validación de la sintaxis JSON solo comprueba si los datos pueden ser analizados. La validación del esquema añade comprobaciones para los campos, tipos, rangos y otras restricciones soportadas.
- Pegar datos JSON o importar un archivo JSON.
- Pega el esquema y selecciona tu borrador de esquema correspondiente.
- Elige si debe informar de todos los errores y ejecutar la validación.
- Lee la instancia y las ubicaciones de palabras clave, arregle los datos o el esquema y descarga el resultado.
¿Quién saca el máximo provecho de los controles de esquema
La validación del esquema ayuda a cualquier persona que recibe JSON de otro sistema y necesita saber que tiene la forma correcta antes de usarlo. Un desarrollador de backend puede probar una carga útil de API de muestra contra el contrato publicado por un equipo asociado. Un probador de QA puede confirmar que un archivo de fijación todavía coincide con el esquema después de que un campo fue renombrado.
También es útil para los archivos de configuración. Muchas herramientas describen sus ajustes con un esquema JSON, para que pueda pegar su configuración y el esquema uno al lado del otro y captar una clave mal escrita o un tipo de valor incorrecto antes de que una implementación falle. Los equipos de datos usan la misma idea para detectar registros erróneos en una exportación antes de subirlos.
Un ejemplo trabajado con la muestra incorporada
Selecciona Cargar ejemplo. El esquema requiere nombre y correo electrónico, limita el nombre a al menos 2 caracteres, espera que el correo electrónico coincida con el formato de correo electrónico, espera que la edad sea un número entero de al menos 18, y establece las Propiedades adicionales a false. Los datos de la muestra, con nombre Sam, correo electrónico sam@example.com y edad 23, devuelve valido: true con una lista de errores vacía.
Ahora cambia los datos para llamar a Sam, edad 16 y un papel adicional de administrador, y eliminar el correo electrónico. Con Report todos los errores de validación activados, el informe lista un error requerido en la ubicación de instancia # para la propiedad de correo electrónico faltante, un error mínimo en #/edad con el mensaje 16 es menor de 18, y un error adicional de Propiedades en #/rol para la propiedad que no está permitido.
También puede ver una entrada adicional de continuaciónPropiedades para la edad, porque una propiedad que falla tu propia regla no se cuenta como evaluado con éxito. Arreglar el problema mínimo y esa entrada adicional desaparece.
Cómo leer el informe de validación
El resultado es un pequeño informe de JSON. El campo válido es verdadero o falso. Cada error lleva cuatro partes: instanciaUbicación apunta al lugar en tus datos, palabra claveUbicación apunta a la regla en el esquema, palabra clave nombra la regla que falló, y error da un mensaje plano. El símbolo # representa la raíz del documento, y cada barra añade un nivel, como #/address/zip.
Cuando el informe de todos los errores de la opción está desactivada, la validación se detiene en el primer fallo. Eso es más rápido para un rápido sí o no respuesta. Déjelo encendido cuando quiera una lista completa de correcciones en un pase. Puede copiar o descargar el informe como archivo JSON para adjuntarlo a un ticket o una revisión de código.
Errores comunes a evitar
Elegir el borrador equivocado es el problema más frecuente. Palabras clave como $defs, prefijoItems yPropiedades no evaluadas pertenecen a nuevos borradores, mientras que las definiciones y la forma de matriz de los elementos provienen de los más antiguos. Coincide el menú de borrador con la línea de $schema en la parte superior de su esquema.
Otro error es señalar $ref a una dirección web. Sólo se aceptan las referencias que comienzan con #, así que mueve definiciones compartidas a $defs dentro del mismo esquema. Finalmente, recuerda los límites: entrada hasta 2 MB, como máximo 80.000 nodos y 60 niveles de anidación. Divide archivos muy grandes en muestras más pequeñas antes de probarlos.
Consejos útiles y limitaciones
- Mantén las referencias dentro del esquema suministrado; las referencias externas están deshabilitadas.
- Elige el borrador correcto y revisa las palabras clave no soportadas antes de confiar en una verificación de esquema.
- Mantén un pequeño conjunto de archivos de muestra conocidos buenos y malos al lado de cada esquema para que pueda volver a comprobar ambos después de cada edición de esquema.
- Lee la ruta de la palabra claveLocation primero, porque le dice si los datos están equivocados o la regla en sí es más estricta de lo que pretendía.
Preguntas frecuentes
¿Qué borradores de JSON Schema puedo seleccionar?
La herramienta ofrece borradores 4, 7, 2019-09 y 2020-12 utilizando un validador local. No todos los vocabularios opcionales son compatibles.
¿La validación del esquema cambia mis valores JSON?
No. La herramienta reporta resultados de validación sin coaccionar valores, rellenar valores predeterminados o reescribir su entrada.
¿Qué significa el símbolo # en una ubicación de error?
Marca la raíz del documento JSON. Cada segmento después de una barra es un nombre de propiedad o índice de array, por lo que #/items/0/price apunta al precio del primer elemento.
¿Puede el esquema en sí ser un booleano?
Sí. El validador acepta un esquema de objeto o un esquema booleano. Un esquema de verdadero acepta cualquier valor y un esquema de falso rechaza cada valor.
¿Por qué sólo obtuve un error cuando mis datos tienen varios problemas?
La opción Informar de todos los errores de validación es probablemente desactivada. En ese modo la validación se detiene en el primer fallo, así que enciéndela de nuevo para listar cada problema en una ejecución.
JSON y los esquemas se ejecutan en un trabajador local. No se obtienen ni se cargan esquemas remotos ni datos de entrada.
Lee nuestra política de privacidad · Acerca de ToolWorld Online