v5

latestOpenAPI 3.1.0Apache-2.02026-08-0212527433.1 KB
Live

Live-ÖPNV-Abfahrten je Halt mit Verspätung (GTFS-RT, Tier B)

Liefert die Live-Abfahrten eines Halts mit aktueller Verspätung aus dem GTFS-RT-Feed (gtfs.de bzw. Mobilithek-DELFI, CC-BY-SA = Tier B) im Live-Envelope (meta mit as_of und refresh_seconds=45, dem Poller-Takt). Der Request-Pfad liest NUR aus Redis: ein Hintergrund-Poller parst den Feed einmal je Takt, sodass nicht bei jedem Request ein 68-MB-Feed geparst wird. RT-only-Semantik: ausgeliefert werden ausschliesslich Trips mit Echtzeit-Update; Fahrplan-Sollzeiten sind NICHT enthalten. Traegt ein Update eine absolute Abfahrtszeit (z.B. Berlin/VBB), wird sie auf Zukunft geprueft (90-s-Grace) und aufsteigend sortiert; Delay-only- Updates ohne absolute Zeit (Regelfall im bundesweiten Feed) kommen MIT delay_s/delay_min und departure_time/minutes_until = null nach den zeitbehafteten Eintraegen. stop_id darf Parent- ODER Steig-Ebene sein (de:AGS:nr bzw. de:AGS:nr:bereich:steig), beide werden aufgeloest. meta weist zusaetzlich raw_updates_total und filtered_out aus (ehrliche Rohzahlen, keine stille Kappung). Toggle aus -> 200 source_status="disabled"; kein Update in Redis oder alles gefiltert -> 200 source_status="no_data"; ungültige stop_id -> 400. Reine Live-Daten, nur im Redis-Cache gehalten (Tier B).

get/api/v1/live/{city}/transit/departures

Path parameters

citystring required
Example:berlin

Query parameters

stop_idstring required
Example:de:11000:900003101::6

DELFI-Halt-ID im Muster de:<AGS>:<id> (gegen eine Allowlist geprüft). Gültige IDs je Stadt liefert GET /api/v1/cities/{slug}/transit im Feld stop_id. NICHT die trip_stop_id der Bahnhofstafeln, die bezeichnet einen Halt einer Zugfahrt.

Response

Live-Abfahrten-Envelope (CanonicalRecord oder null)

Example response

{
  "data": {
    "attribution": {
      "text": "Wikidata"
    }
  }
}