# InfraNode API

> Eine kostenlose, öffentliche Open-Data-Proxy-REST-API, die fragmentierte offene Daten deutscher Großstädte (84 Städte über 100.000 Einwohner, davon 28 Kern-Städte voll abgedeckt) hinter einer einheitlichen, normalisierten JSON-Schnittstelle bündelt (Stammdaten, Luftqualität, Wetter, POIs, ÖPNV, Verkehr). Jede Antwort folgt dem kanonischen Envelope mit data und meta auf Top-Level (source_status, correlation_id und cache_status liegen in meta); jeder data-Record trägt zusätzlich ein attribution-Feld mit Lizenz und Herkunft.

Diese Datei listet alle Endpunkte mit Links zu ihrer Doku im Markdown-Format. Je Endpunkt-Seite existiert eine .md-Variante unter https://infranode.dev/api/<operationId>.md für den direkten Maschinen-Konsum.

## Seiten

- [Quick-Start](https://infranode.dev/quickstart/): In drei Schritten zum ersten Aufruf, ohne Schlüssel.
- [Städte](https://infranode.dev/staedte/): Durchsuchbare Liste aller 84 abgedeckten Großstädte mit Slug, Bundesland, Einwohnern und Abdeckung.
- [MCP-Server](https://infranode.dev/mcp/): Offizieller MCP-Server mit 21 Stadtdaten-Tools, Einrichtung in Claude Code und Claude Desktop.
- [Über](https://infranode.dev/ueber/): Hintergrund zum Projekt, kostenlose Open-Data-API (Quellcode-Veröffentlichung in Vorbereitung), Betrieb in Deutschland, Kontakt.
- [Impressum](https://infranode.dev/impressum/): Anbieterangaben nach DDG.
- [Datenschutz](https://infranode.dev/datenschutz/): Keine Cookies, kein Tracking, DSGVO-Rechte.

## English

- [Home](https://infranode.dev/en/): Free, public open-data API for German cities.
- [Quickstart](https://infranode.dev/en/quickstart/): Your first call in three steps, no key.
- [Cities](https://infranode.dev/en/cities/): Searchable list of all 84 covered cities with slug, state, population and coverage.
- [MCP server](https://infranode.dev/en/mcp/): Official MCP server with 21 city-data tools.
- [About](https://infranode.dev/en/about/): Background, free open-data API (source code release in preparation), contact.

## Live

- [GET /api/v1/live/{slug}/air](https://infranode.dev/api/getLiveAir.md): Live-Alias für Luftqualität OpenAQ
- [GET /api/v1/live/{slug}/air-uba](https://infranode.dev/api/getLiveAirUba.md): Live-Alias für Luftqualität UBA
- [GET /api/v1/live/{city}/baustellen](https://infranode.dev/api/getLiveBaustellen.md): Live-Baustellen je Stadt (Mobilithek DATEX-II)
- [GET /api/v1/live/berlin/verkehrsmeldungen](https://infranode.dev/api/getLiveBerlinVerkehrsmeldungen.md): Live-Verkehrsmeldungen Berlin (Mobilithek DATEX-II)
- [GET /api/v1/live/dortmund/parking](https://infranode.dev/api/getLiveDortmundParking.md): Live-Parkbelegung Dortmund (Mobilithek DATEX-II)
- [GET /api/v1/live/{city}/ereignisse](https://infranode.dev/api/getLiveEreignisse.md): Live-Verkehrsereignisse je Stadt (Mobilithek DATEX-II)
- [GET /api/v1/live/eround/charging](https://infranode.dev/api/getLiveEroundCharging.md): Live-Ladesäulen-Belegung eRound (Mobilithek DATEX-II V3)
- [GET /api/v1/live/{slug}/flood](https://infranode.dev/api/getLiveFlood.md): Live-Alias für Hochwasser-Warnstufen LHP
- [GET /api/v1/live/kiel/zaehlstellen](https://infranode.dev/api/getLiveKielZaehlstellen.md): Live-Zähldaten Kiel, Kfz- und Radzählstellen (Mobilithek DATEX-II)
- [GET /api/v1/live/koeln/umweltzone](https://infranode.dev/api/getLiveKoelnUmweltzone.md): Live-Umweltzone Köln (Mobilithek DATEX-II)
- [GET /api/v1/live/{slug}/traffic](https://infranode.dev/api/getLiveTraffic.md): Live-Alias für Verkehr und Baustellen Autobahn
- [GET /api/v1/live/{city}/traffic-flow](https://infranode.dev/api/getLiveTrafficFlow.md): Live-Verkehrslage je Stadt (Mobilithek DATEX-II)
- [GET /api/v1/live/{city}/transit/departures](https://infranode.dev/api/getLiveTransitDepartures.md): Live-ÖPNV-Abfahrten je Halt mit Verspätung (GTFS-RT, Tier B)
- [GET /api/v1/live/{city}/transit/routes/{route_id}/status](https://infranode.dev/api/getLiveTransitRouteStatus.md): Live-ÖPNV-Verspätungslage einer Linie (GTFS-RT, Tier B)
- [GET /api/v1/live/{city}/transit/trips/{trip_id}](https://infranode.dev/api/getLiveTransitTrip.md): Live-ÖPNV-Fahrt-Detail inkl. geschätzter Position (GTFS-RT, Tier B)
- [GET /api/v1/live/{slug}/water-level](https://infranode.dev/api/getLiveWaterLevel.md): Live-Alias für Pegelstand PEGELONLINE
- [GET /api/v1/live/{slug}/webcams](https://infranode.dev/api/getLiveWebcams.md): Live-Alias für Autobahn-Webcams

## cities

- [GET /api/v1/cities](https://infranode.dev/api/getCities.md): Alle bekannten Städte auflisten
- [GET /api/v1/cities/{slug}](https://infranode.dev/api/getCity.md): Eine Stadt aus dem Register holen
- [GET /api/v1/cities/{slug}/air](https://infranode.dev/api/getCityAir.md): Luftqualität je Stadt (OpenAQ)
- [GET /api/v1/cities/{slug}/air-uba](https://infranode.dev/api/getCityAirUba.md): Luftqualität je Stadt (Umweltbundesamt)
- [GET /api/v1/cities/{slug}/base](https://infranode.dev/api/getCityBase.md): Stadt-Stammdaten aus Wikidata
- [GET /api/v1/cities/{slug}/charging](https://infranode.dev/api/getCityCharging.md): E-Ladesäulen-Standorte je Stadt (BNetzA, Tier A)
- [GET /api/v1/cities/{slug}/demographics](https://infranode.dev/api/getCityDemographics.md): Demografie-Zeitreihen je Stadt (GENESIS/Regionalstatistik, Tier A)
- [GET /api/v1/cities/{slug}/election](https://infranode.dev/api/getCityElection.md): Wahlergebnis je Stadt (Bundeswahlleiterin, Tier A)
- [GET /api/v1/cities/{slug}/energy](https://infranode.dev/api/getCityEnergy.md): Energie-Anlagen je Stadt (MaStR, Tier A)
- [GET /api/v1/cities/{slug}/events](https://infranode.dev/api/getCityEvents.md): Veranstaltungen je Stadt (destination.one)
- [GET /api/v1/cities/{slug}/flood](https://infranode.dev/api/getCityFlood.md): Hochwasser-Warnstufen je Stadt (LHP, Tier A)
- [GET /api/v1/cities/{slug}/geo](https://infranode.dev/api/getCityGeo.md): Verwaltungsgrenze je Stadt (BKG VG250, Tier A)
- [GET /api/v1/cities/{slug}/health](https://infranode.dev/api/getCityHealth.md): Krankenhaus-Stammdaten je Stadt (Destatis-Verzeichnis, Tier A)
- [GET /api/v1/cities/{slug}/holidays](https://infranode.dev/api/getCityHolidays.md): Feiertage und Schulferien je Stadt (Seed, gemeinfrei)
- [GET /api/v1/cities/{slug}/icu-live](https://infranode.dev/api/getCityIcuLive.md): Intensivbetten-Belegung live je Stadt (DIVI, Tier C)
- [GET /api/v1/cities/{slug}/pois](https://infranode.dev/api/getCityPois.md): POIs je Stadt, nach Typ gefiltert (OSM/Overpass, Tier B)
- [GET /api/v1/cities/{slug}/pollen-uv](https://infranode.dev/api/getCityPollenUv.md): Pollenflug und UV-Index je Stadt (DWD opendata, Tier A)
- [GET /api/v1/cities/{slug}/road-events](https://infranode.dev/api/getCityRoadEvents.md): Innerstädtische Baustellen und Sperrungen je Stadt (Tier A)
- [GET /api/v1/cities/{slug}/traffic](https://infranode.dev/api/getCityTraffic.md): Baustellen und Verkehrsmeldungen je Stadt (Autobahn-API)
- [GET /api/v1/cities/{slug}/transit](https://infranode.dev/api/getCityTransit.md): ÖPNV-Haltestellen je Stadt (DELFI und HVV GTFS)
- [GET /api/v1/cities/{slug}/water-level](https://infranode.dev/api/getCityWaterLevel.md): Pegelstand je Stadt (PEGELONLINE, Tier A, Teilabdeckung)
- [GET /api/v1/cities/{slug}/weather](https://infranode.dev/api/getCityWeather.md): Wetter je Stadt (DWD über Bright Sky)
- [GET /api/v1/cities/{slug}/webcams](https://infranode.dev/api/getCityWebcams.md): Autobahn-Webcams je Stadt (Autobahn-API, Tier A)

## compare

- [GET /api/v1/compare](https://infranode.dev/api/compareCities.md): Eine Ressource über mehrere Städte vergleichen

## keys

- [POST /api/v1/keys](https://infranode.dev/api/mintKey.md): Eigenen API-Key selbst erzeugen

## meta

- [GET /api/v1/_boom](https://infranode.dev/api/getBoom.md): Erzwungener Upstream-Fehler (Demo)
- [GET /api/v1/echo](https://infranode.dev/api/getEcho.md): Integer-Query zurückgeben (Validierungs-Demo)
- [GET /api/v1/health](https://infranode.dev/api/getHealth.md): Liveness und Readiness der App prüfen
- [GET /api/v1/openapi.yaml](https://infranode.dev/api/getOpenapiYaml.md): Diese OpenAPI-Spec als YAML
- [GET /api/v1/ping](https://infranode.dev/api/getPing.md): Einfacher Ping mit Correlation-ID
- [GET /api/v1/sources](https://infranode.dev/api/getSources.md): Status aller Upstream-Quellen