Digitale Delta API's

De Digitale Delta API's hebben als doel om meetgegevens te ontsluiten. Dit is eenzijdig van het bronsysteem naar de aanvrager. De Digitale Delta API's beschrijven nog niet hoe data moet worden toegevoegd aan het bronsysteem.

Digitale Delta API

Er is een nieuwe Digitale Delta API versie 3 in ontwikkeling. Deze combineert DD-API, DD-GRID-API en DD-ECO-API tot één, met één zoekmechanisme (OData) en de mogelijkheid om aan te geven in welke vorm (observaties, tijdsreeksen, roosters, etc.) de resultaten moeten worden getoond.

Het semantisch model wordt zoveel als mogelijk vastgelegd: dus wat betekenen de eigenschappen, waar zijn ze vastgelegd en wat zijn geldige waarden.

DD-API

De DD-API maakt het mogelijk om waterkwantiteit-metingen te ontsluiten die verzameld zijn uit systemen die de DD-API implementeren.

DD-ECO-API

De DD-ECO-API is gespecialiseerd in het delen van metingen, voor zowel biologisch, chemisch als fysische metingen.
Deze API is primair bedoelt als uitwisselingsmechanisme tussen systemen, en heeft een eenvoudige zoek-taal, waardoor onderzoekers zelfstandig datasets kunnen selecteren.
De DD-ECO-API is niet beperkt tot slechts het opvragen van metingen: ook informatie over eenheden, grootheden, parameters (waaronder taxa), meetobjecten, notities, projecten en dergelijke kunnen via de DD-ECO-API worden opgevraagd.
Voorbeelden hiervan zijn de Taxonomische Waarnemingen Nederland (TWN-list), de Convenience-API, maar ook de data distributie-laag van Rijkswaterstaat maakt gebruik van deze toepassingen voor het delen van waterdata voor onderzoeksprojecten. Zo is de DD-ECO-API ingezet in het Deep project. De eenvoudige zoek-taal wordt ook uitgebreid met de OData protocol, wat onderdeel is van de nationale API-standaard.
De DD-ECO-API is onderdeel van de Digitale Delta.

Status: operationeel

C-API

De C-API vervult een brugfunctie tussen verschillende meetsystemen: zowel kwaliteit- als kwantiteit-informatie. Het kan informatie van o.a. FEWS, HydroNet en Lizard (via de DD-API) combineren, samen met ecologische data (DD-ECO-API) en andere systemen die metingen-gebaseerd zijn.
De C-API heeft een eenvoudige zoek-taal, vergelijkbaar met die van de DD-ECO-API.
De kracht van de C-API is de ‘multi stekkerdoos’ functie waarmee andere systemen kunnen worden toegevoegd.
Via de C-API zijn metingen, parameters, grootheden, eenheden en meetobjecten op te vragen.
Momenteel zijn er data-stekkers (plug-ins) voor DD-API, DD-ECO-API en Z-Info (afvalwaterverwerking).
Net als de DD-ECO-API is de C-API onderdeel van de Digitale Delta.

De C-API heeft op dit moment de status Proof Of Concept.
In tegenstelling tot de andere familieleden van de Digitale Delta familie, is C-API niet slechts als open-source definitie beschreven, maar is er ook een open-source broncode implementatie beschikbaar.

Status: beschikbaar als test

Met de onderstaande twee links kan er toegang worden verkregen tot de Generic Connector voor de C-API én de C-API Interface. De connector is een koppel-element die verschillende API's met elkaar kan verbinden: een soort coordinator. Via de Swagger beschrijving krijgen ontwikkelaars zicht op hoe ze de C-API connector kunnen gebruiken. De C-API Interface is ten opzichte van de C-API connector gebruiksvriendelijker voor bijvoorbeeld ook een eindgebruiker.

DD-API V3 (DD-UNI-API)

De DD-API V3 is een API die allerlei soorten informatie kan ontsluiten: kwaliteit, kwantiteit, rooster en voorspellingen. Het is gebaseerd op de nieuwe Observations, Measurements & Sampling, en heeft als zoek-taal de OData standaard. Het zal op den duur de DD-API, de DD-ECO-API en de DD-GRID-API kunnen vervangen. Het is echter niet beperkt tot de water-wereld.

Status: definitie en proof of concept afgerond, prototype oplevering medio september 2023