Samtens

API

DBF-Abfahrtstafeln können gerne als iframe eingebunden oder in fest installierten Vollbild-Browserfenstern verwendet werden. Für eine kleine Ansicht (z.B. iframe in einer normalen Website) empfiehlt sich das "App"-Frontend. Für eine große Ansicht (z.B. als alleinstehender Infoscreen) gibt es den "Infoscreen"-Modus.
Die Abfahrtstafel unterstützt Namen, EVA-IDs, und (im IRIS-Backend) DS100/Ril100-Codes zur Identifikation von Stationen.
Abfahrten werden mit Echtzeitdaten bzw. Prognosen angegeben und danach sortiert. Mit dem Parameter rt=0 wwerden stattdessen Plandaten angegeben und zur Sortierung genutzt.
Bei HAFAS-Backends können optional Details für spezifische Fahrten im DD.MM.[YYYY]-Format abgefragt werden, z.B. "ICE 921 (1.1.)" oder "ICE 921 @ 1.1.". Das Datum bezieht sich auf die geplante Abfahrtszeit am Startbahnhof der Fahrt.
Viele Seiten sind auch als JSON verfügbar, wahlweise mittels Accept: application/json oder durch .json in der URL. HAFAS- und IRIS-Abfahrtstafeln liefern mit dem GET-Parameter version=3 eine stabile JSON-API. Alle anderen Endpunkte (sowie Abfahrtstafeln mit version=raw) erlauben direkten Zugriff auf die serialisierten Travel::Status::DE::{EFA,HAFAS,IRIS}-Objekte ohne stabile API.
Bitte maximal 10 Anfragen pro Minute und insbesondere nur eine Anfrage pro Station und Minute – eine höhere Auflösung haben die Backenddaten ohnehin nicht.
Mit limit kann die Anzahl der angezeigten / im JSON enthaltenen Abfahrten eingeschränkt werden, z.B. limit=10 für die ersten zehn.
Dieser Dienst ist Open Source-Software und kann leicht (z.B. mittelS Docker) auf eigenen Servern installiert werden. Automatisierte Crawler, die mehrere Dutzend Stationen pro Minute abfragen, bitte nur auf eigenen Instanzen betreiben.