RFI APIrfi.it ↗

"""Walkthrough: RFI Italian Railway API — bounded, re-runnable; every call capped."""
from parse_apis.rfi_italian_railway_api import RFI, Station, StationDetail, LiveBoard, StationMapping, Alert, BoardType, StationNotFound

rfi = RFI()

# Fetch full station-name-to-placeId mapping
mapping = rfi.stationmappings.fetch()
print(mapping.total, list(mapping.mappings.items())[:3])

# Search for stations in the Lazio region containing "Roma"
for station in rfi.stations.search(region="Lazio", query="Roma", limit=5):
    print(station.name, station.province, station.passenger_service)

# Get detailed station info by slug
detail = rfi.stationdetails.get(slug="roma-termini")
print(detail.name, detail.slug, detail.services, detail.accessibility)

# Fetch live departure board using the BoardType enum
board = rfi.liveboards.fetch(station_name="ROMA TERMINI", type=BoardType.DEPARTURES)
print(board.station, board.type)
for train in board.trains[:3]:
    print(train.train_number, train.category, train.destination, train.scheduled_time, train.delay)

# Retrieve current circulation alerts
current_alerts = rfi.alerts.list()
for msg in current_alerts.alerts[:3]:
    print(msg)

# Typed error handling: catch StationNotFound for an invalid slug
try:
    rfi.stationdetails.get(slug="nonexistent-station-xyz")
except StationNotFound as exc:
    print(f"Station not found: {exc.station_slug}")

print("exercised: stationmappings.fetch / stations.search / stationdetails.get / liveboards.fetch / alerts.list / StationNotFound")