Digitale Delta API

De Digitale Delta API is een set van afspraken waarmee verschillende informatiesystemen op een gestandaardiseerde en veilige manier waterdata met elkaar delen.

Het doel van de Digitale Delta API (DD API) is om een bijdrage te leveren aan de goede kwaliteit van waterbeheer. Door gegevens efficiënt met elkaar te delen, kan waterbeheer slimmer en doeltreffender worden uitgevoerd, zelfs over de grenzen van verschillende beheergebieden heen. De gegevensuitwisseling kan plaatsvinden tussen alle partijen die een rol spelen in de waterketen, van laboratoria, sensor-data-partijen, waterleidingsbedrijven en waterzuiveringsinstellingen tot onderzoekers én het Informatiehuis Water.

Organisaties die de Digitale Delta API op hun applicatie of database hebben geïmplementeerd, kunnen hun data op een uniforme en eenvoudige manier laten doorzoeken. Gebruikers krijgen de beschikking over betrouwbare meetgegevens omdat die voldoen aan de standaarden die van belang zijn voor de watersector.

Digitale Delta API 3.0

In versie 3.0 van de Digitale Delta API-specificatie zijn verschillende varianten van de DD API geïntegreerd tot één sterke API voor de watersector.

De DD API-specificatie 3.0 is breed toepasbaar. De uitwisseling van verschillende soorten meetdata (zoals tijdreeksen, rasterdata en verwachtingen) wordt ondersteund voor meerdere toepassingsgebieden (waterkwaliteit, waterkwantiteit, ecologie en waterzuivering). De zoek- en filtermechanismen zijn voor al deze toepassingen hetzelfde.

De Digitale Delta API 3.0 omvat een open en niet merk-, omgevings- of systeemgebonden specificatie die door iedereen vrij gebruikt kan worden zonder licentie. Er is ook een open source implementatie beschikbaar die als uitgangspunt kan worden gebruikt door aanbieders.

De Digitale Delta API V3 is winnaar van de Gouden API 2026.

Daarmee is de DD API uitgeroepen tot de beste implementatie van een API in de publieke sector van dit jaar.

Aan welke standaarden voldoet de DD API 3.0?

De DD API-specificatie is gebaseerd op OM&S (de 19156:2023 standaard voor Observations, Measurements and Samples) en voldoet aan diverse (inter)nationale standaarden die van belang zijn voor gegevensuitwisseling binnen en door de watersector, zoals OData, CoverageJSON, OAuth2.0 en de standaard voor API's van het Forum Standaardisatie.

Voor de betekenis van de datavelden wordt gebruik gemaakt van de termen en definities uit:

• de Aquo-standaard voor waterdata
• de TWN-lijst (Taxa Waterbeheer Nederland)
• de door het KNMI gevolgde richtlijnen van de Wereld Meteorologische Organisatie (WMO)

DigitaleDelta beheer

Informatiehuis Water

• zorgt voor een actuele en goed beschreven specificatie (o.a. documentatie) en up-to-date GitHub repository;
• beheert het ontwikkelproces en de roadmap;
• is verantwoordelijk voor de kwaliteit van de DD API-afspraken en -tooling;
• organiseert de besluitvorming over en financiering van aanpassing of uitbreiding van DD API-specificaties en -tooling;
• bewaakt en registreert (aan)meldingen op de GitHub;
• onderhoudt contact met gebruikers van de DD API, onder meer met bijeenkomsten.

Architecture Board

De Archictecture Board beheert de DD API door gebruikerswensen uit de DD API Community te beoordelen en de roadmap vast te stellen.

Digitale Delta Community

De DD API Community is een gebruikersgroep waarin gebruikerswensen worden geïnventariseerd, resultaten en ontwikkelingen worden toegelicht en kennis en ervaring worden gedeeld. Dataleveranciers, data-afnemers, marktpartijen, kortom, iedereen die wil meedenken over en bijdragen of meewerken aan de verdere doorontwikkeling van de Digitale Delta API kan deelnemen aan de DD API Community.

