APIändringar
APIändringar avser förändringar i ett offentligt eller internt API som kan påverka hur klienter interagerar med tjänsten. Det kan röra nya eller ändrade endpoints, ändrade parameternamn eller typer, förändringar i svarens struktur eller format, nya eller förändrade autentiserings- och behörighetskrav samt ändringar i felhantering och dokumentation.
Delar mellan brytande och icke-brytande förändringar: Brytande förändringar riskerar att göra befintliga klienter inkompatibla och kräver
Process och påverkan: leverantörer bör publicera changelogs, uppdatera deprecationspolicy, och tillhandahålla migrationsguider samt testmiljöer eller sandlådor.
- För API-leverantörer: publicera tydliga release notes och deprecationsdatum, erbjud migrationsvägar, behåll äldre kontrakt under överenskommen tid,
- För klienter: följ release notes, använd versionskontroll och abstraktionslager, planera migrering i små steg, utnyttja feature