Inleiding
Het grootste gedeelte van de diensten/data die terug te vinden zijn op EuRIS kunnen ook bevraagd worden via een webservice (Open API's). Deze bevatten:
- referentiedata (RIS Index, netwerk)
- kunstwerken (sluizen, bruggen, ligplaatsen, terminals, ...)
- dynamische waterweg informatie (waterstanden, brughoogtes, afvoeren, ...)
- dynamische verkeersinformatie (posities, verkeersdrukte, ...)
- transport informatie (routes, reisinformatie,...)
De interfaces en hun inhoud zijn beschreven op het Open Service Portaal. Publiek beschikbare services kunnen getest worden zonder registratie en via de "try it out" functie : Open Service Portaal inclusief documentatie
Bijkomende documentatie en informatie voor ontwikkelaars met betrekking tot de API's, inclusief code voorbeelden kunnen op de volgende pagina teruggevonden worden: API Documentation
Het gebruik van de EURIS API's is gratis en zeer welkom. Wanneer u gebruik maakt van onze dataservices dient volgende bron van informatie aan uw resultaat toegevoegd te worden:
- API/Service [name of API/service] incorporated from EuRIS (eurisportal.eu)”
Security
EuRIS API's die gevoelige gegevens leveren, zijn beveiligd.
Voor een permanent gebruik van de interfaces en de integratie ervan in toepassingen van derden (bijv. app-bouwers), is het noodzakelijk om aan de volgende vereisten te voldoen:
De client moet een geldig OauthV2-token hebben. EuRIS ondersteunt verificatie via OAUTH v2/Open ID connect. Een identiteitsserver is geïntegreerd en kan worden gebruikt voor verschillende authenticatiestromen (zie: https://identityserver4.readthedocs.io/en/latest/intro/big_picture.html).
Als u beveiligde EuRIS-services wilt gebruiken, moet u een geautoriseerd account hebben. De gebruiker moet ook over de benodigde OAuth V2-clientreferenties beschikken voor communicatie tussen machines. Het verificatieproces voorziet dat de clientcode de benodigde tokens moet vragen met behulp van de verstrekte clientreferenties. Het bearer token wordt gebruikt in verdere webservicecommunicatie.
Om het vereiste token te ontvangen, stuurt u een verzoek via het contact formulier naar de helpdesk met de volgende informatie:
- Naam van de aanvrager (inclusief contactpersoon van het bedrijf)
- Bedrijf / particulier
- Adres
- Reden van gebruik
- Vereiste interfaces / data
Na een geslaagd onderzoek verstrekt de verantwoordelijke EuRIS-beheerder de vereiste informatie die een onbeperkt gebruik van de gevraagde interfaces garandeert.
Lees meer...