Das Wiki ist zur Zeit read-only. Du willst das ändern? Wende dich an: admin AT freieslabor DOT org.
Labor-API
Version vom 11. April 2015, 16:37 Uhr von Trublu (Diskussion | Beiträge)
Labor-API
| |
---|---|
Status: | aktiv (Was heißt das?) |
Die Labor-API ist in Python (mit Flask) geschrieben und läuft auf einem gunicorn-Server.
Das Ausgabeformat ist momentan auf JSON beschränkt. Die schreibenden Methoden benötigen API-User und API-Key zur Authentifizierung (Nachricht an Basti).
Inhaltsverzeichnis
GET /api/room/
Gibt den aktuellen Laborstatus und den Zeitpunkt der letzten Änderung zurück. (Bildrepräsentation: /api/room_image.png)
Rückgabewerte: | Name | Typ | Beschreibung |
open | boolean | Türstatus | |
since | integer | Unix Timestamp der letzten Aktualisierung |
GET /api/info/ bzw. /api/room_extended/
Stellt allgemeine Informationen (inkl. Laborstatus) zur Verfügung. API Version: 0.13.
Siehe Spezifikation.
Schreibende Methoden
POST /api/room/ (Authentifizierung erforderlich)
Setzt den Raumstatus.
Parameter: | Name | Typ | Beschreibung |
open | boolean | Raumstatus |
Rückgabewerte: | Name | Typ | Beschreibung |
success | boolean | Erfolgsstatus | |
status | string | Fehlermeldung (KANN verfügbar sein WENN success == false) |
Andere API-Inhalte
- /api/twitter/freieslabor.atom - Twitterfeed als Atom
- /api/twitter/freieslabor.atom/wikimarkup - Twitterfeed als Atom mit Links in Wiki-Syntax
- /api/twitter/freieslabor.atom/nolinks - Twitterfeed als Atom ohne HTML-Links
- /api/events_utc.ical - Kalender im ical-Format in UTC