Wil jij meedenken over of bijdragen aan de doorontwikkeling van de Digitale Delta API?
Meld je dan aan voor de bijeenkomsten van de DD API Community! Je vindt de data in onze online Agenda | Informatiehuis Water (ihw.nl).

Technische beschrijvingen

De Digitale Delta formaten (DD API V2, DD-ECO-API en DD API V3) zijn technische beschrijvingen.

Voor meer informatie hierover, kunt u de volgende pagina's raadplegen:

API	Omschrijving
DD API V2	Tijdsreeksen (chemisch, fysisch)
DD-ECO-API	Observaties (ecologisch, chemisch, fysisch)
DD API V3	OData en OM&S gebaseerd: Observaties, tijdseries, roosters, verwachtingen en ensembles (ecologisch, chemisch, fysisch)

De DD API is volop in ontwikkeling: DD API V4 in de steigers.

Begin van Q4 2026 wordt deze in consultatie gebracht en gepubliseerd op GitHub.

Wijzigingen zullen in grote lijnen zijn:

• Meer in lijn brengen met de onderliggende standaarden
• Introductie van een taalschakelaar om bepaalde elementen van het formaat tussen Engels en Nederlands te kunnen laten schakelen
• Verbetering van het ingebouwde referentiesysteem, met specifieke endpoints voor geografie met ondersteuning voor JSON-FG
• Schakelbare semantiek
• Verbeterde ondersteuning voor tijdreeksen, verwachtingen en ensembles

V3 en V4 zullen tezamen actief onderhouden worden.

Open source projecten

Project	Beschrijving
DD-API V3 Open source voorbeeldimplementatie	Voorbeeldimplementatie in C# voor Postgres. Bevat o.a. een voorbeeld van het omzetten van een OData zoekopdracht naar een opslagmodel.
DD-API V3 $metadata validator	Valideert een opgegeven DD-API V3 endpoint.
DD-API V3 validatiebestand	(meest recente) bronbestand voor validatie t.b.v. de metadata validator
DD API V3 UI	Dit is een website waarmee eenvoudig DD API V3 zoekopdrachten te maken zijn. Dit is werk in uitvoering.
DD API V3 Tookit	De ToolKit is een cross-platform .NET-project voor een `DD API V3` implementatie. De versie van .NET is 10, een zogenaamde LTS-versie (Long Term Support). De bedoeling is dat zo min mogelijk code moet worden geschreven om een werkende DD API V3 implementatie te maken. Alles wordt via configuratie geregeld. Het kan probleemloos als container draaien.

Aanbieders

Implementatie	Status	Beschrijving	Toegang
AquaDesk (geen tijdsreeksen)	Gereed	Ontsluiting van ecologisch/fysisch/chemische data van verschillende waterbeheerders	https://ddapi.aquadesk.nl
SOVON	Gereed	Ontsluiting van RWS vogeldata	https://ddapi-rws.ecosys.nl
Wageningen Marine Research	Gereed	Ontsluiting van RWS vis-data	https://ddapi-rws.ecosys.nl
AquaDesk (RWS)	Gereed	Ontsluiting van RWS vogeldata	https://ddapi-rws.ecosys.nl
AQUON	Gereed	Ontsluiting van sensor data van verschillende waterschappen	https://api.aquon.nl
AQUON (SampleManager)	Proof of Concept	Ontsluiting van sensor data van verschillende waterschappen	Onbekend
WADAR (RWS)	Interne Proof of Concept	Ontsluiting van chemische data van RWS	Onbekend
Blik-Sensing	Proof of concept	Ontsluiting kwantiteitsdata bodemsensoren	Onbekend
Muni-Sense	Proof of concept	Ontsluiting kwantiteitsdata bodemsensorsen	Onbekend
CimPro	Proof of concept	Ontsluiting kwantiteitsdata oppervlaktewatersensoren	Onbekend