Die öffentliche API.

Kurzer Lebenszeichen-Check.

Antwortet mit 200, solange der Worker einen frischen erfolgreichen Zyklus hinter sich hat, sonst mit 503. Gedacht für Monitoring, nicht für Datenabfragen.

curl -s https://api.oeffigo.app/v1/health

{
  "ok": true,
  "version": "5dc1a29",
  "predictionsLive": 1312,
  "confidentPredictions": 1190
}

Betriebszustand aller Komponenten.

Liefert den Gesamtzustand, eine Komponentenliste und je Datenweg eine Erfolgs-Historie in Halbstundenschritten. Die eigenständige Statusseite verbindet diesen Bericht mit externen Prüfungen. Erfolgreiche Datenabrufe sind keine extern gemessene Verfügbarkeit.

curl -s https://api.oeffigo.app/v1/status

{
  "generatedAt": "2026-07-26T13:25:06.754Z",
  "overall": "operational",
  "components": [
    { "id": "api", "name": "…", "status": "operational" }
  ],
  "measurement": { "mode": "official_realtime" }
}

Zuverlässigkeits-Auswertung aus offiziellen Ist-Zeiten.

Summen, Tagesverlauf, Linien und ein Wochentag×Stunde-Muster. Gezählt werden einzelne Halte, nicht ganze Fahrten. Ein fehlender Datenpunkt gilt nie als Ausfall — Ausfälle stammen ausschließlich aus expliziten Ereignissen.

curl -s "https://api.oeffigo.app/v1/history?from=2026-07-15&to=2026-07-26&line=U1"

{
  "period": { "from": "2026-07-15", "to": "2026-07-26" },
  "totals": {
    "onTimeShare": 0.9556,
    "avgDelayMin": 0.57,
    "late10Share": 0.007
  },
  "officialRealtime": {
    "daily": [ { "day": "2026-07-26", "events": 18109, "on_time_pct": 97.4 } ],
    "lines": [ { "line": "U1", "events": 39970, "on_time_pct": 96 } ],
    "heatmap": [ { "dow": 1, "hour": 8, "avg_delay_min": 0.6 } ]
  }
}

• Fünf Minuten am Edge cachebar, unterstützt ETag und 304.
• `dow` ist ISO: 1 = Montag … 7 = Sonntag.

Eigene Verspätungsprognosen aus offizieller Echtzeit.

Nur Einträge mit hoher oder mittlerer Sicherheit. Jeder Eintrag verfällt spätestens acht Minuten nach der letzten echten Beobachtung; ältere Werte werden nicht ausgeliefert. <strong>Ein Filter ist Pflicht</strong>: ohne einen kommt <code>400 missing_query</code>.

curl -s "https://api.oeffigo.app/v1/predictions?line=U1&limit=50" -H 'If-None-Match: "abc123"'

{
  "generatedAt": "2026-07-26T13:25:06.754Z",
  "count": 2,
  "predictions": [
    { "jid": "og1.…", "delayMin": 2, "confidence": "high" }
  ]
}

• Antworten tragen ein schwaches ETag. Mit If-None-Match bekommst du ein 304 ohne Body, solange sich der Snapshot nicht geändert hat — die batteriefreundliche Art zu pollen.

Viele Fahrt-Referenzen auf einmal abfragen.

Fahrt-Referenzen sind lang und gehören nicht in eine URL. Für mehr als eine Handvoll ist das der richtige Weg.

curl -s -X POST https://api.oeffigo.app/v1/predictions/batch \
  -H 'content-type: application/json' \
  -d '{"jids":["og1.…","og1.…"]}'

{
  "generatedAt": "2026-07-26T13:25:06.754Z",
  "count": 2,
  "predictions": [ … ]
}

Begrenzter Kartenausschnitt mit Fahrzeugen.

Verlangt entweder eine Bounding-Box oder eine Liste von Fahrt-Referenzen — ohne Filter gibt es keine Antwort. Einträge sind höchstens acht Minuten alt. Das Feld `source` sagt dir, was ein leeres Ergebnis bedeutet.

curl -s "https://api.oeffigo.app/v1/vehicles?minLat=48.18&minLon=16.30&maxLat=48.24&maxLon=16.42"

{
  "generatedAt": "2026-08-03T19:25:06.754Z",
  "count": 242,
  "source": "ondemand_live",
  "measurementMode": "official_realtime",
  "vehicles": [ { "jid": "og1.…", "lat": 48.2, "lon": 16.37 } ]
}

• `ondemand_live` mit leerer Liste heißt „gerade keine Fahrzeuge“, nicht „Dienst aus“. `ondemand_capped` heißt „Live-Fahrzeuge vorübergehend nicht verfügbar“.

Wiener U-Bahn-Echtzeit, gecacht.

Nur Stationen aus einer festen Liste; der Endpunkt reicht keine beliebigen Anfragen an den Betreiber-Monitor weiter. Datenquelle: Stadt Wien, CC BY 4.0.

curl -s "https://api.oeffigo.app/v1/wiener-linien/metro?diva=60200657"

{
  "generatedAt": "2026-08-03T19:16:51.814Z",
  "status": "ok",
  "departures": [
    { "line": "1", "towards": "Stefan-Fadinger-Platz",
      "plannedAt": "2026-08-03T19:23:30.000Z",
      "realAt": "2026-08-03T19:26:50.000Z" }
  ]
}

• Die Verspätung steht nicht als Zahl drin — sie ist die Differenz aus realAt und plannedAt. Beides sind ISO-Zeitstempel, keine Millisekunden.
• Kann 503 source_standby antworten, wenn die Wiener-Linien-Quelle gerade abgeschaltet ist. Probier es dann später erneut.

Servergesteuerte Meldungen für die Apps.

Erlaubt es, Hinweise ohne App-Update auszuspielen. Geschlossene und abgelaufene Meldungen sind nicht enthalten.

curl -s https://api.oeffigo.app/v1/announcements

{
  "generatedAt": "2026-07-26T13:25:06.754Z",
  "announcements": [ { "id": "…", "title": "…", "body": "…" } ]
}

Was die API nicht bietet.

Die typisierten Routen, über die die Apps Fahrplan- und Auskunftsdaten holen, sind fest an die Apps gebunden und nicht Teil dieser Dokumentation. Bitte baue nichts, das darauf angewiesen ist.

Fahrt-Referenzen (og1.…) sind undurchsichtig und an einen Anbieter gebunden. Sie dürfen nicht entpackt, umgebaut oder zwischen Netzen gemischt werden — gib sie unverändert zurück.

Die API ist offen, damit man damit etwas bauen kann. Bleib in den Limits, cache Antworten, und wenn du Wiener Echtzeitdaten weiterverwendest, nenne die Quelle: Stadt Wien — data.wien.gv.at, CC BY 4.0.