Document toolboxDocument toolbox

MMOS-169, SR-Beschrijving API versie nummering alleen Major benoemen. Tekst correctie 2.y.z hst Interface lijsten.

Omschrijving Changelog

Op de pagina: Interfaces lijsten

Verduidelijking core.lijsten.300 en gebruik major versienummer bij het gebruik van de interfacelijsten api versie identifier.

Te informeren Stakeholders

Acceptatie
Regie
Security
Relatiebeheer
Communicatie
MM Loket
Stichting MM
R&A beheer

Aan te passen versies afsprakenstelsel

2.0.3

Classificatie

Patch
Minor
Major

Implementatie Termijn

Eerstvolgende publicatie slot (nov 2023)

Gerelateerde tickets (indien van toepassing)

https://vzvz.atlassian.net/browse/MMOS-169

 

Status

Staat klaar voor release in afsprakenstelsel
Verwerkt in afsprakenstelsel

Uitwerking

In de kolom “Oude tekst”, maak de verwijderde of gewijzigde stukken rood en streep ze door
In de kolom “Nieuwe tekst”, geef de nieuwe stukken hebben deze blauwige kleur.

Door te voeren wijzigingen

Locatie

Oude tekst

Nieuwe tekst

In te voegen links (optioneel)

Locatie

Oude tekst

Nieuwe tekst

In te voegen links (optioneel)

core.lijsten.300

  • Aanbiederslijst is https://stelselnode.medmij.nl/MedMij_Zorgaanbiederslijst.xml?api=%versie_afsprakenstelsel

  • OAuth Client List is https://stelselnode.medmij.nl/MedMij_OAuthclientlist.xml?api=%versie_afsprakenstelsel

  • Gegevensdienstnamenlijst is https://stelselnode.medmij.nl/MedMij_Gegevensdienstnamenlijst.xml?api=%versie_afsprakenstelsel

  • Whitelist is https://stelselnode.medmij.nl/MedMij_Whitelist.xml?api=%versie_afsprakenstelsel

  • Aanbiederslijst is https://stelselnode.medmij.nl/MedMij_Zorgaanbiederslijst.xml?api=%major_versie_afsprakenstelsel

  • OAuth Client List is https://stelselnode.medmij.nl/MedMij_OAuthclientlist.xml?api=%major_versie_afsprakenstelsel

  • Gegevensdienstnamenlijst is https://stelselnode.medmij.nl/MedMij_Gegevensdienstnamenlijst.xml?api=%major_versie_afsprakenstelsel

  • Whitelist is https://stelselnode.medmij.nl/MedMij_Whitelist.xml?api=%major_versie_afsprakenstelsel

 

core.lijsten.300 => Toelichting

Vanaf release 1.1.2 van het MedMij Afsprakenstelsel hebben de lijst-interfaces een versienummer. Dat maakt het mogelijk om meerdere versies van deze interfaces tegelijkertijd in productie te hebben. De versies worden, vanaf release 1.1.2, van elkaar onderscheiden door een query-parameter in de URI.

Het versienummer is identiek aan dat van de betreffende release. Opeenvolgende versies van de lijst-interfaces kunnen daarom inhoudelijk identiek zijn. 

bijvoorbeeld: https://stelselnode.medmij.nl/MedMij_Whitelist.xml?api=1.1.2

Vanaf release 1.1.2 van het MedMij Afsprakenstelsel hebben de lijst-interfaces een versienummer. Dat maakt het mogelijk om meerdere versies van deze interfaces tegelijkertijd in productie te hebben. De versies worden van elkaar onderscheiden door een query-parameter in de URI.

Met de introductie van versie 2.0.0 wordt in de stelselnode alleen het Major versienummer gebruikt. Het Major versienummer is identiek aan dat van de betreffende release met versienummer Major.Minor.Patch.

bijvoorbeeld: https://stelselnode.medmij.nl/MedMij_Whitelist.xml?api=2

 

 

 

Note: de opmaak van de https:// string kan niet worden ‘opgemaakt’ => aanpassing is api=1.1.2 => api=2

 

 

Als de tabel niet gebruiksvriendelijk is voor de gewenste uitwerking voor het afsprakenstelsel, dan deze gebruiken:

Door te voeren wijzigingen

Locatie

Oude tekst

Nieuwe tekst

In te voegen links