GENESIS-Webservice-Schnittstelle (API)

Unter „Webservice“ versteht man die „automatisierte Dienstabwicklung zwischen Applikationen im Internet“. Webservices sind also nicht für die menschliche Interaktion gedacht, sondern für Softwaresysteme, die automatisiert Daten austauschen und/oder Funktionen auf entfernten Rechnern aufrufen.

Durch die Nutzung des „GENESIS-Webservice“ kann der Datenbestand von GENESIS-Online in automatisierte Prozesse eingebunden werden.

Wir bieten aktuell 2 Schnittstellen/APIs mit je einer Vielzahl von Methoden zur Nutzung an:

• SOAP/XML
• RESTful/JSON

Die sprachlichen Schnittstellenbeschreibungen stehen unter folgender Adresse zur Verfügung:
https://landesdatenbank.nrw.de:443/ldbnrw/misc/GENESIS-Webservices_Einfuehrung.pdf

Die SOAP/XML-Schnittstelle der Landesdatenbank wird in einer der nächsten Versionen der Software GENESIS, voraussichtlich im Jahr 2025, eingestellt. Bitte berücksichtigen Sie dies wenn sie Daten über diese Schnittstelle abrufen oder dies planen. Nutzen Sie stattdessen bitte die RESTful/JSON-Schnittstelle.

Die technischen Schnittstellenbeschreibungen (WSDL) stehen unter folgender Adresse zur Verfügung:
https://www.landesdatenbank.nrw.de/ldbnrwws/services

Die technischen Schnittstellenbeschreibungen (WADL) stehen unter folgender Adresse zur Verfügung:
https://www.landesdatenbank.nrw.de/ldbnrwws/rest/2020/application.wadl

Swagger UI ist eine Online-Benutzeroberfläche für RESTful-Webdienste. Sie erlaubt die Ressourcen einer API anzuschauen und mit ihnen zu interagieren. Für die Nutzenden ist nachvollziehbar, welche Funktionen die API hat und welche Informationen verfügbar sind. Testanfragen können direkt über den Browser gesendet werden.

Swagger UI ermöglicht ein besseres Verständnis der API und eine interaktive Nutzung, ohne dass eine detaillierte Kenntnis des genauen Programmcodes erforderlich ist.

Die Swagger UI steht unter folgender Adresse zur Verfügung:
https://www.landesdatenbank.nrw.de/ldbnrwws/swagger-ui

Sie erreichen uns über Kontakt.