OParl-Schnittstelle: Ratsdaten maschinenlesbar.
mandari stellt öffentliche Sitzungen, Vorlagen, Beschlüsse und Dokumente nach dem offenen Standard OParl 1.1 bereit: lesend, ohne Anmeldung und für jede Anwendung.
Was ist OParl?
OParl ist der offene Standard für die Schnittstelle von Ratsinformationssystemen. Er legt fest, wie Sitzungen, Vorlagen, Beschlüsse, Gremien, Personen und Dokumente maschinenlesbar bereitstehen, unabhängig vom Hersteller.
Offene Daten statt PDF-Stapel. Presse, Wissenschaft, Zivilgesellschaft und andere Anwendungen lesen Ratsdaten direkt aus, statt sie von Webseiten abzuschreiben.
Ein Weg für viele Systeme. Wer OParl liest, liest jedes Ratsinformationssystem, das den Standard spricht, nach denselben Regeln, ob ALLRIS, SessionNet von Somacos oder SD.NET RIM. Abweichungen einzelner Server gleicht mandari beim Einlesen aus.
Unabhängig vom Anbieter. Öffentliche Ratsdaten liegen in einem offenen Format, das jede Anwendung lesen kann. Aus mandari Session exportieren Sie Beschlüsse, Berichte und Sitzungsgeld zusätzlich als CSV und JSON.
Was die Schnittstelle liefert
Für Entwickler:innen, Open-Data-Verantwortliche und IT-Leitungen: was die Schnittstelle heute leistet und was folgt.
6 von 8 sind heute verfügbar, 2 folgen.
Alle Endpunkte, Felder und Beispiele stehen in der API-Dokumentation, der Quellcode auf GitHub.
| Was | Wie es funktioniert | Stand |
|---|---|---|
| Zwei Ausgaben | ||
| Über alle KommunenDokumentation | Ein Endpunkt für die öffentlichen Ratsdaten aller Kommunen im Bürgerportal, statt jede Kommune einzeln abzufragen. |
Verfügbar |
| Je Kommune in mandari SessionDokumentation | Jede Kommune, die ihr Sitzungsmanagement in mandari Session führt, hat eine eigene Schnittstelle, sobald die Verwaltung sie freigibt. Sie gibt nur aus, was als öffentlich gekennzeichnet ist; die Lizenz der Daten wählt die Kommune. |
Pilotphase |
| Für Abnehmer | ||
| Abgleich seit dem letzten Abruf | Zeitfilter wie modified_since liefern nur, was sich geändert hat. Gelöschte Objekte bleiben als Tombstone abrufbar, damit Kopien sie entfernen. |
Verfügbar |
| Bedingte Anfragen | Jede erfolgreiche Antwort trägt einen ETag; unveränderte Seiten kommen als 304 ohne Inhalt zurück. |
Verfügbar |
| Dokumente | Bereits abgerufene Dateien bleiben über stabile Adressen erreichbar, auch wenn der Server der Kommune gerade nicht erreichbar ist. |
Verfügbar |
| Einlesen und offene Daten | ||
| Einlesen aus dem bisherigen RIS | Den öffentlichen Bestand liest mandari aus Systemen mit OParl 1.0 oder 1.1 ein: Sitzungen, Tagesordnungen, Vorlagen mit Beratungsfolge, Gremien, Personen, Mitgliedschaften und Dokumente. Er bleibt im Bürgerportal durchsuchbar. |
Verfügbar |
| Übernahme in mandari Session | Gremien, Personen und Besetzungen übernehmen wir aus Listen Ihrer Verwaltung. Die Übernahme des öffentlichen Altbestands über OParl folgt. |
Geplant für 1.0 |
| Open-Data-Portale | Ein Katalog je Kommune nach DCAT-AP.de verweist auf die Schnittstelle; Landesportale und GovData können ihn einsammeln. Er ist in der Installation einschaltbar, die Anbindung an die Portale folgt. |
Geplant 2027 |
So kommt Ihr Bestand ins Bürgerportal
Spricht Ihr Ratsinformationssystem OParl, ist die Anbindung kurz: drei Schritte bis zum Produktivbetrieb.
-
1
Endpunkt nennen
Sie nennen uns die Adresse der OParl-Schnittstelle Ihres bisherigen Systems.
-
2
Testabgleich
Wir lesen Ihren öffentlichen Bestand zur Probe ein und klären offene Punkte.
-
3
Produktivbetrieb
Ihre Ratsdaten erscheinen im Bürgerportal und stehen über die Schnittstelle bereit.
typisch 1 bis 2 Wochen
-
Umstieg auf mandari Session
Soll mandari Session Ihr bisheriges System ablösen, übernehmen wir Gremien, Personen und Besetzungen aus Listen Ihrer Verwaltung; Ihr öffentlicher Altbestand bleibt im Bürgerportal durchsuchbar.
Ohne OParl-Schnittstelle klären wir die Anbindung gemeinsam, gegebenenfalls mit einem eigenen Adapter: Zwei Wege zur Anbindung.
Häufige Fragen zur OParl-Schnittstelle
Steht Ihre Frage nicht dabei? Schreiben Sie uns.
OParl ist der offene Standard für die Schnittstelle von Ratsinformationssystemen. Er beschreibt, wie Sitzungen, Vorlagen, Beschlüsse, Gremien, Personen und Dokumente maschinenlesbar bereitstehen, unabhängig vom Hersteller.
mandari gibt alle Daten nach OParl 1.1 aus. Einlesen kann mandari Systeme mit OParl 1.0 und 1.1.
Nein. Die Schnittstelle ist lesend und ohne Anmeldung nutzbar, auch direkt aus Webanwendungen im Browser. Damit sie für alle schnell bleibt, begrenzt sie die Zahl der Anfragen je Adresse.
Nein. Sie liefert nur, was als öffentlich gekennzeichnet ist. Wird ein Objekt nachträglich nichtöffentlich oder gelöscht, erscheint es nur noch als gekürztes Objekt mit der Markierung „gelöscht“, damit Kopien es entfernen.
Die Lizenz bestimmt die Kommune. In mandari Session wählt sie etwa die Datenlizenz Deutschland oder eine Creative-Commons-Lizenz; bei Daten aus anderen Systemen gibt mandari die Angabe der Kommune weiter.
Mit mandari Session (Pilotphase), in zwei Teilen: Gremien, Personen und Besetzungen übernehmen wir aus Listen Ihrer Verwaltung. Ihren öffentlichen Altbestand liest mandari über OParl ein; er bleibt im Bürgerportal durchsuchbar. Die Übernahme dieses Bestands in Session ist für Version 1.0 geplant.
Wie der Umstieg abläuft, zeigt die Seite Migration.
Sprechen wir über Ihre Ratsdaten.
In 30 Minuten klären wir, wie Ihre Ratsdaten über OParl ins Bürgerportal kommen und wie sie offen bereitstehen. Per Video, am Telefon oder persönlich in Münster.
- hello@mandari.de
- Quellcode
- auf GitHub
- Für Vergabestellen
- Unterlagen
- Preise
- Was mandari kostet