Der Webservice INSEL ist eine webbasierte Anwendung zur Bereitstellung hochwertiger Fachdaten sowie spezialisierter Algorithmen für die Binnenschifffahrt. Ziel von INSEL ist es, Infrastruktur-, Gewässer- und Verkehrsdaten gebündelt zugänglich zu machen und ergänzend fachliche Dienste zur Datenverarbeitung bereitzustellen.
Weitere Informationen zu INSEL finden Sie unter Info > INSEL.

Um INSEL nutzen zu können, benötigen Sie einen Benutzeraccount. Bitte geben Sie dazu Ihre Kontaktinformationen sowie eine kurze Begründung an.
Die Registrierung erfolgt derzeit per E-Mail an admin.insel@baw.de.

Mit der Nutzung des Webservices akzeptieren Sie die geltenden Nutzungsbedingungen sowie den Haftungsausschluss.
Siehe Nutzungsbedingungen und Haftungsausschluss.

INSEL stellt Daten und Services per Swagger UI und per API bereit. Für diesen Zugriff wird ein API-Token benötigt. Diesen können Sie selbst generieren.
Siehe Dokumentation Token.

Antworten auf häufig gestellte Fragen finden Sie in unseren FAQ.

Code- und Aufrufbeispiele finden Sie hier: Beispiele.
Zudem enthält jeder Endpunkt der Swagger-Dokumentation mindestens einen Beispielaufruf.

Auf der Seite Dokumentation Daten werden die Daten ausführlich beschrieben. Die Services sind auf der Seite Dokumentation Services dokumentiert.

Die Funktionsweise der API wird in der interaktiven API-Dokumentation (Swagger-UI) erläutert. Für jeden Endpunkt eines jeden Services sowie für alle Daten werden alle verfügbaren HTTP-Methoden beschrieben. Dabei werden Parameter, Datenmodelle, Request- und Response-Strukturen, Statuscodes, Sicherheitsmechanismen, Filterparameter und Beispielaufrufe dokumentiert. Für jeden einzelnen Parameter werden der Datentyp, die Beschreibung, die Kennzeichnung als Pflicht- oder Optionalfeld sowie die zugehörigen Validierungsregeln festgehalten. Darüber hinaus werden Query-, Path-, Header- und Cookie-Parameter dokumentiert.
Swagger UI bietet eine interaktive Oberfläche, mit der sich die API kennenlernen und direkt ausprobieren lässt. Über die interaktive Testfunktion können Anfragen direkt im Browser verschickt und Antworten empfangen werden. Dazu werden die Anfrageparameter in die Formularfelder eingetragen und die Anfrage anschließend abgeschickt. Die Antwort enthält Informationen wie den HTTP-Statuscode, das JSON-Schema der Antwort, die Anfrage-URL, den "Response Header" und den "Response Body". Die verfügbaren Filterparameter für die GET-LIST-Endpunkte sind ebenfalls in der Swagger UI dokumentiert.