Compare specs
Uma página dedicada (linkada na sidebar como "Compare specs") que busca dois documentos OpenAPI por URL e reporta o que mudou entre eles: endpoints adicionados, removidos e alterados, cada um marcado como breaking ou informativo.
Uso
Clique em Compare specs na sidebar, cole uma URL pro spec base (antigo) e outra pro spec novo (o campo novo já vem preenchido com o spec carregado no momento), depois clique em Compare. Os dois documentos passam pelo mesmo pipeline normalizeDocument() que a UI principal usa, então não existe um parser separado em que confiar.
O que conta como breaking
| Change | Severity |
|---|---|
| Endpoint removido | Breaking |
| Novo parâmetro obrigatório | Breaking |
| Parâmetro opcional virou obrigatório | Breaking |
| Request body virou obrigatório | Breaking |
| Uma resposta 2xx foi removida | Breaking |
| Endpoint adicionado | Informativo |
| Parâmetro removido | Informativo |
| Uma resposta não-2xx foi removida | Informativo |
| Novo status de resposta documentado | Informativo |
Escopo
Isso é deliberadamente raso: compara presença de endpoint, presença/obrigatoriedade de parâmetro, obrigatoriedade do request body, e status codes de resposta. Não faz diff de schema campo a campo (ex: uma propriedade mudar silenciosamente de string pra number ainda não é detectado).