-
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
-
Wie man eine API abkündigt, ohne Entwickler zu verlieren
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
-
Breaking Changes: was zählt und wie man sie ausliefert
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-Änderungen9 Min. Lesezeit
