imbahub
Meny +
NO
Snakk med oss
IMBAHUB / Kunnskap og guider

Prøv feltendringen mot mottakeren som fortsatt bruker gammel kontrakt.

Et fungerende nytt API-svar kan ødelegge en eldre kanal. Kontroller betydning, validering og faktisk presentasjon for hver berørt konsument. Bruk fiktive eksempler og lagrede kontraktsversjoner i testmiljø.

Tre kontroller av samme endring
  1. Form

    Typer og påkrevde felt følger kontrakten.

  2. Betydning

    Enhet, språk og innholdstolkning er fortsatt riktige.

  3. Konsument

    Gamle og nye mottakere gir avtalte utfall.

Samme datatype kan bære en brytende betydningsendring.

Tallet 60 er gyldig, men feltet har byttet fra minutter til timer. Holder skjemaet?

Nei. Betydningsendringen må håndteres og prøves i konsumentene selv om typen er uendret.

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å.

EndringRisiko å prøveForventning må angi
Felt fjernetGammel mottaker krever detAvslag, reserve eller egen versjon
Null fremfor manglendeUlike kodeveier for tom verdiAvtalt betydning og presentasjon
Ny valgfri egenskapStreng avvisning av ukjente feltFaktisk støtte i gammel konsument
TypebytteBeregning eller visning brytesAvtalt overgang fremfor stille konvertering
Samme type, ny betydningTeknisk validering bestårBetydning 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.

Kilder og fordypning

Spørsmål og svar

Er alle tillegg bakoverkompatible?

Nei. Det avhenger av mottakernes håndtering av ukjente felt og endret betydning.

Beviser gyldig JSON at endringen fungerer?

Nei. Syntaks, skjema og faktisk konsumentoppførsel er ulike kontroller.

IMBAHUB

Hva vil du få til?

Velg en feltendring og prøv den mot både uendret eldre mottaker og ny versjon.

Snakk med oss
Produktgrensesnittet er satt til norsk i et isolert miljø med fiktivt norsk demoinnhold.

Produktgrensesnittet er satt til norsk i et isolert miljø med fiktivt norsk demoinnhold.