Änderungsprotokoll

Die API ist über den Pfad versioniert (/v1/…). Innerhalb von v1 kommen nur rückwärtskompatible Änderungen hinzu, z. B. neue optionale Felder in Anfragen oder neue Felder in Antworten. Clients sollten unbekannte Felder ignorieren. Inkompatible Änderungen erscheinen unter einer neuen Version (/v2/…); v1 bleibt dann eine angekündigte Übergangszeit lang erhalten.

1.0.0 – in Vorbereitung

Erste Version.

• Adressvorschläge GET /v1/address/suggest und Geocoding POST /v1/address/geocode (nur geheimer Key)
• Reisezeiten POST /v1/travel-times mit PKW, ÖPNV, Fahrrad, E-Bike und zu Fuß, bis zu 100 Ziele, Sortierung, Filter maxDurationMinutes und limit, ÖPNV-Ankunftsfenster je Anfrage und je Ziel
• Erreichbare Flächen POST /v1/isochrones (GeoJSON, bis zu 3 Zeitstufen, nur geheimer Key) – ergänzt 20.10.2026; die Flächen enden an der Bundesgrenze (ebenfalls 20.10.2026)
• Status GET /v1/health
• Geheime und öffentliche Keys mit IP- bzw. Domainbindung, Rate-Limits, Fehler nach RFC 9457