OParl-konforme API: Mandari als aggregierte Datenquelle nach außen

[mandariSoftware]

Beschreibung

Mandari aggregiert OParl-Daten aus über 50 deutschen Kommunen in einer einzigen Datenbank. Diese Daten könnten über eine eigene, OParl-konforme REST-API nach außen bereitgestellt werden – damit wird Mandari selbst zur OParl-Quelle.

Motivation

• Aggregation: Statt 50+ verschiedene OParl-Endpunkte abzufragen, könnten externe Tools eine einzige API nutzen
• Stabilität: Mandari-API ist immer erreichbar, auch wenn einzelne kommunale APIs offline sind
• Erweiterung: Mandari-spezifische Daten (KI-Zusammenfassungen, extrahierte Texte, Geo-Daten) können über die gleiche API bereitgestellt werden
• Interoperabilität: Externe Projekte (z.B. LLM-basierte Assistenten, Forschungstools, Civic-Tech-Projekte) können direkt auf die Daten zugreifen
• Open Data: Stärkt das Ökosystem offener kommunalpolitischer Daten in Deutschland

Anforderungen

• OParl 1.1 konform (soweit sinnvoll)
• Lesender Zugriff (anonym, kein Auth nötig)
• Pagination nach OParl-Spec
• Filterung (modified_since, body, etc.)
• Dokumentierte Endpunkte
• Rate Limiting zum Schutz der Infrastruktur

Offene Fragen

• Welche zusätzlichen Mandari-spezifischen Felder sollen exponiert werden?
• Soll die API unter einer eigenen Subdomain laufen?
• Lizenzierung der aggregierten Daten?

Kontext

Inspiration u.a. durch RATISA – ein LLM-Assistent der direkt auf OParl-APIs zugreift. Eine aggregierte Mandari-API würde solchen Projekten den Zugang massiv vereinfachen.