Artikel: RIS-API Baustein RIS::Disruptions
Der Baustein liefert Informationen rund um Störungen mit Bezug zum Öffentlichen Personenverkehr. Schwerpunkt dabei ist die Störungskommunikation, d.h. das, was die Verkehrsunternehmen an die Reisenden weitergeben wollen.
Die Störungen und die dazugehörigen Störungskommunikationen sind zunächst einmal - wie Verkehrsmeldungen über Staus auf der Autobahn - nicht auf konkrete Fahrten und Reiseketten bezogen. Der Baustein liefert aber durch einen Abgleich mit den örtlichen und zeitlichen Informationen der Störung die davon nach aktueller Betriebslage betroffenen Fahrten, Haltestellen und Gebiete.
Details zur OpenAPI, zur Visualisierung der Spezifikation und zur automatisierten Code-Generierung von API-Clients sind im Bereich OpenAPI Technologie beschrieben.
Betroffene Fahrten für Störungskommunikation - GET /corresponding/journeys/{disruptionCommunicationID}
Der Endpunkt GET /corresponding/journeys/{disruptionCommunicationID} gib zu einer bestimmten Störungskommunikation entsprechende Fahrten zurück, in denen die Störungskommunikation angezeigt werden soll.
curl --request GET \
--header 'DB-Api-Key: <SECRET>' --header 'DB-Client-Id: <SECRET>' --url 'https://apis.deutschebahn.com/db/apis/ris-disruptions/v1/disruption-communications/e34f8739-6ca1-36bd-afa2-528063ce63e2'
Störungskommunikation auf Basis von Empfängerhinweisen – GET /disruption-communications/by-consumer-hints
Der Endpunkt GET /disruption-communications/by-consumer-hints gibt alle Störungskommunikationen zurück, die mit den angegebenen Empfängerhinweisen übereinstimmen. Dabei muss mind. ein Filterkriterium angeben sein.
curl --request GET \
--header 'DB-Api-Key: <SECRET>' --header 'DB-Client-Id: <SECRET>' --url 'https://apis.deutschebahn.com/db/apis/ris-disruptions/disruption-communications/by-consumer-hints?states=HESSEN
Kontakt
Bei Fragen oder Feedback zu den Bausteinen der RIS-API: ris-api@deutschebahn.com