Lagre kontrakt og konsumentversjon først
List mottakere som bruker feltet og versjonen de kjører. Noter navn, type, påkrevde vilkår og betydning. En endret CMS-etikett er ikke nødvendigvis et endret API-felt.
I et tenkt kurseksempel kan duration være antall minutter som tall. Bytte til teksten halvdag endrer både type og betydning. En mottaker som sorterer numerisk trenger en plan selv om teksten ser riktig ut i ny visning.
Prøv form og betydning hver for seg
Velg tilfeller med uendret verdi, manglende felt, tom tekst, null og ny egenskap. Legg til feil type og en betydningsendring med samme type. Definer forventningen før mottakeren leser prøvesvarene.
Skjema kan støtte typekontroll og påkrevde felt, men trenger riktige regler og validatorinnstillinger. Det avgjør ikke om et tall betyr minutter eller timer. Undersøk språk, referanser og presentasjon også.
| Endring | Risiko å prøve | Forventning må angi |
|---|---|---|
| Felt fjernet | Gammel mottaker krever det | Avslag, reserve eller egen versjon |
| Null fremfor manglende | Ulike kodeveier for tom verdi | Avtalt betydning og presentasjon |
| Ny valgfri egenskap | Streng avvisning av ukjente felt | Faktisk støtte i gammel konsument |
| Typebytte | Beregning eller visning brytes | Avtalt overgang fremfor stille konvertering |
| Samme type, ny betydning | Teknisk validering består | Betydning beholdes eller kontrakten deles |
Kjør gamle og nye mottakere mot prøvesvar
Følg skjemakontroll med faktisk konsumentvei: henting, lesing og relevant visning eller beregning. Ta med lang tekst, annet språk og manglende referanse der modellen krever det.
Noter kombinasjoner av kontrakt og konsument som fungerer. Bakoverkompatibilitet er ikke et løfte for alle fremtidige mottakere. En brytende overgang trenger avtalt bytte eller parallell støtte i en definert periode.
Gjør bytte og tilbakeføring sporbare
Avklar hvem som oppdaterer hver mottaker og hvilket bevis som kreves før leveransen endres. Behold tidligere kontrakt, representative fiktive svar og avtalt vei tilbake. Ikke bruk private virkelige poster i regresjonsprøver.
Etter bytte gjentas matrisen mot faktisk levert versjon. Noter gjenværende gamle konsumenter, utfasingsbeslutning og ansvarlige. Et versjonsnummer hindrer ikke alene at feil svar når en gammel kanal.