X-Git-Url: https://git.rohieb.name/stratum0-wiki.git/blobdiff_plain/bf14d3674bbc8b0a3b044326cc9bd89d89af3627..2e9280f0895ca5528f986b40bd4efd6b34a7a190:/Open%2FClose-Monitor%2FAPI.mw?ds=sidebyside diff --git a/Open%2FClose-Monitor%2FAPI.mw b/Open%2FClose-Monitor%2FAPI.mw index 95d77c9ab..330da3fb0 100644 --- a/Open%2FClose-Monitor%2FAPI.mw +++ b/Open%2FClose-Monitor%2FAPI.mw @@ -1,9 +1,12 @@ Für den [[Open/Close-Monitor]] gibt es eine minimale API über HTTP, um die maschinelle Verarbeitung zu erleichtern. +{{Hinweis|Die in diesem Artikel beschriebene API wird auf lange Sicht nicht mehr fortgeführt, neuere Implementierungen sollten die [https://spaceapi.io/ SpaceAPI] verwenden.}} +;Randbemerkung: Ich ([[Benutzer:Daniel Bohrer|Daniel Bohrer]]) hatte damals⢠eine eigene API für unsere minimalen Bedürfnisse entworfen. Später bin ich auf das Projekt [https://spaceapi.io/ SpaceAPI] von Hackerspaces.nl gestoÃen, das darauf abzielt, viele Hackerspaces mit einer möglichst konsistenten API ansprechen zu können (z. B. hier eine [http://hackerspaces.me/wall Beispielanwendung], benötigt JavaScript). Die JSON-Version unter <tt>https://status.stratum0.org/status.json</tt> implementiert daher beide APIs, die SpaceAPI sowie die hier beschriebene. + == Formate == Es stehen folgende Formate zur Verfügung: <ul><li> -{{WP|JSON}}, über die URL <tt>http://status.stratum0.org/status.json</tt><br /> +{{WP|JSON}}, über die URL <tt>https://status.stratum0.org/status.json</tt><br /> Beispiel: <pre> { @@ -12,7 +15,7 @@ Beispiel: "since": "2012-01-30T03:54:38.804565" }</pre> </li><li> -{{WP|XML}}, über die URL <tt>http://status.stratum0.org/status.xml</tt><br /> +{{WP|XML}}, über die URL <tt>https://status.stratum0.org/status.xml</tt><br /> Beispiel: <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <status version="0.1"> @@ -20,13 +23,13 @@ Beispiel: <since>2012-01-30T03:54:38.804565</since> </status> </li><li> -Schlüssel-Wert-Paare nach RFC 822, über die URL <tt>http://status.stratum0.org/status.txt</tt><br /> +Schlüssel-Wert-Paare nach RFC 822, über die URL <tt>https://status.stratum0.org/status.txt</tt><br /> Beispiel: Version: 0.1 IsOpen: false Since: 2012-01-30T03:54:38.804565 </li><li> -direkte Abfrage der PNG-Grafik, über die URL <tt>http://status.stratum0.org/status.png</tt>. Die Grafik zeigt den Ãffnungsstatus in Form einer roten bzw. grünen Grafik mit Aufschrift âOPENâ bzw. âCLOSEDâ auf 200Ã50 Pixeln an. +direkte Abfrage der PNG-Grafik, über die URL <tt>https://status.stratum0.org/status.png</tt>. Die Grafik zeigt den Ãffnungsstatus in Form einer roten bzw. grünen Grafik mit Aufschrift âOPENâ bzw. âCLOSEDâ auf 200Ã50 Pixeln an. </li></ul> Um eine hohe Last durch Anfragen zu vermeiden, wird der HTTP-Client über die HTTP-Header "Expires" und "Cache-Control" angewiesen, die Ergebnisse der Anfragen für 5 Minuten zwischenzuspeichern.