API-Umstellung: der Ort verlässt die Adresse

Veraltet seit 11. September 2026. Abschaltung am 1. April 2027, 00:00 UTC.

Die bisherigen GET-Endpunkte, bei denen der Ort Bestandteil der URL ist, sind seit dem 11. September 2026 veraltet. Sie werden für eine Übergangsphase weiter unterstützt und am 1. April 2027 endgültig abgeschaltet. Danach antworten sie mit 410 Gone.

Warum. Eine Adresse landet in Zugriffsprotokollen, in Browser- und Proxy-Verläufen und in den Protokollen jedes zwischengeschalteten Netzes. Steht der Ort darin, steht er dort auch dann, wenn ihn niemand auswerten will. Die neuen Endpunkte übertragen ihn im Rumpf der Anfrage; Rumpfdaten werden nicht protokolliert.

Was wodurch ersetzt wird

Veraltet	Ersatz
`GET /v1/forecast?lat=…&lon=…`	`POST /v1/forecast`
`GET /v1/nowcast?lat=…&lon=…`	`POST /v1/nowcast`
`GET /v1/radar/runs?lat=…&lon=…`	`POST /v1/radar/runs`
`GET /v1/radar/runs` ohne Ort	bleibt bestehen

Der Weg ohne Ort bleibt. Bei /v1/radar/runs sind die Koordinaten freiwillig und dienen allein der Quellenangabe. Nur ihre Verwendung wird abgekündigt, nicht die Route: Wer sie weglässt, bekommt weiterhin eine gültige Antwort.

Kopfzeilen während der Übergangszeit

Die veralteten Aufrufe antworten mit den Kopfzeilen nach RFC 8594 und dem Deprecation-Header-Entwurf der IETF:

Deprecation: @1789084800
Sunset: Thu, 01 Apr 2027 00:00:00 GMT
Link: <https://www.pfotenwetter.app/api-migration>; rel="deprecation"

@1789084800 ist der 11. September 2026, 00:00 UTC — derselbe Tag, den die Beschreibung der Endpunkte nennt. Bei /v1/radar/runs erscheinen die Kopfzeilen nur, wenn tatsächlich Koordinaten übergeben wurden.

Was sich am Inhalt ändert

Nichts. Die neuen Endpunkte liefern dieselben Antworten wie die alten; verschoben wird allein der Ort — aus der Adresse in den Rumpf. Die Felder heißen weiterhin lat und lon, in Grad nach WGS84.

Die vollständige Schnittstellenbeschreibung steht in der OpenAPI-Datei unter /openapi.json.