Verbonden infrastructuur

Plan een compatibele interfacewijziging

Redactionele editie · 16 november 2026

Het idee

Een interfacewijziging is alleen compatibel ten opzichte van de clients die haar gebruiken. Een extra veld kan een strikte parser laten falen en een extra enumwaarde kan een uitputtende keuzestructuur breken. Compatibiliteit vraagt daarom om bewijs over werkelijk clientgedrag.

Ontwerpkeuze

Maak onderscheid tussen toevoegingen en wijzigingen in betekenis, standaardwaarden of validatie. Test representatieve oude clients met het voorgestelde antwoord. Geef een noodzakelijke nieuwe versie een overgangsperiode en meet welke afnemers de oude versie nog gebruiken.

Uitgewerkt voorbeeld

Een rapportage-endpoint krijgt een optioneel toelichtingsveld. Een contracttest toont dat een importprogramma onbekende sleutels afwijst. Het team past die importeur aan voordat het veld voor alle clients wordt ingeschakeld.

Voor ingebruikname

  • Test een oudere client.
  • Controleer betekeniswijzigingen en de vorm van velden.
  • Wijs een eigenaar aan voor het beëindigen van de oude versie.

De voorbeelden zijn illustratief. Pas de controles aan uw eigen omgeving aan.

Bronnen en verdieping

HTTP Semantics, RFC 9110

Zoek in de bibliotheek