...
Da bei einer Änderung der URL sämtliche Clients angepasst werden müssen, ist solch ein update Update immer ein Major update Update im Sinne des semantic versioning. Daher wird auch nur die Major Version in die URL aufgenommen. Sie hat dann das Format:
...
Die URL für die Major Version 2.x.x der API lautet dann z.B. : https://www.landeskrebsregister.nrw/rd/v2/
...
Beispiele für Major Updates, die eine Versionsänderung in der URL zur Folge haben:
Nicht mehr unterstützte Ressourcen oder Methoden
Umbenennung einer Ressource oder ihrer bestehenden Attribute
Beispiele für Minor oder Patch updates Updates ohne Versionsänderung in der URL sind dagegen:
Zusätzliche optionale Felder in einer Ressource
Neue zusätzliche Ressourcen
Bei Minor oder Patch - Updates wird lediglich die API Dokumentation erweitert, aber keine URL Änderung vorgenommen.