Ejemplo práctico
Valida {"age":"18"} contra un esquema que exige un entero. El JSON es sintácticamente válido, pero la cadena sigue violando el contrato de la API.
type, required, properties, itemsenum, minLength, minimumadditionalProperties: falsetype: ["string", "null"]Un validador/generador de esquemas JSON le ayuda a crear un esquema JSON a partir de un JSON de muestra y validar datos JSON con un esquema existente.
Esto es útil para contratos de API, validación de backend, prueba de respuestas estructuradas y documentación de formatos de carga útil esperados.
Marque campos como required solo cuando todo payload válido deba incluirlos. Optional funciona mejor para rollouts graduales y respuestas parciales.
Use additionalProperties false cuando campos inesperados deban fallar, pero evítelo si los clientes pueden enviar metadata compatible a futuro.
Represente nullables explícitamente con arrays de tipo como ["string", "null"] para no confundir null con campo ausente.
Agregue enum, minimum, minLength y constraints similares después de generar para acercar el schema al contrato real.
También puede editar el esquema generado manualmente. Esta versión admite reglas comunes como tipo, requerido, enumeración, longitud mínima, mínimo, tipos que aceptan valores NULL, elementos de matriz y propiedades adicionales.
{
"type": "object",
"required": ["name"],
"properties": {
"name": {
"type": "string",
"minLength": 2
},
"age": {
"type": "integer",
"minimum": 18
},
"status": {
"type": "string",
"enum": ["active", "disabled"]
},
"nickname": {
"type": ["string", "null"]
}
},
"additionalProperties": false
}
Aprenda el workflow detrás de esta herramienta y qué revisar después.
Un proceso de creación de esquemas que convierte datos válidos y erróneos en documentación ejecutable, en lugar de depender de un único ejemplo ideal.
Un proceso repetible para separar errores de transporte, problemas de sintaxis JSON y fallos del contrato de datos en las respuestas de una API.
Un workflow práctico para formatear JSON, encontrar errores de sintaxis, validar la forma del payload y revisar el status cuando los datos de API no cuadran.
La validación hace explícitas las suposiciones del contrato antes de que se conviertan en bugs o fallos de integración.
Confirme qué campos deben existir, cuáles pueden omitirse y cuáles pueden ser null.
Revise arrays, objetos, números, enums, fechas y formatos de string contra la forma esperada.
Compare respuestas de ejemplo después de cambios de API, proveedores o versiones de webhook.
Use las rutas de validación para encontrar la propiedad exacta que falló.
Valida {"age":"18"} contra un esquema que exige un entero. El JSON es sintácticamente válido, pero la cadena sigue violando el contrato de la API.
oneOf, anyOf, los campos nullable y additionalProperties pueden producir resultados sorprendentes cuando esquemas superpuestos aceptan el mismo valor.
Guardo payloads fallidos representativos junto al esquema, porque los casos de error exponen la ambigüedad del contrato más rápido que una muestra perfecta.
Estas herramientas también pueden resultarle útiles.