RufBusle/Entwickler
Dokumentation
GET/api/v1/lines

Linien

Linien der aktiven Fahrpläne, entsprechend GTFS routes.

Wofür

Ordnet Fahrten einer Linie zu und sagt, wie die Linie betrieben wird — als feste Route oder als Bedienzone.

Anfrage

Erfordert das Recht read:schedule.
AnfrageShell
curl -sS \
  -H "Authorization: Bearer rb_live_…" \
  "https://rufbusle.de/api/v1/lines"

Query-Parameter

limit
Seitengröße, 1–200. Ohne Angabe 50.
cursor
Wert aus nextCursor der vorigen Seite.

Antwort

Seitenweise: data mit den Einträgen, nextCursor für die Folgeseite.
BeispielantwortJSON
{
  "data": [
    {
      "id": "lin_3Nb8pZ",
      "shortName": "451",
      "longName": "Rufbus Musterstadt Nord",
      "routeType": 715,
      "dispatchMode": "FIXED_ROUTE",
      "runsOnlyIfBooked": true
    }
  ],
  "nextCursor": "bkg_5Rt8wY"
}

Beispielwerte, keine echten Daten. Unbekannte Felder bitte ignorieren — es können jederzeit welche hinzukommen.

Felder je Eintrag (Line)

Die Hülle mit data und nextCursor ist bei allen Listen gleich; hier stehen die Felder eines einzelnen Eintrags.
FeldTypBeschreibung
idstringReferenz für lineId einer Fahrt.
shortNamestringKurzbezeichnung, wie sie Fahrgäste sehen.
longNamestring | nullAusführliche Bezeichnung, falls gepflegt.
routeTypeintegerGTFS route_type (715 = bedarfsgesteuert).
dispatchModestringBetriebsform: FIXED_ROUTE (feste Route) | AREA_MANUAL | AREA_AUTO (Flächenbedienung).
runsOnlyIfBookedbooleanFahrt steht im Fahrplan, findet aber nur bei mindestens einer Buchung statt.

Worauf zu achten ist

Die Punkte, an denen Integrationen erfahrungsgemäß hängen bleiben.
  • dispatchMode unterscheidet linienhaften Verkehr (FIXED_ROUTE) von Flächenbedienung (AREA_MANUAL, AREA_AUTO). Für die Dienstplanung ist das der Unterschied zwischen Umlauf und Bereitschaft.
  • runsOnlyIfBooked: true heißt: die Fahrt steht im Fahrplan, findet aber nur statt, wenn jemand gebucht hat. Ohne diese Unterscheidung planen Sie Leerfahrten ein.