Um die Stabilität von Integrationen zu gewährleisten, werden veraltete Endpunkte (Deprecations) vor ihrer endgültigen Entfernung markiert. Das gibt Entwicklungsteams die Möglichkeit, Anpassungen an Bestandssystemen planbar vorzunehmen.
Sämtliche Abschaltungen folgen einem festen vierteljährlichen Release-Rhythmus. Die reguläre Entfernung von Endpunkten erfolgt ausschließlich in den Monaten Februar, Mai, August oder November.
Regelmäßige Informationen zur Abschaltung von Endpunkten finden Sie unter Deprecations | PVOG Produktportal.
Seit dem Release 8.1.1 signalisieren die Dienste den Status eines Endpunkts direkt in der Laufzeitumgebung. Jede Antwort eines als veraltet markierten Endpunkts enthält den folgenden HTTP-Header:
Dieser Header dient als technischer Indikator in automatisierten Log-Analysen oder Monitoring-Systemen, um die Nutzung veralteter Schnittstellen im eigenen Code-Bestand zu identifizieren.
Betroffene Endpunkte (Stand: Mai 2026)
Mit dem Release 9.17.4 (Mai 2026) wurden mehrere Endpunkte des Suchdienstes und des Bereitstelldienstes offiziell als deprecated markiert. Die Entfernung dieser Endpunkte aus der Produktionsumgebung ist für November 2026 terminiert.
1. Suchdienst
Die folgenden Endpunkte werden im November 2026 abgeschaltet:
Veralteter Endpunkt Deprecation seit Produktive Abschaltung Aktueller Nachfolger / Migrationspfad
────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────
/v2/locations/suggestions Mai 2026 (9.17.4) November 2026 /v3/locations/suggestions
/v2/locations Mai 2026 (9.17.4) November 2026 /v3/locations
/v2/organisationunits/jzufi Mai 2026 (9.17.4) November 2026 /v1/organisationunits/{id}/jzufi-2-3
/v3/relations/{ars}/jzufi Mai 2026 (9.17.4) November 2026 /v1/relations/jzufi-2-3
/v3/servicedescriptions/jzufi Mai 2026 (9.17.4) November 2026 /v1/servicedescriptions/{id}/jzufi-2-3
/v5/servicedescriptions/{ars}/detail Mai 2026 (9.17.4) November 2026 /v6/servicedescriptions/...
2. Bereitstelldienst
Im Bereitstelldienst wurde mit dem Release 9.17.6 parallel ein neuer Endpunkt eingeführt, der den alten V2-Pfad ersetzt.
Bis zur endgültigen Abschaltung im November 2026 liefert der alte V2-Endpunkt ausschließlich Daten im Format XZuFi 2.3.1 aus und erfordert die explizite Übergabe der Version im Request-Header.
Veralteter Endpunkt Deprecation seit Produktive Abschaltung Aktueller Nachfolger / Migrationspfad
──────────────────────────────────────────────────────────────────────────────────────────────────────────
/v2/verwaltungsobjekte Mai 2026 (9.17.4) November 2026 /v3/verwaltungsobjekte/xzufi-2-3-1
Neuer dedizierter Bereitstelldienst-Endpunkt für den Gesamtabruf im Format XZuFi 2.3.1 (siehe aktuelle OpenAPI-Spezifikation im Portal).
Weitere Dienste
Für den Sammlerdienst und den Validator liegen mit dem aktuellen Release keine Deprecations vor. Die bestehenden Endpunkte dieser Dienste bleiben unverändert operativ.