Digitale Delta API's

De Digitale Delta is een blauwdruk voor API's in de watersector. Deze blauwdruk zorgt voor consistentie tussen verschillende implementaties, wat het gebruik en de integratie van waterdata aanzienlijk vereenvoudigt.

Kenmerken van Digitale Delta API's:

  • Observations, Measurement & Samples: Een zo kaal mogelijke definitie van deze meetgegevens-standaard, wat zorgt voor eenvoud en flexibiliteit in dataverzameling en -analyse
  • OData: Een wereldwijde, standaard zoek-taal.
  • Consistente structuur: Alle API's die de Digitale Delta blauwdruk volgen, hebben een vergelijkbare opbouw en werking.
  • Gestandaardiseerde requests en responses: Dit maakt het gemakkelijker om met meerdere databronnen te werken.
  • Vereenvoudigde datamodellen: Complexe relaties tussen entiteiten worden vermeden, wat het opvragen van data vereenvoudigt.
  • Interoperabiliteit: Data van verschillende bronnen kan eenvoudiger worden gecombineerd en vergeleken.

API's

API's (Application Programming Interfaces) zijn sets van regels en protocollen die verschillende softwaretoepassingen in staat stellen om met elkaar te communiceren. Ze fungeren als een brug tussen verschillende systemen, waardoor gegevens en functionaliteiten kunnen worden gedeeld zonder dat de onderliggende code zichtbaar is. In de context van Digitale Delta maken API's het mogelijk om waterdata efficiënt en gestandaardiseerd uit te wisselen tussen verschillende bronnen en toepassingen.

API's zijn technisch, daar is geen ontkomen aan. Voor ontwikkelaars zijn er diverse tools beschikbaar, zoals:

  • Postman: Een veelzijdige tool voor het testen van API's, inclusief OData-services. Het biedt een gebruiksvriendelijke interface voor het maken van HTTP-verzoeken.
  • OData CLI: Een command-line tool voor het werken met OData-services, ideaal voor meer technisch onderlegde gebruikers.
  • Visual Studio Code met OData-extensies: Zoek naar "OData" in de extensie-marktplaats van VS Code voor hulpmiddelen bij het werken met OData.
  • OData Libraries: Voor ontwikkelaars zijn er verschillende bibliotheken beschikbaar in verschillende programmeertalen om OData-services te consumeren.

De officiële documentatie is hier te vinden.

Voor minder technisch aangelegd publiek werken we aan het volgende.

Query Builder voor Digitale Delta API's:

We werken aan een generieke Query Builder Tool die geschikt zal zijn voor alle API's die de Digitale Delta blauwdruk volgen. Deze tool zal:

  • Werken met verschillende Digitale Delta API-implementaties.
  • Een intuïtieve interface bieden voor het bouwen van queries, zonder dat technische kennis van OData vereist is.
  • Gebruikers in staat stellen om eenvoudig data op te vragen van verschillende bronnen die Digitale Delta API's aanbieden.
  • Voorzien in filtermogelijkheden die passen bij de gestandaardiseerde structuur van Digitale Delta API's.

Huidige status en toekomstplannen:

We zijn bezig met de ontwikkeling van deze Query Builder Tool. Onze focus ligt op:

  • Het creëren van een gebruiksvriendelijke interface die werkt met verschillende Digitale Delta API-implementaties.
  • Het implementeren van functionaliteiten die de gemeenschappelijke kenmerken van Digitale Delta API's benutten.
  • Het bieden van hulp en begeleiding bij het maken van effectieve queries over verschillende databronnen heen.

We streven ernaar om binnenkort een bèta-versie van deze tool beschikbaar te stellen. Uw feedback zal van onschatbare waarde zijn om de tool te verfijnen en aan te passen aan de behoeften van de gebruikers in de watersector.

Heeft u ideeën of specifieke wensen voor deze Query Builder Tool, of wilt u meer weten over hoe u Digitale Delta API's kunt gebruiken? Neem dan contact met ons op via info@ecosys.nl.