# Detector de breaking changes API y planificador de migracion Compara dos esquemas OpenAPI 3.x, detecta cambios incompatibles y propone estrategias de migracion > Página canónica: https://elysiatools.com/es/tools/api-breaking-changes-detector-migration-planner - **Categoría:** Development - **Palabras clave:** openapi, breaking change, api diff, migracion, schema ## Descripción general Ayuda a equipos API a medir impacto de eliminaciones, restricciones de tipos y cambios en campos requeridos. ## Entradas - **Schema OpenAPI anterior** (textarea): openapi: 3.0.3 paths: /users: ... - **Schema OpenAPI nuevo** (textarea): openapi: 3.0.3 paths: /users: ... ## Cuándo usarlo - Antes de lanzar una nueva versión de una API en producción para asegurar que no se rompan las integraciones de los clientes actuales. - Durante la revisión de código (code review) para evaluar el impacto de las modificaciones propuestas en el contrato de la API. - Al planificar la migración de consumidores de una API hacia una nueva versión que incluye cambios estructurales significativos. ## Cómo funciona - Pega el esquema OpenAPI 3.x original en el campo 'Schema OpenAPI anterior'. - Introduce la nueva versión del contrato en el campo 'Schema OpenAPI nuevo'. - La herramienta analiza ambos documentos y detecta diferencias estructurales, evaluando la compatibilidad hacia atrás. - Revisa el reporte HTML generado, que agrupa los 'breaking changes' por nivel de impacto y sugiere estrategias de migración. ## Casos de uso - Prevención de incidentes en producción al detectar campos eliminados o renombrados antes del despliegue. - Generación de guías de actualización (changelogs) precisas para los desarrolladores frontend o clientes externos que consumen la API. - Auditoría de contratos de API en arquitecturas de microservicios para garantizar la compatibilidad entre distintos equipos. ## Preguntas frecuentes ### ¿Qué versiones de OpenAPI soporta la herramienta? Actualmente soporta la comparación de esquemas basados en la especificación OpenAPI 3.x. ### ¿Qué se considera un 'breaking change' en una API? Son cambios que rompen la compatibilidad con clientes existentes, como eliminar un endpoint, cambiar el tipo de un campo de texto a número, o hacer obligatorio un parámetro que antes era opcional. ### ¿La herramienta detecta cambios que no rompen la compatibilidad? Se enfoca principalmente en identificar cambios incompatibles (breaking changes) y evaluar su impacto, para priorizar la estabilidad de las integraciones. ### ¿Mis esquemas OpenAPI se guardan en algún servidor? No, el procesamiento se realiza de manera segura y los esquemas introducidos no se almacenan permanentemente. ### ¿En qué formato se entregan los resultados? Los resultados se presentan en un reporte visual en formato HTML que agrupa los cambios por impacto y detalla los pasos de migración recomendados. ## Herramientas relacionadas - [Probador de regex PCRE2](https://elysiatools.com/es/tools/pcre-regex-tester): Prueba patrones PCRE2 en línea: toda la sintaxis de grupos con nombre ((?P), (?), (?'n')), cuantificadores posesivos, grupos atómicos, \\A \\z \\h — más pcre2grep y la API C. - [Prueba de Rendimiento de Regex](https://elysiatools.com/es/tools/regex-benchmark): Compare el rendimiento de diferentes patrones de regex, identifique cuellos de botella y detecte casos degenerados - [Hoja de Referencia Regex](https://elysiatools.com/es/tools/regex-cheat-sheet): Hoja de referencia buscable y localizada para la sintaxis de expresiones regulares — clases de caracteres, anclas, cuantificadores, grupos y referencias, inspecciones, secuencias de escape y banderas, con un probador rápido integrado - [Analizador de PDF con formulas y graficos](https://elysiatools.com/es/tools/formula-chart-heavy-pdf-analyzer): Compara la extraccion local e hybrid de OpenDataLoader para identificar paginas que requieren ayuda de IA - [Informe de cumplimiento de loudness para podcast](https://elysiatools.com/es/tools/audio-podcast-loudness-compliance-report): Compara LUFS integrado, true peak, LRA, estéreo/mono, bitrate y sample rate contra Apple Podcasts, Spotify, YouTube, ACX y broadcast. - [Procesador de Valores Atípicos](https://elysiatools.com/es/tools/data-outlier-processor): Herramienta avanzada de detección y procesamiento de valores atípicos que identifica, elimina o reemplaza valores anómalos usando múltiples métodos estadísticos. - [Fusión de Quemado de Color de Imagen](https://elysiatools.com/es/tools/image-color-burn): Aplica el modo de fusión quemado de color entre dos imágenes para oscurecimiento dramático y efectos de color intensos - [Fusión de Sobreexposición de Color de Imagen](https://elysiatools.com/es/tools/image-color-dodge): Aplica el modo de fusión sobreexposición de color entre dos imágenes para efectos brillantes, etéreos y luminosos ## Ejemplos - [Colecciones Postman - Pruebas API](https://elysiatools.com/es/samples/postman-collections): Ejemplos completos de colecciones Postman incluyendo pruebas de API, scripts de automatización, variables de entorno, servidores mock y patrones avanzados de prueba para REST APIs - [Ejemplos OpenAI API](https://elysiatools.com/es/samples/openai): Ejemplos comprensivos de la API de OpenAI incluyendo modelos GPT, generación de imágenes DALL-E, procesamiento de audio Whisper y llamadas a funciones - [API Gráfica WebGPU](https://elysiatools.com/es/samples/webgpu): API gráfica moderna para gráficos 3D de alta performance y computación GPU en el navegador - [Muestras FLAC Sin Derechos de Autor](https://elysiatools.com/es/samples/flac-samples): Colección de audio FLAC sin pérdidas para pruebas y desarrollo, incluyendo sonidos de la naturaleza y música de meditación ## Contenido relacionado - [Versionado de API y revision de cambios incompatibles](https://elysiatools.com/es/hubs/api-versioning-breaking-change-review): Compara versiones de API, planifica la migracion y acepta la compatibilidad antes del lanzamiento. Las herramientas no sustituyen el despliegue real ni la monitorizacion. - [Definición de contratos API, validación de esquemas y pruebas de cambios](https://elysiatools.com/es/hubs/api-contract-testing): Define un contrato API, valida esquemas y cargas capturadas, detecta riesgos de compatibilidad y registra la aceptación. - [Flujo utilitario de OpenAPI](https://elysiatools.com/es/hubs/openapi-utility): Genera tipos y documentacion OpenAPI, revisa cambios incompatibles, valida respuestas y endurece el contrato con pruebas de estres y mutacion. - [Herramientas de validación de JSON Schema y contratos API](https://elysiatools.com/es/hubs/json-validate): Compara validación de JSON Schema, comprobaciones de respuesta OpenAPI, mutation testing, stress testing y detección de cambios incompatibles en un solo hub para revisión de contratos API.