API-Änderungen
Breaking Changes, Deprecations und Versionierung, erklärt für die Betroffenen.
Zum Einstieg: Was ist ein Breaking Change? Beispiele und Auslieferung, API abkündigen: Zeitplan, Hinweis und RFC-9745-Header, API-Versionierung: Best Practices im Sinne der Aufrufer
-
REST-API-Versionierung: URL, Header oder Query, was passt
REST-API-Versionierung legt die Version in Pfad, Header oder Query-String. Was das für Aufrufer, Caches und Ankündigungen bedeutet, mit Beispielen.
API-Änderungen6 Min. Lesezeit
-
Stripe-API-Versionierung: Funktionsweise und Lehren
Die Stripe-API-Versionierung bindet jedes Konto an eine datierte Version, jede Anfrage kann sie überschreiben. Was eine kleine API davon übernehmen kann.
API-Änderungen7 Min. Lesezeit
-
Protobuf-Breaking-Changes: was auf dem Wire überlebt
Protobuf-Breaking-Changes passieren auf dem Wire, nicht in der URL. Manche gRPC-Feldänderungen sind kostenlos, andere brechen jeden Client lautlos.
API-Änderungen6 Min. Lesezeit
-
GraphQL-Abkündigung ohne Versionsnummer
GraphQL hat kein v1 oder v2 in der URL. Felder werden einzeln per Direktive abgekündigt, auf einem geteilten Schema. Was ein Changelog hier schuldet.
API-Änderungen5 Min. Lesezeit
-
Wie man einen API-Migrationsleitfaden schreibt
Ein API-Migrationsleitfaden macht aus einer Breaking Change eine Checkliste statt eines Ausfalls. Was er braucht und warum ein Eintrag allein nicht reicht.
API-Änderungen5 Min. Lesezeit
-
Interne API-Changelogs: Was sich für das andere Team ändert
Ein öffentlicher API-Changelog hat ein Publikum, das man nicht direkt erreicht. Ein interner hat es zwei Stockwerke weiter, und das ändert einiges.
API-Änderungen5 Min. Lesezeit
-
Der API-Sunset-Header, und wann man ihn sendet
Der API-Sunset-Header sagt einem Client, wann eine Version verstummt, anders als eine Deprecation-Ankündigung. Was RFC 8594 regelt, was Brownouts bringen.
API-Änderungen5 Min. Lesezeit
-
Webhook-Changelogs: Der Breaking Change, den niemand wollte
Eine Webhook-Payload-Änderung bricht lautlos, weil kein Aufrufer die neue Form ablehnen kann. Was dabei als Breaking Change zählt, und wie man versioniert.
API-Änderungen5 Min. Lesezeit
-
API-Changelog: was hinein gehört und wer es liest
Ein API-Changelog lesen Leute, die entscheiden, ob ihr Code nächsten Monat noch läuft. Was jeder Eintrag schuldet, wo er lebt und wie man ihn abonniert.
API-Änderungen6 Min. Lesezeit
-
API abkündigen: Zeitplan, Hinweis und RFC-9745-Header
Deprecation ist ein Versprechen mit Datum. Der Zeitplan, die Ankündigungsvorlage, die Response-Header, und der Schritt gegen einen Sunset-Vorfall.
API-Änderungen6 Min. Lesezeit
-
API-Versionierung: Best Practices im Sinne der Aufrufer
Versioniert nur, was bricht. Platziert die Version sichtbar, und haltet die alte Version bis zu einem Datum am Laufen. Vier Schemata im Vergleich.
API-Änderungen7 Min. Lesezeit
-
Was ist ein Breaking Change? Beispiele und Auslieferung
Ein Breaking Change ist jede Änderung, die ein korrekter Aufrufer nicht überlebt. Was zählt, was nicht, wie man ihn in CI erkennt und sicher ausliefert.
API-Änderungen10 Min. Lesezeit