v5

latestOpenAPI 3.1.0Apache-2.02026-08-0212527433.1 KB
cities

Kommunale Ratsinformationen je Stadt (OParl, Tier A)

Kommunale Ratsinformationen einer Stadt aus dem OParl-1.x-Standard (OParl "Paper" = Vorlagen, Anträge, Beschlüsse): je Paper Titel, Referenz, Datum, Paper-Typ und der Link zur Hauptdatei (main_file_url, das PDF wird NICHT gespiegelt). Abgedeckt sind die acht lizenzgeklärten Städte Dresden, Köln, Düsseldorf, Münster, Leipzig, Magdeburg, Osnabrück und Freiburg im Breisgau (je eigene Lizenz in der attribution). Read-only aus dem deduplizierten Store (kein Live-Pull im Request-Pfad). Filter q (Titel-Stichwort), paper_type und since (ab ISO-Datum), mit Pagination (limit/offset); data.total nennt den Gesamtbestand zu den aktiven Filtern. Nicht abgedeckte Stadt -> 404 mit Hint. Keine Paper -> 200 source_status="no_data", data=null. Deaktiviert -> 200 source_status="disabled". Zusätzlich unter dem Alias /api/v1/cities/{slug}/council/papers erreichbar.

get/api/v1/cities/{slug}/council-papers

Path parameters

slugstring required

Query parameters

qstring

Titel-Stichwort (Teilstring, parametrisierter LIKE-Filter).

paper_typestring

Exakter Paper-Typ (z. B. Beschlussvorlage, Antrag).

sincestring date

Nur Paper ab diesem ISO-Datum YYYY-MM-DD; ungültiges Datum -> 422.

limitinteger

Seitengröße (Default 50, Cap 100).

offsetinteger

Seiten-Offset (>= 0); Overflow -> leere Seite, no_data.

Response

Ratsinformations-Envelope (aggregierte papers-Liste + count, oder null bei no_data/disabled)