# Detector de breaking changes de API e planejador de migracao Compara dois schemas OpenAPI 3.x, encontra mudancas incompatíveis e sugere estrategias de migracao > Página canônica: https://elysiatools.com/pt/tools/api-breaking-changes-detector-migration-planner - **Categoria:** Development - **Palavras-chave:** openapi, breaking change, api diff, migracao, schema ## Visão geral Ajuda equipes de API a avaliar remocoes de campos, restricoes de tipo e novas obrigatoriedades. ## Entradas - **Schema OpenAPI antigo** (textarea): openapi: 3.0.3 paths: /users: ... - **Schema OpenAPI novo** (textarea): openapi: 3.0.3 paths: /users: ... ## Quando usar - Antes de lançar uma nova versão da API em produção para garantir que clientes existentes não sejam afetados. - Durante a revisão de pull requests (PRs) que alteram os contratos da API para validar o impacto das mudanças. - Ao planejar a depreciação de endpoints ou campos antigos, buscando estratégias de migração seguras. ## Como funciona - Cole o schema OpenAPI 3.x da versão atual (antiga) no campo 'Schema OpenAPI antigo'. - Insira o schema OpenAPI 3.x da nova versão proposta no campo 'Schema OpenAPI novo'. - A ferramenta processa e compara ambos os contratos, detectando alterações estruturais e de validação. - Um relatório em HTML é gerado, destacando as quebras de compatibilidade (breaking changes) e sugerindo ações de mitigação. ## Casos de uso - Prevenção de falhas em aplicativos mobile ou web que consomem a API após uma atualização de backend. - Auditoria de contratos de API em arquiteturas de microsserviços para manter a compatibilidade entre equipes. - Geração de documentação de changelog focada em alterações críticas para os consumidores da API. ## Perguntas frequentes ### Quais versões do OpenAPI são suportadas? A ferramenta suporta a comparação de schemas no formato OpenAPI 3.x. ### O que é considerado um breaking change? Alterações que quebram a integração do cliente, como remover um endpoint, excluir um campo de resposta, alterar o tipo de um dado ou tornar um campo de requisição obrigatório. ### A ferramenta corrige os schemas automaticamente? Não, ela atua como um analisador estático. O resultado aponta os problemas e sugere estratégias de migração, mas a correção deve ser feita manualmente no seu código. ### Posso comparar contratos em JSON e YAML? Sim, você pode colar o conteúdo do seu schema em formato YAML ou JSON diretamente nos campos de texto. ### Os meus schemas de API são armazenados no servidor? O processamento ocorre com os dados fornecidos na interface, sem armazenamento persistente dos seus contratos de API. ## Ferramentas relacionadas - [Testador de regex PCRE2](https://elysiatools.com/pt/tools/pcre-regex-tester): Teste padrões PCRE2 online: toda a sintaxe de grupos nomeados ((?P), (?), (?'n')), quantificadores possessivos, grupos atômicos, \\A \\z \\h — mais pcre2grep e a API C. - [Benchmark de Regex](https://elysiatools.com/pt/tools/regex-benchmark): Compare o desempenho de diferentes padrões regex, identifique gargalos e detecte casos degenerativos - [Folha de Consulta Regex](https://elysiatools.com/pt/tools/regex-cheat-sheet): Uma folha de consulta pesquisável e localizada para a sintaxe de expressões regulares — classes de caracteres, âncoras, quantificadores, grupos e referências, lookaheads, sequências de escape e flags, com um testador rápido integrado - [Analisador de PDF com formulas e graficos](https://elysiatools.com/pt/tools/formula-chart-heavy-pdf-analyzer): Compara a extracao local e hybrid do OpenDataLoader para identificar paginas que merecem parsing assistido por IA - [Relatório de conformidade de loudness para podcast](https://elysiatools.com/pt/tools/audio-podcast-loudness-compliance-report): Compara LUFS integrado, true peak, LRA, estéreo/mono, bitrate e taxa de amostragem com Apple Podcasts, Spotify, YouTube, ACX e broadcast. - [Processador de Outliers de Dados](https://elysiatools.com/pt/tools/data-outlier-processor): Ferramenta avançada de detecção e processamento de outliers que identifica, remove ou substitui valores anômalos em dados numéricos usando múltiplos métodos estatísticos. Perfeita para limpeza de dados, análise estatística e preparação de dados para machine learning. Recursos: - Múltiplos métodos de detecção (IQR, Z-score, Z-score modificado, Isolation Forest) - Estratégias flexíveis de manejo (Remover, Substituir por média/mediana/moda, Limitar) - Otimização automática de limiares - Detecção de outliers multidimensional - Estatísticas e relatórios visuais de outliers - Capacidades de processamento em lote - Níveis de sensibilidade personalizáveis - Análise de impacto abrangente Casos de Uso Comuns: - Limpeza e pré-processamento de dados - Preparação para análise estatística - Limpeza de conjuntos de dados para machine learning - Controle de qualidade na manufatura - Detecção de anomalias financeiras - Validação de dados de sensores - [Mistura de Escurecimento de Cor de Imagem](https://elysiatools.com/pt/tools/image-color-burn): Aplica o modo de mistura escurecimento de cor entre duas imagens para escurecimento dramático e efeitos de cor intensos - [Mistura de Clareamento de Cor de Imagem](https://elysiatools.com/pt/tools/image-color-dodge): Aplica o modo de mistura clareamento de cor entre duas imagens para efeitos brilhantes, etéreos e luminosos ## Exemplos - [Coleções Postman - Testes de API](https://elysiatools.com/pt/samples/postman-collections): Exemplos abrangentes de coleções Postman incluindo testes de API, scripts de automação, variáveis de ambiente, servidores mock e padrões avançados de teste para REST APIs - [Exemplos OpenAI API](https://elysiatools.com/pt/samples/openai): Exemplos abrangentes da API OpenAI incluindo modelos GPT, geração de imagens DALL-E, processamento de áudio Whisper e chamadas de função - [API Gráfica WebGPU](https://elysiatools.com/pt/samples/webgpu): API gráfica moderna para gráficos 3D de alta performance e computação GPU no navegador - [Amostras de Áudio FLAC Livres de Direitos Autorais](https://elysiatools.com/pt/samples/flac-samples): Coleção de áudio FLAC sem perdas para testes e desenvolvimento, incluindo sons da natureza e música de meditação ## Conteúdo relacionado - [Versionamento de API e revisao de breaking changes](https://elysiatools.com/pt/hubs/api-versioning-breaking-change-review): Compare versoes de API, planeje migracoes e aceite a compatibilidade antes do release. As ferramentas nao substituem o deploy real nem o monitoramento. - [Definição de contratos de API, validação de schemas e testes de mudanças](https://elysiatools.com/pt/hubs/api-contract-testing): Defina um contrato de API, valide schemas e payloads capturados, encontre riscos de compatibilidade e registre a aceitação. - [Fluxo utilitario de OpenAPI](https://elysiatools.com/pt/hubs/openapi-utility): Gere tipos e documentacao OpenAPI, revise quebras, valide respostas e endureca o contrato com testes de estresse e mutacao. - [Ferramentas de validação de JSON Schema e contratos de API](https://elysiatools.com/pt/hubs/json-validate): Compare validação de JSON Schema, checagem de resposta OpenAPI, mutation testing, stress testing e detecção de mudanças incompatíveis em um único hub para revisão de contratos de API.