Diff OpenAPI e importaciones de colección

Qué compara Capydox

El diff estructural normaliza OpenAPI y colecciones importadas al mismo modelo interno y detecta:

• Endpoints añadidos o eliminados
• Endpoints modificados (descripción, tags, parámetros, request body, respuestas, auth)

No es un diff textual de JSON/YAML: evita falsos positivos por formato o cifrado en almacenamiento.

OpenAPI del workspace

1. Abre el Editor OpenAPI.
2. Pulsa Comparar specs.
3. Elige versión Desde y Hasta (por defecto: penúltima vs última guardada).

El historial disponible depende del plan (Free: comparación básica; Starter+: historial ampliado).

Colecciones importadas

Tras reimportar un archivo Postman, Insomnia o ApiDog sobre una colección existente:

• Se guarda un snapshot de la importación anterior.
• Puedes ver Qué cambió inmediatamente o abrir Historial de importaciones desde el editor de documento de la colección.
• Si hay OpenAPI vinculada, también puedes comparar Colección vs OpenAPI vinculada.

Documentación desactualizada (drift)

Si ya generaste Markdown/evidencia y la fuente cambia, el estado pasa a Modificado y aparece el aviso Fuente modificada. En Pro+ también recibirás notificación in-app (SOURCE_DRIFT).

Acciones recomendadas: revisar el diff y regenerar documentación desde plantilla cuando corresponda.

Vista profesional (v2)

El comparador incluye pestañas estilo Git:

• Resumen — contadores + lista compacta (git diff --stat)
• Estructural — hunks unified por endpoint (verde Capydox #03A63C para adiciones)
• Fuente — YAML/JSON crudo con toggle Unified o Split (Monaco)
• Documentación — diff del Markdown generado (cuando hay snapshots)

En endpoints modificados con OpenAPI, los cambios de JSON Schema (propiedades, required, tipos) aparecen como sub-hunks.

Planes