# Detector de quebra em diff OpenAPI Compara schemas OpenAPI ou GraphQL, marca breaking changes e gera um relatorio de impacto para equipes de API > Página canônica: https://elysiatools.com/pt/tools/openapi-diff-breach-detector - **Categoria:** Development - **Palavras-chave:** openapi, graphql, diff, breaking changes, schema, api ## Visão geral O Detector de quebra em diff OpenAPI é uma ferramenta essencial para equipes de desenvolvimento que precisam comparar schemas OpenAPI ou GraphQL antes de realizar deploys. Ele analisa as versões antiga e nova da sua API, identifica automaticamente alterações que quebram a compatibilidade (breaking changes) e gera um relatório detalhado de impacto, garantindo integrações mais seguras e previsíveis. ## Entradas - **Schema antigo** (textarea): Paste the previous OpenAPI YAML/JSON or GraphQL SDL here... - **Novo schema** (textarea): Paste the updated OpenAPI YAML/JSON or GraphQL SDL here... - **Tipo de schema** (select) - **Formato de entrada** (text) - **Incluir analise de impacto** (checkbox) ## Quando usar - Antes de aprovar pull requests que alteram contratos de API para evitar quebras em clientes existentes. - Durante o planejamento de novas versões de APIs GraphQL ou REST para avaliar o impacto de novos campos obrigatórios. - Ao auditar mudanças em documentações OpenAPI/Swagger para garantir que nenhuma rota ou parâmetro foi removido acidentalmente. ## Como funciona - Cole o schema antigo (OpenAPI YAML/JSON ou GraphQL SDL) no campo 'Schema antigo'. - Insira a versão atualizada do contrato no campo 'Novo schema'. - Selecione o tipo de schema (OpenAPI ou GraphQL) ou deixe em detecção automática e marque a opção de análise de impacto. - A ferramenta processará as diferenças e retornará um relatório JSON destacando o risco da release e as breaking changes encontradas. ## Casos de uso - Revisão automatizada de contratos de API para bloquear deploys com breaking changes. - Comunicação clara entre equipes de backend e frontend sobre alterações em endpoints REST ou mutations GraphQL. - Geração de relatórios de impacto técnicos para consumidores de APIs públicas. ## Perguntas frequentes ### Quais formatos de schema a ferramenta suporta? A ferramenta suporta especificações OpenAPI (Swagger) em YAML ou JSON, além de schemas GraphQL (SDL). ### O que é considerado uma 'breaking change'? Alterações como remoção de rotas, exclusão de campos de resposta, adição de parâmetros obrigatórios ou mudanças de tipo de dados que quebram a integração de clientes atuais. ### Posso desativar a análise de impacto? Sim, você pode desmarcar a opção 'Incluir análise de impacto' se desejar apenas uma lista simples das diferenças estruturais. ### A ferramenta detecta mudanças que não quebram a API? Sim, o relatório JSON também pode resumir alterações seguras (non-breaking changes), como a adição de campos opcionais ou novas rotas. ### Como o risco da release é calculado? O risco é classificado como 'high' (alto) sempre que uma ou mais breaking changes são detectadas, alertando a equipe sobre possíveis falhas em produção. ## Ferramentas relacionadas - [Testador de estresse de contrato de API](https://elysiatools.com/pt/tools/api-contract-stress-tester): Gera casos de limite a partir de OpenAPI 3.x e opcionalmente envia ao backend real para detectar divergencias do contrato. - [Sincronizador de paleta Tailwind](https://elysiatools.com/pt/tools/tailwind-color-palette-sync): Insira HEX, escolha o esquema de nomes (escala 50–950 / nome único / aninhamento) e gere o fragmento theme.extend.colors do tailwind.config.ts com níveis WCAG AA/AAA. Dark mode opcional. - [Explicador de Expressões Cron](https://elysiatools.com/pt/tools/cron-expression-explainer): Analisa uma expressão cron (5/6 campos ou Quartz) em uma descrição em linguagem natural, detalha os campos e lista as próximas N execuções em qualquer zona IANA, com explicação por IA - [Gerador de layout masonry CSS](https://elysiatools.com/pt/tools/css-masonry-layout-generator): Gera layouts masonry em CSS puro com breakpoints, espacamento configuravel e seletores ignorados - [Conversor de cURL para Go (net/http)](https://elysiatools.com/pt/tools/curl-to-go): Converte um comando cURL em um snippet de código Go net/http com http.NewRequest, cabeçalhos e corpo - [Conversor de cURL para JavaScript (axios)](https://elysiatools.com/pt/tools/curl-to-js-axios): Converte um comando cURL em um snippet de código JavaScript axios com objeto de configuração, cabeçalhos e dados - [Conversor de cURL para JavaScript (fetch)](https://elysiatools.com/pt/tools/curl-to-js-fetch): Converte um comando cURL em um snippet de código JavaScript fetch() com cabeçalhos, corpo e método - [Conversor de cURL para PHP (cURL)](https://elysiatools.com/pt/tools/curl-to-php): Converte um comando cURL em um snippet de código PHP cURL com curl_setopt, cabeçalhos e campos POST ## Exemplos - [Exemplos OpenAPI/Swagger](https://elysiatools.com/pt/samples/openapi): Exemplos de especificação OpenAPI/Swagger para documentação de API REST e definição de contratos - [Exemplos OpenAPI/Swagger](https://elysiatools.com/pt/samples/openapi-swagger): Exemplos abrangentes de documentação API usando OpenAPI 3.0 e especificações Swagger para serviços RESTful - [Exemplos de Processamento de Imagem Android Java](https://elysiatools.com/pt/samples/android-image-processing-java): Exemplos de processamento de imagem Android Java incluindo leitura/escrita, dimensionamento e conversão de formato - [Exemplos de Processamento de Imagem Android Kotlin](https://elysiatools.com/pt/samples/android-image-processing-kotlin): Exemplos de processamento de imagem Android Kotlin incluindo leitura/escrita, dimensionamento e conversão de formato ## Conteúdo relacionado - [Ferramentas OpenAPI para documentação, geração de código e revisão de contrato](https://elysiatools.com/pt/hubs/openapi-utility): Compare geração de código OpenAPI, documentação de API, diff de schemas, validação de respostas e testes de contrato em um único hub para design e manutenção de APIs. - [Ferramentas de teste de contrato de API, mocking e revisão de schemas](https://elysiatools.com/pt/hubs/api-contract-testing): Gere tipos e documentação a partir de OpenAPI, crie mocks, valide respostas reais e revise mudanças críticas de schema em um único hub. - [Ferramentas de versionamento de API, breaking changes e revisao de release](https://elysiatools.com/pt/hubs/api-versioning-breaking-change-review): Compare versoes de API, detecte mudancas quebradoras no schema, valide compatibilidade real de respostas e revise semver e changelog em um hub focado de pre-release. - [Ferramentas de Diff e Comparação de Arquivos e Dados](https://elysiatools.com/pt/hubs/file-data-diff-comparison-tools): Compare dois arquivos, payloads, esquemas ou conjuntos de dados lado a lado e destaque o que mudou — em texto, JSON, CSV/Excel, PDF, imagens, áudio, bancos de dados, APIs e configurações.