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.