01
Identificar al consumidor
El ajuste inicial es datos viejos → esquema nuevo. Invierte si el consumidor viejo tendrá que leer mensajes recién generados.
Esquemas y tipos
comparador de esquemas JSONUna diferencia, dos direcciones
Pega dos versiones de JSON Schema o carga un ejemplo; indica qué productor entrega datos a qué consumidor.
comparador de esquemas JSON
Esquema JSON anterior
Esquema JSON nuevo
Los dos esquemas se procesan en este navegador. No se envían entradas ni se solicitan URL de referencia.
Listo para una comprobación manual.
Diferencias
Una API puede conservar registros antiguos mientras actualiza el servicio que los lee. El comparador de esquemas JSON muestra cambios de restricciones, no solo líneas distintas.
Cuando un consumidor antiguo debe aceptar datos nuevos, invierte la dirección. El comparador de esquemas JSON separa una propiedad opcional de un requisito nuevo.
¿Por qué usar el comparador de esquemas JSON?
La dirección del flujo cambia el sentido de una modificación.
Fijar quién produce y quién recibe
Por defecto se evalúan datos antiguos frente al esquema nuevo. La dirección contraria muestra riesgos para aplicaciones que aún usan el contrato anterior.
Señalar lo que falta comprobar
El comparador de esquemas JSON deja $ref y reglas combinadas para revisión manual. Nunca convierte una inferencia incompleta en una garantía verde.
Elegir el sentido antes de interpretar
02
Seguir la ruta exacta
Los nombres requeridos aparecen bajo /required y los tipos dentro de /properties. El filtro de riesgos conserva los casos por revisar.
03
Volver a ejecutar antes de exportar
Editar un esquema o cambiar la dirección invalida el resultado. Ctrl/Cmd+Enter ejecuta otra comparación y habilita la copia.
Cambios que sí se pueden localizar
Requisitos y tipos
Comparar JSON Schema permite detectar required añadido y conjuntos de type más estrechos. Esos cambios incompatibles posibles dependen del flujo elegido.
Enum y límites
La compatibilidad de esquemas se examina con miembros enum y límites de número, longitud y cantidad. Reordenar valores enum no genera una diferencia.
Informe reutilizable
Las diferencias entre esquemas JSON incluyen JSON Pointer, valores previos y nuevos y nivel de riesgo. Puedes descargar el informe completo en JSON.
Límites de la señal de riesgo
- No demuestra todos los casos
- El comparador de esquemas JSON solo evalúa reglas cubiertas. No prueba la compatibilidad de todas las instancias ni de la lógica de la aplicación.
- Sin resolver referencias
- $ref y condiciones como oneOf quedan para revisión. No se accede a URL externas ni se expanden ciclos de referencias locales.
- Una propiedad no es obligatoria por sí sola
- Añadir un nombre en properties no equivale a incluirlo en required. additionalProperties y otras restricciones pueden cambiar el resultado.
Preguntas sobre el comparador de esquemas JSON
¿Qué modos de diff soporta este validador de JSON Schema?
Compara la estructura y las restricciones de dos versiones y asigna señales según la dirección de los datos.
¿El modo normalizado ignora el orden de las claves del esquema?
Sí. El orden de las claves, y el de los elementos de required o enum, se ignora si la regla no cambia.
¿Puede ayudar con esquemas que tienen muchas $ref?
Se muestra la ruta $ref, pero no se resuelve su destino ni se consulta una URL.
¿En qué se diferencia un diff de JSON de un diff de texto?
Un diff JSON compara datos estructurados; uno de texto compara caracteres. Aquí también se interpreta una parte de las restricciones del esquema.
¿Se suben mis datos y qué tamaño admite?
No se suben. Cada entrada admite 500 000 caracteres y el total 1 000 000; si se supera, no se entrega un informe parcial.
¿Hay un caso de esquema que debamos revisar?
Usar el comparador de esquemas JSON
Conserva ambas versiones, selecciona el flujo y guarda las rutas modificadas. El comparador de esquemas JSON aporta un informe para la revisión de la versión.