Integrationen

Wie externe Systeme über die öffentliche Schnittstelle und das Webhook-System an decidio anschließen.

Überblick

Eine Gemeinde betreibt selten nur ein System. decidio bietet deshalb zwei Wege für die Anbindung an Drittsoftware: eine öffentliche Schnittstelle für lesende und schreibende Zugriffe sowie ein Webhook-System, das Ereignisse an externe Systeme weiterleitet.

Diese Seite beschreibt die Möglichkeiten auf Konzept-Ebene. Eine ausführliche Referenz mit allen Endpunkten, Datenformaten und Sicherheits-Details folgt in einem späteren Abschnitt — siehe Wie es weitergeht.

Funktionsweise

Die öffentliche Schnittstelle ermöglicht den lesenden und — abhängig von der Berechtigung — schreibenden Zugriff auf Bürgereingaben und ausgewählte Stammdaten. Jede Gemeinde verwaltet die eigenen API-Schlüssel selbst und kann sie gezielt vergeben und widerrufen.

Das Webhook-System informiert externe Systeme, sobald in decidio ein Ereignis eintritt — etwa der Statuswechsel einer Bürgereingabe. Die Empfänger lassen sich pro Gemeinde verwalten; Wiederholungen bei Übertragungsfehlern und ein Schutzmechanismus für die Authentizität der Nachrichten sind integriert.

Beide Wege sind so angelegt, dass eine Fachsoftware der Gemeinde — etwa die bestehende Ratsinformationssoftware oder das Beschwerdemanagement — Eingaben übernehmen und Statuswechsel synchron halten kann.

Häufige Aufgaben

Einen API-Schlüssel erzeugen

In den Einstellungen den Bereich „Integrationen“ öffnen.
Einen neuen Schlüssel anlegen und einen sprechenden Namen vergeben.
Den Schlüssel an die berechtigte Stelle übergeben — er ist nur einmal sichtbar und kann anschließend gezielt eingesetzt werden.

Ein Webhook-Ziel hinterlegen

Im Bereich „Integrationen“ ein neues Webhook-Ziel anlegen.
Die Ereignisse auswählen, die übertragen werden sollen.
Die Empfängeradresse und die Signatur-Einstellungen für das Drittsystem vorbereiten — die Details folgen in der Referenz.

Eine bestehende Anbindung prüfen

In der Übersicht „Integrationen“ den Status der Schlüssel und Webhooks einsehen. Fehler bei der Zustellung werden mit einem Hinweis versehen, damit das betroffene Drittsystem gezielt angesprochen werden kann.