Zum Hauptinhalt springen

API-Dokumentation

Programmgesteuerter Zugriff auf alle Baustellen-, Wetter-, Warnungs- und Bauwerks-Daten. REST-API mit JSON-Antworten und direktem Excel-Download – inklusive historisches Archiv.

Basis-URL: https://www.autobahn-baustellen.de/wp-json/autobahn/v1
Authentifizierung: Bearer-Token (im Kundenbereich verfügbar)
Format: Excel (.xlsx) und JSON

1. 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"
⚠️ Sicherheitshinweis: Geben Sie Ihren Token nie weiter und committen Sie ihn nicht in öffentlichen Git-Repositories. Bei Verlust können Sie ihn im Kundenbereich neu generieren – der alte Token wird sofort ungültig.

2. Excel-Datenstruktur Baustellen (29 Spalten)

Die Datei alle-baustellen.xlsx enthält folgende Spalten:

# Spalte Beispiel Beschreibung
1AutobahnA1Autobahnnummer
2Erfasst am2026-05-15 06:52Erstmals in unserer DB gesehen
3TitelSaarbrücken – IllingenBezeichnung der Baustelle
4–7Abschnitt, Start, Ende, Ende Gesamt15.05.26 – 09.10.26Strecke und Zeitraum
8GesperrtJa / NeinVollsperrung aktiv?
9Koordinaten49.3608, 7.0147Geo-Koordinaten (lat, lon)
10Bundesland NEUSaarlandAus Koordinaten ermittelt – ideal für Filter
11Länge (km) NEU2.1Streckenlänge der Baustelle
12Max Breite (m) NEU3.5Maximale Durchfahrtsbreite – wichtig für LKW
13Max Höhe (m) NEU4.1Durchfahrtshöhe (bei Tunnel-/Brückenbaustellen)
14Max km/h NEU80Geschwindigkeitsbegrenzung im Baustellenbereich
15Sub-Phasen NEU4Anzahl zusammengefasster Bauphasen
16–19Noch aktiv, Letzter Nachweis, Dauer, BeschreibungJaStatus und Rohbeschreibung
20–25Wetter, Temp Min/Max, Niederschlag, DWD-Station, Distanz NEURegen, 6.1°/14.5°DWD-Wetterprognose pro Baustelle
26–29Wetterwarnung, Warnung Stufe, Beginn, Ende NEUBÖEN – WetterwarnungAktive DWD-Warnungen pro Bundesland
Hinweis zu Wetter- und Warnungsspalten: Wetter-Spalten erscheinen nur in archivierten Dateien ab dem 18.05.2026. Warnungs-Spalten erscheinen nur in der aktuellen Datei (nicht im Archiv). Seewetter-Warnungen werden automatisch ausgefiltert.

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
1TypTunnel / BrückeArt des Bauwerks
2NameElbtunnelName des Bauwerks
3AutobahnA7Autobahnnummer
4BundeslandHamburgBundesland des Bauwerks
5Länge (m)3325Länge des Bauwerks in Metern (aus Wikidata)
6Max Höhe (m)4.20Maximale Durchfahrtshöhe – kritisch für Hochladungen
7Max Breite (m)7.50Maximale Durchfahrtsbreite – kritisch für Schwertransporte
8Max Gewicht (t)44Maximales zulässiges Gewicht
9Baujahr1975Baujahr (aus Wikidata, soweit verfügbar)
10Breitengrad / Längengrad53.5301, 9.9424GPS-Koordinaten des Bauwerks
11OSM Linkopenstreetmap.org/…Direktlink zur Karte – klickbar in Excel
12Statusaktiv / inaktivAktiv in OSM oder historisch archiviert
13Inaktiv seit01.06.2026Datum seit dem das Bauwerk nicht mehr in OSM vorkommt
14OSM ID680OpenStreetMap Way-ID für eigene Abfragen
📍 Kilometerstand: Exakte Autobahnkilometerstände sind nicht öffentlich verfügbar (interne Datenbank der Autobahn GmbH). Der OSM-Link zeigt die GPS-Position des Bauwerks – die nächste Anschlussstelle ist dort direkt ablesbar. Koordinaten können für eigene Streckenberechnungen genutzt werden.

4. Endpunkte

GET /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"
  }
}
GET /files Liste verfügbarer Dateien

Liefert alle verfügbaren Excel-Dateien mit Metadaten (Größe, Zeitstempel, Download-URL).

GET /download/{key} Excel-Datei herunterladen

Lädt eine Excel-Datei (.xlsx) herunter. Response ist die Binärdatei.

keyDateiInhalt
baustellenalle-baustellen.xlsxAlle Baustellen mit Wetter & Warnungen
wochenwochenuebersicht.xlsxWochenstatistik pro Autobahn
warnungenwarnmeldungen.xlsxUnfälle, Sperrungen, Einsätze
bauwerke NEUtunnel-bruecken.xlsxTunnel & 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"
GET /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
200OK
400Ungültiger RequestDatum-Format prüfen: YYYY-MM-DD
401Token fehlt oder ungültigToken im Kundenbereich prüfen oder neu generieren
403Account inaktivIm Kundenbereich Status prüfen
404Datei nicht verfügbar/archive-dates für verfügbare Tage prüfen
429Zu viele AnfragenRate-Limits beachten
503Service nicht verfügbarSpä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

Update-Zyklen:
  • Baustellen + Wetter: täglich um 03:00 Uhr
  • Wetterwarnungen: stündlich
  • Tunnel & Brücken: stündlich (OSM-Sync)

Use Cases

🚛 Tourenplanung

Vollsperrungen, Wetterwarnungen und Breiten-/Höhenbeschränkungen kombiniert auswerten – vor der Schicht.

📐 Schwertransport-Disposition

Tunnel & Brücken mit Max Höhe < 4.2 oder Max Breite < 3.5 filtern – Ihre kritischen Punkte auf einen Blick.

🌪️ Risikomanagement

Vollsperrung + Sturmwarnung kombiniert sehen. Mit der Wetterwarnungs-Spalte in 5 Sekunden filtern.

🛡️ Versicherung & Schadensanalyse

Historische Daten: Welche Baustelle war am Schadenstag aktiv? Welche Wetterlage herrschte?

🔌 TMS-Integration

Täglicher Cron-Job lädt Baustellen und Bauwerke automatisch in Ihr System.

📊 BI & Reporting

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.