Die ODEG API bietet Zugriff auf Störungen und Fahrplanabweichungen bei der ODEG. Die Daten stammen von odeg.de. Über den GET-Parameter source
kann zwischen zwei den Datenquellen gewählt werden:
api_odeg_outages
).
api_odeg_timetable
).
Hinweis: Für den Zugriff auf die API ist ein gültiger API-Key erforderlich. Ein API-Key für den Zugang ist auf Anfrage erhältlich.
Die in der Datenbank gespeicherten ODEG-Daten werden alle 5 Minuten aktualisiert.
Jeder API-Aufruf muss den Parameter api_key
enthalten. Wird dieser nicht mitgegeben oder ist er ungültig, liefert die API eine entsprechende Fehlermeldung.
?api_key=DEIN_API_KEY
Die API erwartet den GET-Parameter source
mit folgenden erlaubten Werten:
Zusätzlich stehen optionale Filterparameter zur Verfügung:
0
oder 1
; Standard: 1
) (1 heißt die Meldung besteht noch, 0 dass die Meldung veraltet ist).
source=outages
linie
).?line=RB
oder ?line=RB51
?bhfvon=Pritzerbe
?bhfvonid=1234
?datum=2025-04-01
?datum_start=2025-04-01&datum_end=2025-04-06
?time_von=08:00
oder ?time_von_start=07:00&time_von_end=09:00
?time_bis=09:00
source=timetable
?line=RB
?stations=Magdeburg
?date_start=2025-04-01&date_end=2025-04-07
Standardmäßig liefert die ODEG API Daten im JSON-Format. Mit dem Parameter format
kann das Ausgabeformat geändert werden:
?format=json
?format=xml
?format=csv
?format=jsonp&callback=DEIN_CALLBACK
Beispielaufruf für einen Datensatz aus der Quelle outages
:
https://api.ix23.de/odeg/?api_key=DEIN_API_KEY&source=outages&active=1&line=RB&datum_start=2025-04-01&datum_end=2025-04-06&format=json
Dieser Aufruf liefert alle aktiven Störfälle (Quelle: outages
), bei denen in der Linienbezeichnung "RB" vorkommt und die innerhalb des angegebenen Datumsbereichs liegen – als JSON-Daten.
Bei fehlerhaften oder unvollständigen Parametern gibt die API eine entsprechende Fehlermeldung zurück. Beispiele:
{
"error": "API key missing (API-Schlüssel fehlt)"
}
{
"error": "Invalid source. Please specify \"outages\" or \"timetable\" (Ungültiger Wert für source. Bitte \"outages\" oder \"timetable\" angeben)"
}