Versiebeheer en backwards compatibility van de API

Hoe Leafy Energy met API-versies omgaat (demo)

In de demo gebruiken we API-versies om te laten zien hoe je veranderingen kunt doorvoeren zonder bestaande integraties direct stuk te maken.

Versie in het pad

• De versie staat in de URL, bijvoorbeeld /v1/ of /v2/.
• Breaking changes worden alleen in een nieuwe major-versie geïntroduceerd.

Voorbeeld

GET /v1/pricing/day-ahead
GET /v2/pricing/day-ahead

In v2 kan bijvoorbeeld een extra veld zijn toegevoegd voor CO2-intensiteit per uur.

Migratiestrategie

• Gebruik feature-toggles aan clientzijde om stap voor stap over te gaan.
• Monitor foutcodes en responstijden per versie.

In de demo kun je laten zien hoe een dashboard twee versies naast elkaar aanroept en de verschillen markeert.