ZorgAPIs¶
Van strategie tot softwareontwikkeling droeg Xtracked bij aan de realisatie van het ZorgAPIs Platform: een landelijk platform dat de samenhang tussen API's, standaarden en gegevensuitwisseling inzichtelijk maakt en zo interoperabiliteit binnen de Nederlandse zorg ondersteunt.
Van versnipperde API's naar één samenhangend platform¶
Goede gegevensuitwisseling begint met goede API's.
Toch worden API's vaak onafhankelijk van elkaar ontwikkeld. Daardoor ontstaan verschillen in documentatie, technische keuzes en implementaties. Dat maakt hergebruik moeilijk, belemmert interoperabiliteit en verhoogt de kosten van nieuwe ontwikkelingen.
De uitdaging was daarom niet alleen om software te ontwikkelen, maar om een platform te realiseren waarmee zorgorganisaties, leveranciers en ontwikkelaars gezamenlijk kunnen werken aan betere API's én meer inzicht krijgen in de samenhang tussen API's, standaarden en gegevensuitwisselingen.
Het resultaat werd het ZorgAPIs Platform: een centrale voorziening waarin API-specificaties, organisaties, standaarden, documentatie en toetsresultaten samenkomen en gezamenlijk bijdragen aan betere gegevensuitwisseling.
Het vraagstuk¶
Goede API's zijn essentieel voor moderne gegevensuitwisseling.
Maar zonder gezamenlijke afspraken over documentatie, versiebeheer, kwaliteit en standaardisatie ontstaan verschillende interpretaties en implementaties. Daardoor wordt samenwerking tussen zorginformatiesystemen complexer dan nodig is.
Binnen de landelijke API-strategie ontstond daarom behoefte aan een platform waarmee leveranciers hun API's kunnen publiceren en toetsen, terwijl zorginstellingen, ontwikkelaars en beleidsmakers inzicht krijgen in de beschikbare oplossingen en hun onderlinge samenhang.
Niet alleen overzicht was daarbij belangrijk.
Juist het zichtbaar maken van de samenhang tussen API's, organisaties, informatiestandaarden, communicatiestandaarden en afsprakenstelsels vormt de basis voor verdere standaardisatie en interoperabiliteit.
De ontwikkeling¶
Binnen dit project werd gewerkt aan zowel de technische realisatie van het ZorgAPIs Platform als de verdere ontwikkeling en implementatie van de landelijke API-strategie.
Vanuit Xtracked werd onder andere bijgedragen aan:
Strategie
- Projectleiding API-strategie
Ontwerp
- Softwarearchitectuur
- API-ontwerp
- UX/UI-ontwerp
Realisatie
- REST API
- API-bibliotheek
- Front-end
- Developer Portal
- Sandbox
Documentatie en adoptie
- OpenAPI-specificaties
- Technische documentatie
- Community- en adoptieondersteuning
Vanaf het begin stond niet alleen de techniek centraal, maar juist ook de adoptie door de markt. Daarom werd gekozen voor een open, community-gedreven aanpak waarbij documentatie, software, ontwikkelaarstools en de ondersteuning van bestaande standaarden vanaf het begin als één geheel werden ontworpen.
Door aan te sluiten bij bestaande ontwikkeltools, internationale standaarden en open documentatie ontstond een platform dat organisaties ondersteunt bij het ontwikkelen, publiceren en toepassen van gestandaardiseerde API's.
Het resultaat¶
Het ZorgAPIs Platform maakt de samenhang tussen API's, organisaties, standaarden en afspraken zichtbaar. Daardoor ontstaat overzicht, dat organisaties helpt om betere keuzes te maken en gezamenlijk verder te bouwen aan gestandaardiseerde gegevensuitwisseling.
Via de centrale API-bibliotheek krijgen organisaties inzicht in beschikbare API's, hun kwaliteit, standaardisatieniveau en samenhang met bestaande standaarden en afspraken. Ontwikkelaars kunnen gebruikmaken van het Developer Portal, OpenAPI-specificaties, een Postman Collection en een Sandbox om API's eenvoudig te publiceren, toetsen en integreren.
Door API's inzichtelijk te maken, te toetsen aan gezamenlijke eisen en te voorzien van consistente documentatie ontstaat een gedeelde basis waarop organisaties verder kunnen bouwen. Daarmee ondersteunt het platform niet alleen de ontwikkeling en adoptie van API's, maar draagt het ook bij aan de verdere standaardisatie van gegevensuitwisseling binnen de Nederlandse zorg.
Belangrijke mijlpalen¶
2022
- Start van de landelijke API-strategie
- Ontwikkeling van API-eisen en groeimodel
2023
- Ontwerp ZorgAPIs Platform
- Realisatie API-bibliotheek
2024
- Introductie Developer Portal
- Lancering Sandbox
- Eerste API-publicaties
2025
- Afronding bijdrage Xtracked
- Overdracht
Wat dit project laat zien¶
Complexe vraagstukken beginnen zelden bij de techniek.
Ze beginnen met het begrijpen van de samenhang tussen standaarden, systemen en organisaties.
Het ZorgAPIs Platform laat zien hoe overzicht leidt tot inzicht, en hoe dat inzicht de basis vormt voor betere samenwerking, verdere standaardisatie en toekomstbestendige gegevensuitwisseling.
Die manier van denken vormt de basis van de werkwijze van Xtracked.
Complexiteit terugbrengen tot eenvoud.
Interesse in een vergelijkbaar project?¶
Ieder project begint met het begrijpen van het vraagstuk.
Bent u benieuwd wat Xtracked voor uw project kan betekenen?
Neem gerust contact op.