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 Verfügbarkeits-Historie in Halbstundenschritten. Diese Seite und oeffigo.app/status lesen dieselbe Quelle.

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>, denn „alle Prognosen“ ist keine Frage, die dieser Endpunkt beantwortet.

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 ist bewusst kein offener Proxy auf den Betreiber-Monitor. 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. Das ist kein Ausfall, sondern eine bewusste Bremse — probier es 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 bewusst nicht ist.

Die typisierten Routen, über die die Apps Fahrplan- und Auskunftsdaten holen, sind fest an die Apps gebunden und nicht Teil dieser Dokumentation. Sie sind kein allgemeiner Proxy auf fremde Anbieter, und Zugangsdaten dafür verlassen den Server nie. 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.