Stabiel ontwikkelen bovenop een evoluerend platform
Ook in een demo is het nuttig om te laten zien hoe je omgaat met API-versiebeheer. Leafy Energy introduceert daarom een eenvoudig, maar herkenbaar versieconcept.
API-versies
- Versies in de URL, bijvoorbeeld
/v1/...en/v2/.... - SDK's die standaard naar de nieuwste stabiele versie wijzen.
- Optie om expliciet een versie te kiezen per clientinstantie.
Breaking changes (concept)
- Grote wijzigingen worden aangekondigd met een "deprecation window".
- Sandbox krijgt breaking changes eerder, zodat teams kunnen testen.
- De SDK's loggen waarschuwingen als je deprecated endpoints gebruikt.
Dit artikel helpt om in gesprekken met architecten te laten zien dat een Leafy Energy-achtig platform serieus met lifecycle en stabiliteit omgaat, ook al is het demo.
Opmerkingen
0 opmerkingen
U moet u aanmelden om een opmerking te plaatsen.