Comparar textos

La distancia entre un diff y una explicación

El control de versiones nos dio un excelente diff a nivel de línea desde hace décadas, y es la herramienta correcta cuando lo que importa es el código o la redacción exacta. Pero los cambios en prosa casi nunca se alinean con esa limpieza: un párrafo se reescribe, una frase se mueve, una cláusula se reformula para decir algo sutilmente distinto. Un diff a nivel de carácter sobre ese tipo de edición produce una pared de rojo y verde que técnicamente muestra todo y comunica casi nada. Este endpoint está pensado para el segundo tipo de cambio: sustantivo, reformulado y fácil de pasar por alto en un diff crudo.

Qué devuelve realmente la comparación

Envía por POST dos versiones de texto a /text/compare. La tarea corre de forma asíncrona y entrega, por webhook o enlace firmado, un resumen estructurado: qué se agregó, qué se eliminó, qué se reformuló y una nota breve sobre la intención o el impacto aparente de cada cambio sustantivo. Se parece más a lo que un editor atento diría después de leer ambos borradores que a un diff con resaltado de sintaxis.

Dónde ya existe esta comparación, de forma informal

Los equipos legales han pagado durante años a asistentes para marcar a mano las revisiones de contratos, precisamente porque pasar por alto una cláusula reformulada tiene consecuencias serias, y las herramientas de 'control de cambios' solo resuelven la mitad del problema cuando lo que cambia es la redacción y no solo una inserción o eliminación. Editores que comparan borradores de manuscritos, equipos de cumplimiento que revisan políticas y equipos de soporte que auditan notas de versión hacen hoy una versión manual de esto. La tarea automatiza esa lectura, no el juicio que viene después.

Pensado para un flujo, no para un clic aislado

Al ser asíncrono y cobrarse por llamada, el endpoint encaja en flujos recurrentes: un sistema de gestión documental llama a /text/compare cada vez que se revisa una plantilla de contrato, o un pipeline de documentación lo ejecuta en cada nota de versión contra la anterior. No se cobra nada por una tarea que falla del todo; los reintentos ocurren automáticamente hasta tres veces antes de devolver un error claro, así que un lote de comparaciones mantiene un costo predecible.

Qué sí y qué no le dirá

El resultado es un relato factual de las diferencias y una lectura en lenguaje claro de su probable importancia; no emite una opinión legal ni certifica cumplimiento normativo. Trátelo como una primera pasada, rápida, que señala qué merece una revisión humana más cercana, ahorrando el tiempo de escanear dos documentos largos en paralelo para encontrar el puñado de cambios que realmente importan.