summaryrefslogtreecommitdiff
path: root/spaceapi.mdwn
blob: 9fd29207de7062e404d17089a5d6423ba7753c33 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
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 Widget|https://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]]