Document toolboxDocument toolbox

Interfaces lijsten

Owned by Martin Wilmink
Last updated: Mar 01, 2024 by Ibrahim Benyahya
2 min read


1De Aanbiederslijst voldoet aan wat over haar is bepaald in de Informatiemodellen.

core.lijsten.100

2.
De URI van de:
  • 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

Versies worden van elkaar onderscheiden door een query-parameter in de URI.

 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 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

core.lijsten.300

3.De URI van het Aanbiedersregister is https://register.medmij.nl. Deze bevat informatie betreffende de actuele versies van het afsprakenstelsel en wordt niet per versie uitgegeven.

core.lijsten.304

4.Het aandeel van MedMij Registratie in elk van de implementaties van de functies Opvragen Aanbiederslijst, Opvragen OAuth Client List, Opvragen Gegevensdienstnamenlijst en Opvragen Whitelist is voor minstens 99,9% van de tijd beschikbaar. MedMij Beheer laat, na het niet beschikbaar raken van bedoelde aandeel, maximaal acht uren (480 minuten) verstrijken voordat het weer beschikbaar is.

core.lijsten.301

5.MedMij Beheer brengt, in geval van zo'n incident, Deelnemers op de hoogte van het optreden van het incident en van de verwachte down-time. MedMij Beheer brengt Deelnemers op de hoogte van gepland onderhoud dat leidt tot tijdelijke onbeschikbaarheid.

core.lijsten.302

6.

Ingeval MedMij Registratie in de functies Opvragen Aanbiederslijst, Opvragen OAuth Client List, Opvragen Gegevensdienstnamenlijst en/of Opvragen Whitelist onbeschikbaar is, mogen betreffende opvragers gedurende maximaal 10 uur gebruik maken van het meest recente exemplaar van de betreffende lijst in de cache.

 Toelichting
De Whitelist is niet bedoeld voor het blokkeren van gecompromitteerde nodes. In die gevallen moet het betreffende certificaat worden ingetrokken, de systemen opgeschoond en een nieuw certificaat worden geïnstalleerd. Daarom is, in geval van de in deze verantwoordelijkheid bedoelde down-time, het gaan achterlopen van de inhoud van de Whitelist, geen beveiligingsrisico.

core.lijsten.303