Die Open-Data-Plattform öV Schweiz bietet verschiedene API an.
Für den Zugriff auf die API ist ein API-Key (Token) notwendig. Dieser kann über das Developer Portal bezogen werden.
Das Token muss im HTTP Header als “Authorization” für jede Anfrage mitgeschickt werden. Die Verwendung unterliegt gewissen Limiten.
Das Developer Portal erlaubt:
- Erstellen von API-Schlüsseln
- Löschen von API-Schlüsseln
- Abfrage der Nutzung pro Schlüssel.
Die verfügbaren API
TRIAS / VDV 431:
- Abfahrts-/Ankunftsanzeiger (TRIAS 2020)
- TripRequest (TRIAS 2020)
- Fahrtprognose (TRIAS 2020)
- LocationInformationRequest (TRIAS 2020)
OJP:
GTFS-RT:
Diese API sind KEINE Rest-API und können daher auch nicht mit Tools wie Swagger einfach beschrieben werden. Die notwendige Dokument ist unter den Links verfügbar.
TRIAS (VDV 431) / OJP: Eigenschaften
Diese Dienste sind KEIN REST-Service. Über einen einzelnen Zugangspunkt
https://api.opentransportdata.swiss/trias2020
können Abfragen mittels “POST” durchgeführt werden.
(Achtung: Kein Schluss “/” im Aufruf)
Der Authorization Header muss den API-Key enthalten.
Der Content-Type muss auf “text/XML” oder “application/XML” eingestellt sein.
Die Antwort ist immer eine XML-Struktur, die vom Service abhängt. Diese muss dann verarbeitet werden.
Zugriff auf “Daten” in statischen Datensätzen per API
Auch die “Daten” in CKAN können über ein API bearbeitet werden. Dieses unterliegt nicht den Restriktionen der Schlüssel. Im Cookbook findet sich ein Beispiel zu Haltestellen.