API-Dokumentation
Programmgesteuerter Zugriff auf alle Baustellen-, Wetter-, Warnungs- und Bauwerks-Daten. REST-API mit JSON-Antworten und direktem Excel-Download – inklusive historisches Archiv.
https://www.autobahn-baustellen.de/wp-json/autobahn/v11. Authentifizierung
Alle Endpunkte erfordern einen API-Token. Diesen finden Sie nach dem Login in Ihrem Kundenbereich. Dort können Sie den Token bei Bedarf auch selbst neu generieren.
Variante 1: Authorization-Header (empfohlen)
curl -H "Authorization: Bearer IHR_TOKEN" \
https://www.autobahn-baustellen.de/wp-json/autobahn/v1/files
Variante 2: Query-Parameter
curl "https://www.autobahn-baustellen.de/wp-json/autobahn/v1/files?token=IHR_TOKEN"
2. Excel-Datenstruktur Baustellen (29 Spalten)
Die Datei alle-baustellen.xlsx enthält folgende Spalten:
| # | Spalte | Beispiel | Beschreibung |
|---|---|---|---|
| 1 | Autobahn | A1 | Autobahnnummer |
| 2 | Erfasst am | 2026-05-15 06:52 | Erstmals in unserer DB gesehen |
| 3 | Titel | Saarbrücken – Illingen | Bezeichnung der Baustelle |
| 4–7 | Abschnitt, Start, Ende, Ende Gesamt | 15.05.26 – 09.10.26 | Strecke und Zeitraum |
| 8 | Gesperrt | Ja / Nein | Vollsperrung aktiv? |
| 9 | Koordinaten | 49.3608, 7.0147 | Geo-Koordinaten (lat, lon) |
| 10 | Bundesland NEU | Saarland | Aus Koordinaten ermittelt – ideal für Filter |
| 11 | Länge (km) NEU | 2.1 | Streckenlänge der Baustelle |
| 12 | Max Breite (m) NEU | 3.5 | Maximale Durchfahrtsbreite – wichtig für LKW |
| 13 | Max Höhe (m) NEU | 4.1 | Durchfahrtshöhe (bei Tunnel-/Brückenbaustellen) |
| 14 | Max km/h NEU | 80 | Geschwindigkeitsbegrenzung im Baustellenbereich |
| 15 | Sub-Phasen NEU | 4 | Anzahl zusammengefasster Bauphasen |
| 16–19 | Noch aktiv, Letzter Nachweis, Dauer, Beschreibung | Ja | Status und Rohbeschreibung |
| 20–25 | Wetter, Temp Min/Max, Niederschlag, DWD-Station, Distanz NEU | Regen, 6.1°/14.5° | DWD-Wetterprognose pro Baustelle |
| 26–29 | Wetterwarnung, Warnung Stufe, Beginn, Ende NEU | BÖEN – Wetterwarnung | Aktive DWD-Warnungen pro Bundesland |
3. Excel-Datenstruktur Tunnel & Brücken NEU
Die Datei tunnel-bruecken.xlsx enthält alle Tunnel und Brücken auf Autobahnen – automatisch aus OpenStreetMap, stündlich aktualisiert.
| # | Spalte | Beispiel | Beschreibung |
|---|---|---|---|
| 1 | Typ | Tunnel / Brücke | Art des Bauwerks |
| 2 | Name | Elbtunnel | Name des Bauwerks |
| 3 | Autobahn | A7 | Autobahnnummer |
| 4 | Bundesland | Hamburg | Bundesland des Bauwerks |
| 5 | Länge (m) | 3325 | Länge des Bauwerks in Metern (aus Wikidata) |
| 6 | Max Höhe (m) | 4.20 | Maximale Durchfahrtshöhe – kritisch für Hochladungen |
| 7 | Max Breite (m) | 7.50 | Maximale Durchfahrtsbreite – kritisch für Schwertransporte |
| 8 | Max Gewicht (t) | 44 | Maximales zulässiges Gewicht |
| 9 | Baujahr | 1975 | Baujahr (aus Wikidata, soweit verfügbar) |
| 10 | Breitengrad / Längengrad | 53.5301, 9.9424 | GPS-Koordinaten des Bauwerks |
| 11 | OSM Link | openstreetmap.org/… | Direktlink zur Karte – klickbar in Excel |
| 12 | Status | aktiv / inaktiv | Aktiv in OSM oder historisch archiviert |
| 13 | Inaktiv seit | 01.06.2026 | Datum seit dem das Bauwerk nicht mehr in OSM vorkommt |
| 14 | OSM ID | 680 | OpenStreetMap Way-ID für eigene Abfragen |
4. Endpunkte
/verify
Token prüfen und Kunden-Info abrufen
Prüft den Token und gibt Kunden-Informationen zurück. Nützlich für Verbindungstests.
{
"valid": true,
"customer": {
"email": "sie@ihrefirma.de",
"company": "Ihre Firma GmbH"
}
}
/files
Liste verfügbarer Dateien
Liefert alle verfügbaren Excel-Dateien mit Metadaten (Größe, Zeitstempel, Download-URL).
/download/{key}
Excel-Datei herunterladen
Lädt eine Excel-Datei (.xlsx) herunter. Response ist die Binärdatei.
| key | Datei | Inhalt |
|---|---|---|
| baustellen | alle-baustellen.xlsx | Alle Baustellen mit Wetter & Warnungen |
| wochen | wochenuebersicht.xlsx | Wochenstatistik pro Autobahn |
| warnungen | warnmeldungen.xlsx | Unfälle, Sperrungen, Einsätze |
| bauwerke NEU | tunnel-bruecken.xlsx | Tunnel & Brücken mit Beschränkungen & Koordinaten |
Optionaler Query-Parameter: ?date=YYYY-MM-DD – liefert historische Daten (nur baustellen und warnungen)
# Aktuelle Baustellen curl -H "Authorization: Bearer IHR_TOKEN" \ -o baustellen.xlsx \ https://www.autobahn-baustellen.de/wp-json/autobahn/v1/download/baustellen # Tunnel & Brücken (NEU) curl -H "Authorization: Bearer IHR_TOKEN" \ -o tunnel-bruecken.xlsx \ https://www.autobahn-baustellen.de/wp-json/autobahn/v1/download/bauwerke # Historische Baustellen vom 15.05.2026 curl -H "Authorization: Bearer IHR_TOKEN" \ -o baustellen-2026-05-15.xlsx \ "https://www.autobahn-baustellen.de/wp-json/autobahn/v1/download/baustellen?date=2026-05-15"
/archive-dates
Verfügbare Archiv-Tage
Liefert alle Tage für die archivierte Daten verfügbar sind – inkl. Indikator ob Wetterdaten vorhanden sind.
{
"count": 4,
"dates": [
{
"date": "2026-05-19",
"has_weather": true,
"download_url": "…/download/baustellen?date=2026-05-19"
}
]
}
5. Code-Beispiele
Python (pandas)
import requests
import pandas as pd
TOKEN = "IHR_TOKEN_HIER"
BASE = "https://www.autobahn-baustellen.de/wp-json/autobahn/v1"
headers = {"Authorization": f"Bearer {TOKEN}"}
# Aktuelle Baustellen
df = pd.read_excel(f"{BASE}/download/baustellen",
storage_options={"headers": headers})
# Hochrisiko: Vollsperrung + Wetterwarnung
risiko = df[(df["Gesperrt"] == "Ja") & df["Wetterwarnung"].notna()]
print(f"Hochrisiko heute: {len(risiko)}")
# LKW-kritische Engstellen
eng = df[df["Max Breite (m)"] < 3.5]
# Tunnel & Brücken (NEU)
bauwerke = pd.read_excel(f"{BASE}/download/bauwerke",
storage_options={"headers": headers})
# Höhenbeschränkungen unter 4.2m
kritisch = bauwerke[bauwerke["Max Höhe (m)"].notna() &
(bauwerke["Max Höhe (m)"] < 4.2)]
print(f"Kritische Höhenbeschränkungen: {len(kritisch)}")
# Historische Daten
df_alt = pd.read_excel(f"{BASE}/download/baustellen?date=2026-05-15",
storage_options={"headers": headers})
cURL (Bash)
#!/bin/bash
TOKEN="IHR_TOKEN_HIER"
BASE="https://www.autobahn-baustellen.de/wp-json/autobahn/v1"
# Aktuelle Baustellen
curl -H "Authorization: Bearer $TOKEN" \
-o "baustellen-$(date +%Y-%m-%d).xlsx" \
"$BASE/download/baustellen"
# Tunnel & Brücken (NEU)
curl -H "Authorization: Bearer $TOKEN" \
-o "tunnel-bruecken.xlsx" \
"$BASE/download/bauwerke"
# Historische Datei
curl -H "Authorization: Bearer $TOKEN" \
-o "baustellen-2026-05-15.xlsx" \
"$BASE/download/baustellen?date=2026-05-15"
PHP
<?php
$token = 'IHR_TOKEN_HIER';
$base = 'https://www.autobahn-baustellen.de/wp-json/autobahn/v1';
$ctx = stream_context_create(['http' => ['header' => 'Authorization: Bearer ' . $token]]);
// Aktuelle Baustellen
file_put_contents('baustellen.xlsx',
file_get_contents("{$base}/download/baustellen", false, $ctx));
// Tunnel & Brücken (NEU)
file_put_contents('tunnel-bruecken.xlsx',
file_get_contents("{$base}/download/bauwerke", false, $ctx));
// Archiv-Tage
$archive = json_decode(file_get_contents("{$base}/archive-dates", false, $ctx), true);
echo "Verfügbare Archiv-Tage: " . $archive['count'];
Power BI / Excel Power Query
let
Token = "IHR_TOKEN_HIER",
// Baustellen
UrlBaustellen = "https://www.autobahn-baustellen.de/wp-json/autobahn/v1/download/baustellen",
Baustellen = Table.PromoteHeaders(
Excel.Workbook(Web.Contents(UrlBaustellen,
[Headers = [#"Authorization" = "Bearer " & Token]])
){[Name="Baustellen"]}[Data], [PromoteAllScalars=true]),
// Tunnel & Brücken (NEU)
UrlBauwerke = "https://www.autobahn-baustellen.de/wp-json/autobahn/v1/download/bauwerke",
Bauwerke = Table.PromoteHeaders(
Excel.Workbook(Web.Contents(UrlBauwerke,
[Headers = [#"Authorization" = "Bearer " & Token]])
){[Name="Tunnel & Brücken"]}[Data], [PromoteAllScalars=true])
in
Baustellen // oder Bauwerke
Node.js
const axios = require('axios');
const XLSX = require('xlsx');
const fs = require('fs');
const TOKEN = 'IHR_TOKEN_HIER';
const BASE = 'https://www.autobahn-baustellen.de/wp-json/autobahn/v1';
const headers = { Authorization: `Bearer ${TOKEN}` };
(async () => {
// Baustellen
const b = await axios.get(`${BASE}/download/baustellen`,
{ headers, responseType: 'arraybuffer' });
fs.writeFileSync('baustellen.xlsx', b.data);
// Tunnel & Brücken (NEU)
const bw = await axios.get(`${BASE}/download/bauwerke`,
{ headers, responseType: 'arraybuffer' });
const wb = XLSX.read(bw.data);
const bauwerke = XLSX.utils.sheet_to_json(wb.Sheets[wb.SheetNames[0]]);
// Höhenbeschränkungen unter 4.2m
const kritisch = bauwerke.filter(r =>
r['Max Höhe (m)'] && r['Max Höhe (m)'] < 4.2);
console.log(`Kritische Höhenbeschränkungen: ${kritisch.length}`);
})();
6. Fehlerbehandlung
| HTTP-Status | Bedeutung | Lösung |
|---|---|---|
| 200 | OK | – |
| 400 | Ungültiger Request | Datum-Format prüfen: YYYY-MM-DD |
| 401 | Token fehlt oder ungültig | Token im Kundenbereich prüfen oder neu generieren |
| 403 | Account inaktiv | Im Kundenbereich Status prüfen |
| 404 | Datei nicht verfügbar | /archive-dates für verfügbare Tage prüfen |
| 429 | Zu viele Anfragen | Rate-Limits beachten |
| 503 | Service nicht verfügbar | Später erneut versuchen |
{
"code": "autobahn_invalid_token",
"message": "Ungültiger API-Token",
"data": { "status": 401 }
}
7. Rate-Limits
Aktuell gilt eine faire Nutzung: maximal 1 Abruf pro Datensatz pro Stunde, maximal 100 Abrufe pro Tag. Höhere Frequenzen auf Anfrage: info@autobahn-baustellen.de
- Baustellen + Wetter: täglich um 03:00 Uhr
- Wetterwarnungen: stündlich
- Tunnel & Brücken: stündlich (OSM-Sync)
Use Cases
Vollsperrungen, Wetterwarnungen und Breiten-/Höhenbeschränkungen kombiniert auswerten – vor der Schicht.
Tunnel & Brücken mit Max Höhe < 4.2 oder Max Breite < 3.5 filtern – Ihre kritischen Punkte auf einen Blick.
Vollsperrung + Sturmwarnung kombiniert sehen. Mit der Wetterwarnungs-Spalte in 5 Sekunden filtern.
Historische Daten: Welche Baustelle war am Schadenstag aktiv? Welche Wetterlage herrschte?
Täglicher Cron-Job lädt Baustellen und Bauwerke automatisch in Ihr System.
Power BI / Python direkt auf die API – Wochenübersicht für Management-Reports.
Support
Fragen zur API, Wünsche für neue Endpunkte oder Probleme bei der Integration: info@autobahn-baustellen.de – Antwort normalerweise innerhalb von 24 Stunden an Werktagen.


