Fast releaseskema for API ændringer

Vi har identificeret et behov for øget styring af vores releases af ændringer i API’et. Derfor indfører vi fra nytår et nyt release skema for API ændringer, som ikke kun vil gøre det nemmere for skoler og leverandører at overskue hvad og hvornår der releases ændringer til API’et, men det vil også give op til tre måneders reaktionstid på implementering af nødvendige ændringer.

Der er oprettet tre release spor med følgende definitioner:

Beta: Nye rettelser som endnu ikke er gennemtestet. Man skal forvente at der kan forekomme fejl.

X: Produktionsklare rettelser. Sporet opdateres med nyeste kode hver 2. måned forskudt af Y.

Y: Produktionsklare rettelser. Sporet opdateres med nyeste kode hver 2. måned forskudt af X.

Releases vil foregå hver måned til Beta, hvor man kan få mulighed for at komme til nye ændringer hurtigt, men hvor man skal forvente at der kan forekomme fejl, da test ikke er afsluttet endeligt på rettelser på dette spor.

Releases til produktionssporene X og Y vil foregå i rul, så de ændringer der har ligget til test på Beta sporet i f.eks. december/januar vil blive releaset til X, og rettelserne fra Beta sporet i januar/februar vil blive releaset i Y. Dermed vil X hhv. Y være stabile i to måneder inden det respektive spor opdateres igen. Beta vil altid indeholde den samlede nyeste version af API’et. Fuldt release skema for første halvår 2022 kan ses nedenfor.

Når der releases vil der blive lagt en samlet liste over ændringerne ud på API info nyhedskanalen (https://info.uddataplus.dk/category/api/), som der kan abonneres RSS-feed på her: https://info.uddataplus.dk/tilmeld-nyhedsbrev-og-rss-feed/

For at finde de forskellige spor bruges følgende url:

https://api.ist.com/uddataplus/institutions/{instnr}/{beta,release_x,release_y}/…

Eksempel på url til at kalde elever endpointet for hvert af de tre spor:

https://api.ist.com/uddataplus/institutions/{instnr}/beta/elever

https://api.ist.com/uddataplus/institutions/{instnr}/release_x/elever

https://api.ist.com/uddataplus/institutions/{instnr}/release_y/elever

API releaseskema 1. halvår 2022