Einleitung
Ein Großteil der in EuRIS angebotenen Dienste/Daten kann auch über Webservices (Open APIs) abgerufen werden. Dazu gehören:
- Referenzdaten (RIS-Index, Netzwerk)
- Fahrwasserobjekte (Schleusen, Brücken, Liegeplätze, Terminals usw.)
- dynamische Fahrwasserinformationen (Wasserstände, Brückendurchfahrtshöhe, Abfluss usw.)
- dynamische Verkehrsinformationen (Positionen, Verkehrsdichte usw.)
- Transportinformationen (Routenplanung, Reiseinformationen usw.)
Die Schnittstellen und deren Inhalte werden auf dem Open Service Portal beschrieben. Öffentlich zugängliche Service-Kategorien können ohne Anmeldung über die Schaltfläche "Try it out" getestet werden: Open Service Portal
Eine detaillierte Dokumentation der Schnittstellen inklusive Informationen und Code Beispiele für Entwickler finden sich auf folgender Seite: API Dokumentation
Die Verwendung der EuRIS Schnittstellen ist kostenlos. Bei Verwendung unserer Daten oder Services soll folgende Quellinformation angegeben werden:
- API/Service [Name von Schnittstelle/Service] eingebunden von EuRIS (www.eurisportal.eu)
Sicherheit
EuRIS APIs, die sensible Daten bereitstellen, sind gesichert.
Für eine dauerhafte Nutzung der Schnittstellen sowie deren Einbindung in Drittanwendungen (z.B. Applikationshersteller) müssen folgende Voraussetzungen erfüllt sein:
Der Client muss über ein gültiges OauthV2-Token verfügen. EuRIS unterstützt die Authentifizierung über OAUTH v2/Open ID connect. Ein Identitätsserver wurde integriert und kann für verschiedene Authentifizierungsabläufe verwendet werden (siehe: https://identityserver4.readthedocs.io/en/latest/intro/big_picture.html).
Um geschützte EuRIS-Dienste nutzen zu können, benötigen Sie ein autorisiertes Konto. Der Benutzer muss außerdem über die erforderlichen OAuth V2-Client-Zugangsdaten für die Maschine-zu-Maschine-Kommunikation verfügen. Der Authentifizierungsprozess sieht vor, dass der Client-Code die erforderlichen Token unter Verwendung der bereitgestellten Client-Anmeldeinformationen anfordert. Das Inhaber-Token wird für die weitere Webservice-Kommunikation verwendet.
Um die erforderlichen Client-Zugangsdaten zu erhalten, senden Sie bitte eine Anfrage über das Kontaktformular an den Helpdesk mit den folgenden Informationen:
- Name des Antragstellers (einschließlich Ansprechpartner im Unternehmen)
- Unternehmen / Privatperson
- Adresse
- Verwendungszweck
- Benötigte Schnittstellen / Daten
Nach erfolgreicher Prüfung stellt der zuständige EuRIS-Administrator die erforderlichen Informationen zur Verfügung, die eine uneingeschränkte Nutzung der angeforderten Schnittstellen gewährleisten.
Weiterlesen...