Antwoord.

Versiebeheer van API (Application Programming Interface) helpt bij het ontwikkelen van interfaces en zorgt voor achterwaartse compatibiliteit bij wijzigingen, zodat externe en interne klanten niet kapot gaan bij elke update.

Belangrijkste versieschema's:

• URL-versiebeheer: /api/v1/resource.
• Versiebeheer via headers: Accept: application/vnd.company.v1+json.
• Versiebeheer via queryparameters: /api/resource?version=2.

Meestal wordt de aanpak met de versie in de URL gebruikt, omdat deze duidelijk en transparant is voor alle klanten.

Voorbeeld op Node.js (Express):

// Versie 1
app.get('/api/v1/orders', ordersV1Handler);
// Versie 2
app.get('/api/v2/orders', ordersV2Handler);

Belangrijke kenmerken:

• Stelt de ontwikkeling van het product mogelijk zonder risico voor gebruikers van oude klanten.
• Zorgt voor een soepele overgang tussen generaties API.
• Is verplicht voor grote bedrijfs- en publieke systemen.

Vragen met een haakje.

Is het voldoende om altijd alleen de laatste versie van de API te ondersteunen?

Nee, gebruikers van oude applicaties hebben mogelijk niet de mogelijkheid om snel over te stappen op de nieuwe interface, daarom worden vaak meerdere actuele versies ondersteund.

Kunnen er incompatibele wijzigingen worden toegevoegd in de minorversie van de API?

Nee, minorversies moeten strikt compatibel zijn met eerdere versies. Breaking changes vereisen een wijziging van de majorversie.

Beïnvloedt de manier van versiebeheer (URL, headers, parameters) de veiligheid of prestaties van de API?

Nee, de opslagplaats van de versie heeft op zichzelf geen invloed op de technische specificaties, maar URL-versiebeheer is eenvoudiger te analyseren met monitoring- en ondersteuningstools.