Schnittstellen des Sammlerdienstes

Der Sammlerdienst ist für das Einsammeln und Validieren der Exporte der Redaktionssysteme von Bund und Ländern zuständig. Die Exporte der Gesamtdatenbestände der Redaktionssysteme werden dabei durch den Sammlerdienst per Pull-Verfahren aus den Redaktionssystemen abgerufen.

Seit August 2024 steht eine REST-Schnittstelle zur Verfügung, über die die Redaktionssysteme einzelne Änderungen per Push-Verfahren an den Sammlerdienst übermitteln können.

Finden Sie unter folgendem Link Informationen zur Push-Schnittstelle

Bitte beachten: Der Zugriff auf die Push-Schnittstelle erfordert eine Autorisierung gegenüber der Benutzerverwaltung des PVOG. Wenn Sie ebenfalls Ihre Daten über die Push-Schnittstelle an das PVOG übermitteln möchten, kontaktieren Sie bitte den PVOG Support.

Versionierung der Schnittstelle

Um bestmögliche Kompatibilität zu gewährleisten, ist im Sammlerdienst eine Schnittstellenversionierung umgesetzt, sodass externe Konsumenten in einem selbstbestimmten Tempo auf die neuen Schnittstellenversionen migrieren können. Hierfür wird die Versionsnummer des Pfades inkrementell erhöht, die vorherige Schnittstelle als deprecated deklariert und die Dokumentation der Schnittstelle entsprechend angepasst. Die Versionierung erfolgt über eine Versions-Komponente (z.B. v1, v2, …) des Pfads einer jeden externen Schnittstelle.

Neue Schnittstellenversionen können jederzeit mit einem PVOG-Release veröffentlicht werden. Die alten, als deprecated markierten Schnittstellen bleiben für die Übergangszeit bestehen, während parallel die neuen Schnittstellen in allen Umgebungen bereitstehen, um die Anpassung der Anbindung auf Konsumentenseite nach deren Tempo zu ermöglichen. Die Schnittstellen, die als deprecated markiert sind, werden nach einer Übergangszeit von min. drei Monaten entweder zum 01.02., 01.05., 01.08. oder 01.11. dauerhaft deaktiviert und sind somit nicht mehr nutzbar.

Weitere Informationen zu Deprecations