imbahub
Meny +
SV
Prata med oss
IMBAHUB / Kunskap & guider

Pröva fältändringen mot mottagaren som fortfarande använder det gamla kontraktet.

En fungerande ny API-respons kan bryta en äldre kanal. Kontrollera därför ändringens betydelse, validering och faktisk presentation för varje berörd konsument. Använd fiktiva exempel och sparade kontraktsversioner i testmiljö.

Tre kontroller av samma ändring
  1. Form

    Typer och nödvändiga fält följer kontraktet.

  2. Betydelse

    Enhet, språk och innebörd är fortfarande korrekta.

  3. Konsument

    Gammal och ny mottagare ger avtalat utfall.

Samma datatyp kan bära en brytande förändring i betydelse.

Talet 60 är giltigt, men fältet har bytt från minuter till timmar. Räcker schemat?

Nej. Betydelseändringen måste hanteras och provas i konsumenterna, även när typen är oförändrad.

Spara kontrakt och konsumentversion före ändringen

Lista vilka mottagare som använder fältet och vilken version de kör. Dokumentera nuvarande namn, typ, obligatoriska villkor och betydelse. En ändrad etikett i CMS är inte nödvändigtvis samma sak som ett ändrat API-fält.

I ett fiktivt kursexempel kan duration vara numeriskt antal minuter. Att byta till texten halvdag ändrar både typ och betydelse. En mottagare som sorterar numeriskt behöver en plan, även om den nya texten ser korrekt ut i en ny vy.

Prova både form och innebörd

Välj fall för oförändrat värde, saknat fält, tom text, null och ny egenskap. Lägg till fel typ och ett meningsmässigt ändrat värde med samma typ. Ange förväntat utfall innan svaren läses av mottagaren.

Schema kan hjälpa med typer och obligatoriska fält men måste ha rätt regler och validatorinställningar. Det avgör inte om ett tal betyder minuter eller timmar. Bedöm också språk, referenser och hur värdet presenteras.

ÄndringRisk att provaFörväntan ska ange
Fält borttagetGammal mottagare kräver detAvslag, reservtext eller separat version
Null i stället för saknatOlika kodvägar för tomt värdeAvtalad betydelse och presentation
Ny valfri egenskapStrikt avvisning av okända fältFaktiskt stöd hos gammal konsument
TypbyteBeräkning eller rendering brytsAvtalad övergång, inte tyst omvandling
Samma typ, ny betydelseTeknisk validering passerarVerksamhetsinnebörden bevaras eller versionsdelas

Kör gammal och ny mottagare mot provsvaren

En lyckad schemakontroll ska följas av den verkliga konsumentvägen: hämtning, läsning och relevant presentation eller beräkning. Prova lång text, främmande språk och saknad referens där de ingår i modellen.

Dokumentera vilken kombination av kontrakt och konsument som fungerar. Bakåtkompatibilitet är inget allmänt löfte för alla framtida mottagare. Om övergången bryter en befintlig konsument behövs ett beslutat byte eller parallellt stöd under avtalad tid.

Gör byte och återgång möjliga att följa

Bestäm vem som uppdaterar varje mottagare och vilket bevis som krävs före ändrad leverans. Spara tidigare kontrakt, representativa fiktiva svar och en avtalad återgångsväg. Blanda inte privata riktiga data i regressionsproven.

Efter byte provas samma matris igen mot den version som faktiskt levereras. Rapportera kvarvarande äldre konsumenter, utfasningsbeslut och ägare. Ett versionsnummer ensamt förhindrar inte att fel respons skickas till en gammal kanal.

Källor och fördjupning

Bra att veta

Kan vi kalla varje tillägg bakåtkompatibelt?

Nej. Det beror på hur befintliga mottagare hanterar okända egenskaper och om betydelsen förändras.

Bevisar giltig JSON att ändringen fungerar?

Nej. Syntax, schema och faktisk konsumentfunktion är olika kontroller.

IMBAHUB

Vad vill du göra möjligt?

Välj en fältändring och prova den mot både en oförändrad äldre mottagare och den nya versionen.

Prata med oss
Autentiskt produktgränssnitt på svenska. Separat presentationsmiljö med fiktiva demodata.

Autentiskt produktgränssnitt på svenska. Separat presentationsmiljö med fiktiva demodata.