Gör versioneringen systematiskt
Versionering av programmeringsgränssnitt är ett sätt att hantera och uppdatera funktioner. Med hjälp av versionering kan ändringar göras i programmeringsgränssnittet utan att de skadar de applikationer som använder programmeringsgränssnittet.
Versioneringen gör det möjligt för olika användare att använda olika versioner utan att ständigt behöva uppdatera koden i takt med att nya ändringar görs.
Med hjälp av versioneringen kan man
- erbjuda nya egenskaper
- se till kompatibiliteten bakåt
- ge utvecklarna tid att gå från gamla versioner till nyare.
När datamodellen görs omsorgsfullt minskar behovet av versionering.
Kom ihåg att
- välja en enhetlig versioneringspraxis för hela organisationen
- kommunicera den tydligt
- fastställa livscykelns längd för varje version samt processen för skapandet av en ny version.
I samband med versioneringen är det viktigt att hitta ett lämpligt och balanserat tillvägagångssätt:
- Nya versioner bör inte publiceras för ofta, men
- ibland är nödvändigt att förnya strukturen och publicera en ny version.
Om kundperspektivet inte beaktas i versioneringen kan det orsaka extra arbete för programmeringsgränssnittets användare. När till exempel Google publicerade tre versioner av sitt Maps API-programmeringsgränssnitt (serverroll) som fokuserar på kartor, var användarna tvungna att skriva in hela den programkod (kundrollens) som utnyttjar programmeringsgränssnittet på nytt.
