# Detector de rupturas en diff de OpenAPI Compara schemas OpenAPI o GraphQL, marca cambios incompatibles y genera un informe de impacto para equipos de API > Página canónica: https://elysiatools.com/es/tools/openapi-diff-breach-detector - **Categoría:** Development - **Palabras clave:** openapi, graphql, diff, breaking changes, schema, api ## Descripción general Herramienta que compara versiones de esquemas OpenAPI y GraphQL para detectar automáticamente cambios incompatibles antes del despliegue. Analiza diferencias entre la definición anterior y la nueva, clasifica el nivel de riesgo de publicación y genera un informe estructurado con el impacto específico sobre los consumidores de la API. ## Entradas - **Schema anterior** (textarea): Paste the previous OpenAPI YAML/JSON or GraphQL SDL here... - **Schema nuevo** (textarea): Paste the updated OpenAPI YAML/JSON or GraphQL SDL here... - **Tipo de schema** (select) - **Formato de entrada** (text) - **Incluir analisis de impacto** (checkbox) ## Cuándo usarlo - Antes de desplegar una nueva versión de API para validar que no se eliminen campos de respuesta ni se agreguen parámetros obligatorios sin documentar. - Durante revisiones de código en pull requests que modifican contratos de API, para identificar automáticamente rupturas contractuales. - Al auditar compatibilidad hacia atrás entre versiones legacy y nuevas especificaciones durante migraciones de formato. ## Cómo funciona - Pega el contenido del esquema anterior (YAML, JSON o SDL GraphQL) en el campo "Schema anterior" y la versión actualizada en "Schema nuevo". - Selecciona el tipo de esquema (OpenAPI, GraphQL o detección automática) y activa la opción de análisis de impacto para obtener detalles de severidad. - El motor compara estructuras semánticas, identifica cambios incompatibles como campos eliminados o inputs requeridos nuevos, y calcula el riesgo de liberación. - Recibe un informe JSON con el resumen de cambios, áreas impactadas y clasificación de riesgo como alto, medio o bajo. ## Casos de uso - Validación en pipelines CI/CD para bloquear despliegues automáticos que contengan cambios incompatibles no intencionales. - Revisiones de contratos entre equipos backend y frontend para documentar modificaciones de interfaz antes de la implementación. - Auditoría de versiones al actualizar APIs públicas para garantizar compatibilidad con integraciones de terceros existentes. ## Preguntas frecuentes ### ¿Qué formatos de esquema soporta la herramienta? OpenAPI (Swagger) 2.0 y 3.0 en YAML o JSON, además de GraphQL Schema Definition Language (SDL). ### ¿Cómo identifica los cambios incompatibles? Compara campos de respuesta, parámetros de entrada, tipos y requisitos de obligatoriedad entre ambas versiones para detectar eliminaciones o nuevas restricciones. ### ¿Qué significa el "riesgo de publicación" en el resultado? Indica la probabilidad de que los cambios generen errores en clientes existentes: "high" cuando existen cambios breaking confirmados que rompen la compatibilidad. ### ¿Es posible comparar sin especificar el tipo de esquema? Sí, seleccionando "Auto detect" el sistema identifica automáticamente si el contenido corresponde a OpenAPI o GraphQL. ### ¿El informe detalla el impacto específico por cambio? Sí, cuando se activa el análisis de impacto, cada cambio incompatible incluye una descripción del efecto sobre consumidores, como mutaciones que requieren nuevos campos obligatorios. ## Herramientas relacionadas - [Probador de estres de contratos API](https://elysiatools.com/es/tools/api-contract-stress-tester): Genera casos de prueba de valores limite desde OpenAPI 3.x y opcionalmente los envia a un backend real para detectar desviaciones del contrato. - [Sincronizador de paleta Tailwind](https://elysiatools.com/es/tools/tailwind-color-palette-sync): Introduce HEX, elige esquema de nombres (escala 50–950 / nombre único / anidamiento) y genera el fragmento theme.extend.colors de tailwind.config.ts con niveles WCAG AA/AAA por color. Modo oscuro opcional. - [Explicador de Expresiones Cron](https://elysiatools.com/es/tools/cron-expression-explainer): Analiza una expresión cron de 5/6 campos o Quartz en una descripción en lenguaje natural, desglosa los campos y lista las próximas N ejecuciones en cualquier zona IANA, con una explicación natural generada por IA - [Generador de layout masonry CSS](https://elysiatools.com/es/tools/css-masonry-layout-generator): Genera layouts masonry puros en CSS con breakpoints, espaciado configurable y selectores omitidos - [Conversor de cURL a Go (net/http)](https://elysiatools.com/es/tools/curl-to-go): Convierte un comando cURL en un fragmento de código Go net/http con http.NewRequest, cabeceras y cuerpo - [Conversor de cURL a JavaScript (axios)](https://elysiatools.com/es/tools/curl-to-js-axios): Convierte un comando cURL en un fragmento de código JavaScript axios con objeto de configuración, cabeceras y datos - [Conversor de cURL a JavaScript (fetch)](https://elysiatools.com/es/tools/curl-to-js-fetch): Convierte un comando cURL en un fragmento de código JavaScript fetch() con cabeceras, cuerpo y método - [Conversor de cURL a PHP (cURL)](https://elysiatools.com/es/tools/curl-to-php): Convierte un comando cURL en un fragmento de código PHP cURL con curl_setopt, cabeceras y campos POST ## Ejemplos - [Ejemplos OpenAPI/Swagger](https://elysiatools.com/es/samples/openapi): Ejemplos de especificación OpenAPI/Swagger para documentación y definición de contratos de API REST - [Ejemplos OpenAPI/Swagger](https://elysiatools.com/es/samples/openapi-swagger): Ejemplos completos de documentación API usando OpenAPI 3.0 y especificaciones Swagger para servicios RESTful - [Ejemplos de Procesamiento de Imágenes Android Java](https://elysiatools.com/es/samples/android-image-processing-java): Ejemplos de procesamiento de imágenes Android Java incluyendo lectura/escritura, escalado y conversión de formato - [Ejemplos de Procesamiento de Imágenes Android Kotlin](https://elysiatools.com/es/samples/android-image-processing-kotlin): Ejemplos de procesamiento de imágenes Android Kotlin incluyendo lectura/escritura, escalado y conversión de formato ## Contenido relacionado - [Herramientas de documentación OpenAPI, codegen y revisión de contratos](https://elysiatools.com/es/hubs/openapi-utility): Compara generación de código OpenAPI, documentación API, diff de schemas, validación de respuestas y pruebas de contratos en un solo hub para diseño y mantenimiento de APIs. - [Herramientas de pruebas de contratos API, mocking y revisión de esquemas](https://elysiatools.com/es/hubs/api-contract-testing): Genera tipos y documentación desde OpenAPI, crea mocks, valida respuestas reales y revisa cambios de esquema críticos en un solo hub. - [Herramientas de versionado de API, cambios incompatibles y revision de lanzamiento](https://elysiatools.com/es/hubs/api-versioning-breaking-change-review): Compara versiones de API, detecta cambios incompatibles en el esquema, valida compatibilidad real de respuestas y revisa semver y changelogs en un solo hub de pre-lanzamiento. - [Herramientas de Diff y Comparación de Archivos y Datos](https://elysiatools.com/es/hubs/file-data-diff-comparison-tools): Compara dos archivos, payloads, esquemas o conjuntos de datos lado a lado y resalta lo que cambió: texto, JSON, CSV/Excel, PDF, imágenes, audio, bases de datos, APIs y configuraciones.