Von der DB FASTA API migrieren

Inhaltsverzeichnis

Die DB FASTA API (Facility Status API) liefert Echtzeit-Betriebsstatus von Aufzügen und Fahrtreppen an DB-Bahnhöfen. Transit importiert diese Daten automatisch und stellt sie über eine einheitliche REST-API bereit.

Gegenüberstellung

Stammdaten (Aufzüge)

FASTA API

Transit API

Hinweis

GET /facilities/{equipmentnumber}

GET /api/elevators?where[linked_data.operator_inventory_id][equals]={equipmentnumber}

Suche über Inventarnummer

equipmentnumber

linked_data.operator_inventory_id

Anlagennummer

type = ELEVATOR

elevator_type = elevator


type = ESCALATOR

elevator_type = escalator


description

function.short_visual / function.long_tts

Beschreibung wird automatisch bereinigt und erweitert (Abkürzungen ausgeschrieben, Pfeile hinzugefügt)

geocoordX / geocoordY

geometry (PostGIS Point)


stationnumber

linked_data.associated_site → main_identifier

Verknüpfung über DHID

operatorname

linked_data.operator_org → name

Relation zu Organisation

Betriebsstatus

FASTA API

Transit API

Hinweis

state = ACTIVE

operational_status.operational_status = in_service


state = INACTIVE

operational_status.operational_status = out_of_service


stateExplanation

status_spans[].description

Detaillierte Störungsinformationen in Status Spans

Störungshistorie

Die FASTA API liefert nur den aktuellen Zustand. Transit speichert zusätzlich Status Spans – historische Zeiträume mit Betriebszuständen:

GET /api/status-spans?where[original_elevator_id][equals]={equipmentnumber}&sort=-start_date

Beispiel: Aufzugsstatus abfragen

FASTA API (vorher):

GET https://apis.deutschebahn.com/db-api-marketplace/apis/fasta/v2/facilities/10018524

Transit API (nachher):

GET /api/elevators?where[linked_data.operator_inventory_id][equals]=10018524&depth=2

Response (Auszug):

{
  "docs": [{
    "id": 42,
    "elevator_type": "elevator",
    "operational_status": {
      "operational_status": "in_service"
    },
    "function": {
      "short_visual": "Empfangshalle → Gleis 1/2",
      "long_tts": "Empfangshalle zu Gleis 1/2"
    },
    "linked_data": {
      "operator_inventory_id": "10018524"
    }
  }]
}

Beispiel: Alle gestörten DB-Aufzüge

FASTA API (vorher):

GET https://apis.deutschebahn.com/db-api-marketplace/apis/fasta/v2/facilities?state=INACTIVE

Transit API (nachher):

GET /api/elevators?where[operational_status.operational_status][equals]=out_of_service&where[feed][equals]={db-fasta-feed-id}&depth=1

Wesentliche Unterschiede

Aspekt

FASTA API

Transit API

Scope

Nur DB InfraGO-Anlagen

Alle Betreiber (DB, BVG, S-Bahn etc.)

Beschreibungen

Roh (Abkürzungen)

Bereinigt + mehrsprachig + TTS-optimiert

Haltestellenbezug

stationnumber

DHID-basierte Zuordnung zu Stop Places

Historie

Nur aktueller Zustand

Status Spans mit Zeiträumen

Authentifizierung

DB API-Marketplace OAuth

Bearer-Token