API-wijzigingen

Breaking changes, deprecaties en versiebeheer, uitgelegd aan wie het raakt.

Stripe API-versionering: hoe het werkt en wat je kopieert

Stripe API-versionering pint elk account op een gedateerde versie en laat elk verzoek die overschrijven. Hoe het werkt en wat een kleine API kan overnemen.

API-wijzigingen2 okt 20267 min lezen
Protobuf breaking changes: wat overleeft op de wire

Protobuf breaking changes gebeuren op de wire, niet in de URL. Sommige gRPC-veldwijzigingen zijn gratis, andere breken elke client stilletjes.

API-wijzigingen22 sep 20266 min lezen
GraphQL-deprecatie zonder versienummer

GraphQL heeft geen v1 of v2 in de URL. Velden worden per stuk gedeprecieerd via een directive op een gedeeld schema. Wat een changelog schuldig is.

API-wijzigingen17 sep 20265 min lezen
Hoe je een API-migratiegids schrijft

Een API-migratiegids maakt van een breaking change een checklist in plaats van een storing. Wat hij nodig heeft, en waarom een regel niet genoeg is.

API-wijzigingen7 sep 20265 min lezen
Interne API-changelogs: wat verandert er

Een publieke API-changelog heeft een publiek dat je niet direct bereikt. Een interne heeft lezers twee verdiepingen verderop, en dat verandert de inhoud.

API-wijzigingen7 sep 20265 min lezen
De API sunset header, en wanneer je er een moet sturen

De API sunset header vertelt een client wanneer een versie stopt met antwoorden, anders dan een deprecatiebericht. Wat RFC 8594 dekt en wat brownouts doen.

API-wijzigingen7 sep 20265 min lezen
Webhook-changelogs: de breaking change die niemand vroeg

Een webhook-payloadwijziging breekt stilletjes, omdat niemand haar kan afwijzen. Wat een payloadwijziging breaking maakt, en hoe je hem versieert.

API-wijzigingen7 sep 20265 min lezen
API-changelog: wat je publiceert, en wie het leest

Een API-changelog wordt gelezen door mensen die beslissen of hun code volgende maand nog werkt. Wat elk item hun schuldig is, waar het staat en abonneren.

API-wijzigingen2 sep 20266 min lezen
Hoe deprecieer je een API zonder developers te verliezen

Deprecatie is een belofte met een datum erop. Het tijdschema, de berichtsjabloon, de response-headers, en de stap die een sunset behoedt voor een incident.

API-wijzigingen29 aug 20266 min lezen
Beste practices voor API-versionering, voor aanroepers

Versioneer alleen wat breekt, zet de versie zichtbaar, en houd de oude versie actief tot een datum. Vier schema's vergeleken op wat ze van je vragen.

API-wijzigingen29 aug 20267 min lezen
Breaking changes: wat telt en hoe je er een uitbrengt

Een breaking change is elke wijziging die een correcte aanroeper niet overleeft. Wat telt, wat niet, hoe je er in CI een vangt en hoe je er een uitbrengt.

API-wijzigingen29 aug 20269 min lezen