[Od-nrw] Fwd: Offenes Köln erblickt das Licht der Welt

[Jan Ehrhardt]

Am 3. Februar 2012 11:42 schrieb Marian Steinbach <marian at sendung.de>:

> Sorry, falsch addressiert.
>
> Könnten wir mal reply-to auf od-nrw at lists.okfn.org setzen?
>

+1


>
>
> ---------- Weitergeleitete Nachricht ----------
> Von: Marian Steinbach <marian at sendung.de>
> Datum: 3. Februar 2012 11:42
> Betreff: Re: [Od-nrw] Offenes Köln erblickt das Licht der Welt
> An: Jan Ehrhardt <jan.ehrhardt at googlemail.com>
>
>
> Hallo Jan!
>
> Diese Mail ist mir im aktuellen etwas stärkeren Mail-Verkehr leider
> untergegangen, verdient aber definitiv Feedback!
>
> Klingt, als machst Du dir die richtigen Gedanken!
>
> Inwiefern denkst Du auch in Richtung Meta-Ebene bzw. mehrere
> Mandanten? Sollte die Spezifikation auch für Kreise etc.
> funktionieren, die mehrere Gemeinden unter sich haben? Es gibt ja z.B.
> SessionNet Installationen mit mehreren Mandanten. Und es könnte ja
> auch Plattformen geben, die gleich mehrere RIS, z.B. das ganze
> Ruhrgebiet, abdecken wollen.
>
> Grüße vom
>
> Marian
>
>
> Am 1. Februar 2012 22:45 schrieb Jan Ehrhardt <jan.ehrhardt at googlemail.com
> >:
> > also ein Paar Worte zum geplanten API Entwurf.
> >
> > Anders als bei der aktuellen API von offeneskoeln.de setze ich vor
> allem auf
> > URLs mit Pfaden und ohne Parameter. Das hat den Vorteil das sich
> logische,
> > hierarchische Strukturen in den URLs abbilden lassen. Nachdem ich mir
> > verschiedene RIS angeschaut habe, ist mit aufgefallen, dass sie alle eine
> > gewisse Hierarchie in den Daten haben. Ganz oben sind die jeweiligen
> > Gremien, darunter kommen die konkreten Sitzungen und schließlich die
> > Drucksachen, die den Sitzungen zugeordnet sind. Für Köln könnte das so
> > aussehen:
> >
> >
> http://offeneskoeln.de/api/gremien/finanzausschuss/2011/05/23/interkulturelle+und+integrationsprojekte/
> >
> > Identifizieren würde die URL folgendes Dokument
> > http://offeneskoeln.de/dokumente/AN-1081-2011/.
> >
> > Darüber hinaus gibt es zum Teil orthogonal zu obiger Hierarchie
> verschiedene
> > Kategorisierungen wie Straßen und Stadtteile, übergreifende Themen und
> > natürlich Zeiträume bzw. Wahlperioden. Man kann dadurch interessante
> > Abfragen rein Pfadstrukturen realisieren.
> >
> > Aktuell mache ich mir nur über den lesenden Zugriff Gedanken, aber
> > schreibender Zugriff soll später folgen, damit man auch Editoren
> > programmieren kann und Scraper nicht direkt auf die DB zugreifen müssen.
> Das
> > impliziert allerdings auch die Themen Authentifizierung und Autorisierung
> > und daher kommt das später.
> >
> > Als Standardformat, das bei einem HTTP GET auf die obige URL
> zurückgeliefert
> > würde, ist JSON vorgesehen. In dem JSON Dokument sind dann verschiedene
> > Informationen enthalten, wozu auch Links gehören. Links sind schließlich
> > neben HTTP ein ganz essentieller Bestandteil des Internets. Links können
> > dann auf untergeordnete Dokumente verweisen oder eben auch auf andere
> > Repräsentationen desselben Dokuments. Die API sieht nur die JSON
> > Repräsentation explizit vor und überlässt dem Implementierer, welche
> anderen
> > Formate unterstützt werden.
> >
> > Bsp:
> > Ruft man die URL http://offeneskoeln.de/api/gremien/finanzausschuss/auf,
> > würde ein JSON Dokument geliefert, das u. a. eine Liste von Links auf
> andere
> > Repräsentationen beinhaltet.
> >
> > - http://offeneskoeln.de/api/gremien/finanzausschuss/termine.ics: Würde
> eine
> > iCal Datei aller Termine des Finanzausschuss liefern.
> > - http://offeneskoeln.de/api/gremien/finanzausschuss/atom.xml: Würde
> einen
> > Atom Feed mit allen Sitzungen liefern.
> > - http://offeneskoeln.de/gremien/finanzausschuss/: Könnte der Link auf
> die
> > Webseite des Finanzausschuss auf offeneskoeln.de sein.
> >
> > Die Links und Formate sind nur Beispiele, wie sowas aussehen könnte,
> wobei
> > die API dies explizit offen lassen wird.
> >
> > Insgesamt ist das Ziel den Inhalt durch Links und eine klare Struktur
> > crawlbar zu machen. Ausgehend von einer Root-URL wie
> > http://offeneskoeln.de/api/ sollte es also möglich sein durch das
> Folgen von
> > Links den gesamten Datenbestand zu durchlaufen. Das hat den Vorteil, dass
> > ein Client nicht wirklich etwas über die Struktur des Inhalts wissen
> muss.
> >
> > Soweit so gut. Ich hoffe, das bringt mehr Licht als Dunkel. Die
> > Schwierigkeit ist im wesentlichen das alles schön aufzuschreiben, aber
> ich
> > gebe euch Bescheid sobald es online ist.
> >
> > Viele Grüße
> > Jan Ehrhardt
> >
>
> _______________________________________________
> Od-nrw mailing list
> Od-nrw at lists.okfn.org
> http://lists.okfn.org/mailman/listinfo/od-nrw
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.okfn.org/pipermail/od-nrw/attachments/20120203/c249334d/attachment.html>