Was ist das Ratsinformationssystem (RIS)?

Im RIS, dem Ratsinformationssystem des Gemeinderats Zürich, werden die Geschäfte des Gemeinderats bewirtschaftet, dokumentiert und im Internet auf der Gemeinderats-Webseite publiziert.

Was ist die RIS-API?

Die RIS-API ist die Schnittstelle zum Ratsinformationssystem, über welche detaillierte Datenanfragen auf die folgenden Entitäten gemacht werden können:

Geschäfte
Mitglieder (ehemalige und aktuelle)
Ratspost (seit 2005) und
Protokolle (seit 2002)

Die Daten können als JSON oder XML bezogen werden.

Welche Informationen finde ich in der RIS-API?

Die RIS-API bietet den selben Informationsinhalt, welcher zur Ansicht auf der Webseite des Gemeinderats der Stadt Zürich zu finden ist.

Das Herzstück dabei bilden sicherlich die Daten zu den Geschäften. Hier kann nach einer Vielzahl von Parametern gesucht werden, wie z.B. nach dem Jahr in welchem es behandelt wurde, oder dem Departement, welches dafür zuständig ist. Ebenso wie nach der Person oder der Partei, welche ein Geschäft eingereicht hat. Hilfreich ist ausserdem die Suche nach Stichworten, nach welchen ein Geschäft gefunden werden kann. Sehr detailliert lassen sich die Geschäfte auch nach deren Art (z.B. Motionen, Petitionen, Postulate, Weisungen, Interpellationen, Resolutionen, etc.), deren Ablaufschritten oder deren Status abfragen.

Ausserdem sind sehr detaillierte Daten zu den Mitgliedern, also den ehemaligen und aktuellen Parlamentarierinnen und Parlamentariern, abfragbar. Einerseits sind dies detaillierte Informationen zur Person (Beruf, Geburtsdatum, Geschlecht, Kontaktangaben, Partei, Interessensbindungen, etc.), andererseits aber auch zur deren Tätigkeiten (Kommissionen, Vorstösse, etc. ).

Daneben kann auch nach Protokollen und der Ratspost gesucht werden, entweder aus bestimmten Zeitbereichen oder nach gewissen Stichworten.

Dokumentation der RIS-API auf Github:

Sie finden eine ausführliche Dokumentation zur RIS-API auf Github. RIS-API Dokumentation

Beschreibung der API Endpunkte und Parameter:

Wichtiger Bestandteil der RIS-API-Dokumention ist eine Swagger-UI-Webseite, welche ein einfaches interaktives Erforschen der verfügbaren Endpunkte und Parameter der RIS-API erlaubt. RIS-API Dokumentation

Programmierbeispiele mit Python:

Um den Einstieg der API-Abfragen mit einer Programmiersprache zu erleichtern, haben wir nebst typischen Beispiels-Abfragen in der Dokumentation auch noch ein paar Programmierbeispiele mit Python als Jupyter-Notebook zur Verfügung gestellt.

Wir haben dieses Notebook auch auf Binder verfügbar gemacht, damit Sie es auch einfach in ihrem Browser interaktiv laufen lassen können:

RIS-API Dokumentation

Anwendungen für Schnittstelle zum Ratsinformationssystem (RIS) des Gemeinderats der Stadt Zürich.