expanded space api article

1 files changed, 34 insertions, 2 deletions

diff --git a/spaceapi.mdwn b/spaceapi.mdwn
index 1b2d3ae..b6e2ed8 100644
--- a/spaceapi.mdwn
+++ b/spaceapi.mdwn
@@ -1,3 +1,35 @@
-SpaceAPI is a project to provide unified syntax for hackerspace to publish information and status updates about their space. 
+# Was ist die Space API
 
-[http://chasmcity.sonologic.nl/spacestatusdirectory.php]
+Die Space API ist ein Projekt um ein vereinheitlichtes Statussyntax fuer alle Hackerspaces bereitzustellen. Zurzeit haben wir nur die Grundlegenden Funktionen (Tuerstatus und Kontaktdaten) implementiert. In Zukunft kann man daueber aber auch sicher Veranstaltungen ankuendigen.
+
+# Wie funktioniert es
+
+Wir haben Sensoren an der Tuer, mit denen wir herausfinden koennen, ob die Tuerfluegel geschlossen oder offen sind, und ob das Schloss geoeffnet oder verschlossen ist. Diese Informationen werden zusammen mit den Informationen die ueber den [[Hausbus]] vorhanden sind auf [[Taifun]] in einer (JSON|http://en.wikipedia.org/wiki/JSON)-Datei abgelegt.
+Auf dem Webserver [[oberon]] laeuft alle zwei Minuten ein Skript, welches den aktuellen Tuerstatus aus der Hausbus-JSON-Datei auf Taifun ausliest, und in die SpaceAPI-JSON-Datei einfuegt.
+
+# Status abrufen (Software)
+
+Es gibt es Reihe von Softwareschnittstellen fuer die SpaceAPI, diese existieren sowohl als Browserplugin, als auch als Applikation fuer Mobilgeraete.
+
+## Firefox
+
+Fuer den Firefox gibt es das Openspace Plugin, welches durch einen roten oder gruenen Kreis in der Statusleiste den Status des ausgewaehlten Spaces darstellt.
+
+(OpenSpace (Firefox Plugin)|https://addons.mozilla.org/de/firefox/addon/hackers-openspace/)
+
+## Android
+
+Fuer das Androidbetriebssystem gibt es eine Reihe von Applikationen, die die SpaceAPI auslesen und anzeigen koennen. My Hackerspace tut dies schnell und minimalistisch. Space Directory ist ein wenig netter anzusehen, laeuft aber gefuehlt langsamer und hakeliger. Das Hackerspace Widget zeigt auf dem Homescreen einen roten oder gruenen Kreis an, je nach Status des eingestellten Spaces.
+
+(Space Directory|https://play.google.com/store/apps/details?id=ws.narro.the.in.spacedirectory)
+(My Hackerspace|https://play.google.com/store/apps/details?id=ch.fixme.status)
+(Hackerspace Widgethttps://play.google.com/store/apps/details?id=de.ring0.hackspace)
+
+# Links
+
+* (SpaceAPI Spezifikation|https://hackerspaces.nl/spaceapi/)
+* (Liste der teilnehmenden Spaces|http://chasmcity.sonologic.nl/spacestatusdirectory.php)
+* (SpaceAPI JSON Datei|http://sublab.org/sublab_status.json)
+* (Hausbus JSON Datei|http://taifun.local.sublab.org/subcan.json)
+* (SpaceAPI Script|http://git.sublab.org/website/tree/scripts/sub_api.py)
+* {SpaceAPI Template|http://git.sublab.org/website/tree/template/template.spaceapi.json)