Validador de Esquema JSON

Valida datos JSON contra un esquema JSON. Mensajes de error detallados con rutas exactas.

1
2
3
JSON Data
JSON Schema

Mejores prácticas de JSON Schema

Escribir mejores esquemas y detectar más errores de validación.

1

Comenzar con campos obligatorios

Primero define el array required, luego agrega restricciones de tipo para cada propiedad.

2

Usar mensajes de error descriptivos

Agrega description a cada propiedad. Ayuda a entender los errores de validación.

3

Usar composición de esquema

allOf, anyOf y oneOf para componer esquemas complejos a partir de simples. $ref para definiciones compartidas.

4

Validar en pipelines CI/CD

Validación de JSON Schema en el pipeline de build para detección temprana de configuraciones inválidas.

Funciones de validación de esquema

Herramientas completas de validación de esquema JSON.

Soporte de drafts de esquema

Soporta JSON Schema Draft 4, 6, 7, 2019-09 y 2020-12.

Informes de error detallados

Mensajes de error precisos con rutas JSON que muestran exactamente dónde falló la validación.

Vista lado a lado

Datos JSON y esquema lado a lado para referencia cruzada fácil.

¿Qué es JSON Schema?

JSON Schema es un vocabulario que permite validar la estructura y el contenido de datos JSON. Describe la forma esperada, los tipos y las restricciones de un documento JSON, de manera similar a cómo un esquema de base de datos define la estructura de una tabla.

Ejemplo básico

Un schema que requiere un campo "name" (cadena) y "age" (número):

JSON Schema
{
  "type": "object",
  "required": ["name", "age"],
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number", "minimum": 0 }
  }
}

Datos válidos

{ "name": "Alice", "age": 30 }

Datos inválidos

{ "name": 123, "age": -5 }

Palabras clave comunes

type

Define el tipo esperado: string, number, object, array, boolean, null

required

Lista las propiedades que deben estar presentes en un objeto

properties

Define esquemas para cada propiedad de un objeto

items

Esquema para los elementos del array — valida cada elemento

enum

Restringe el valor a una lista fija de valores permitidos

pattern

Valida una cadena contra un patrón de expresión regular

Preguntas frecuentes del validador de esquema JSON

¿Qué es JSON Schema?

JSON Schema es un vocabulario para anotar y validar documentos JSON. Define estructura, tipos y restricciones.

¿Qué drafts de esquema se soportan?

Draft 4, 6, 7, 2019-09 y 2020-12. La versión se detecta automáticamente de la clave $schema.

¿Se pueden validar objetos anidados?

Sí, soporte completo para esquemas anidados incluyendo referencias $ref y allOf/anyOf/oneOf.

¿Cómo especifico campos obligatorios?

Agrega un array required al mismo nivel que properties con los nombres de los campos obligatorios.

¿Diferencia entre anyOf, oneOf y allOf?

allOf: debe cumplir todos. anyOf: al menos uno. oneOf: exactamente uno.

¿El validador verifica el esquema mismo?

Sí, el esquema debe ser JSON válido y seguir la sintaxis de JSON Schema.

¿Puedo usar $ref para definiciones compartidas?

Sí, las referencias internas $ref están completamente soportadas. Define sub-esquemas reutilizables.

Herramientas Relacionadas

Explora más herramientas JSON para optimizar tu flujo de trabajo.