Ein Breaking Change in einer öffentlichen API entsteht meist nicht absichtlich, sondern schleicht sich in einem unauffälligen Pull Request ein, der eigentlich nur einen internen Bugfix beheben sollte. Diagnose-Tools wie oasdiff und
openapi-diff vergleichen zwei Versionen einer OpenAPI-Spezifikation automatisiert und erkennen genau solche Vertragsbrüche zuverlässig, bevor sie gemergt werden. Dieser Artikel zeigt den Unterschied zu reinem Spectral-Linting, wie ein CI-Gate konkret aufgebaut wird und wie bewusst gewollte Breaking Changes über einen Whitelist-Mechanismus dokumentiert freigegeben werden.