Einen Dienst prüfen
Eine Lampe in deiner Basis, die aufleuchtet, wenn deine Lieblings-Website ausgefallen ist, und eine Anzeige, die sagt, warum. Und für Neugierige: einen Server fragen, welche Methoden er erlaubt und wie eine Anfrage aussieht, wenn sie ankommt.
Funktionen: HTTP_HEAD, HTTP_OPTIONS, HTTP_TRACE und FROM_JSON aus c0de/strings
Was du brauchst
Die Mod c0de net in deinem Spiel. Für die Statuslampe: einen Zeitgeberblock, einen Komparator und eine Redstone-Lampe, eine Anzeigewand aus 2 × 1 Anzeigeblöcken und wahlweise Variablenkarten server und endpoint vom Typ STRING, um eine andere Seite als c0de.at zu prüfen. Für „Was ein Server erlaubt“: einen Auslöserblock mit Knopf, einen Laptop und zwei nicht initialisierte Variablenkarten. Für die Übungen: eine Redstone-Fackel und eine zweite Redstone-Lampe.
Die Idee
Um zu sehen, ob eine Seite erreichbar ist, brauchst du nicht die ganze Seite. HTTP_HEAD fragt wie GET, aber der Server schickt nur die Header seiner Antwort: den Status, den Typ, das Datum der letzten Änderung. Das geht schnell und kostet den Server fast nichts, also kann ein Zeitgeberblock jede Minute fragen.
Das Programm teilt es der Welt über seinen Exit-Code mit: 0, wenn die Seite geantwortet hat, 1, wenn sie mit einem Fehlerstatus wie 404 oder 503 geantwortet hat, 2, wenn gar keine Antwort kam. Ein Komparator neben dem Zeitgeberblock macht aus dem Exit-Code ein Redstone-Signal, und die Lampe leuchtet, sobald er nicht 0 ist.
HTTP_OPTIONS und HTTP_TRACE sind Werkzeuge, um einen Server zu erkunden: OPTIONS fragt, welche Methoden ein Endpunkt erlaubt, TRACE bittet den Server, die Anfrage so zurückzuschicken, wie sie angekommen ist.
Das Programm
PROGRAM statuslamp
NOOP
INCLUDE c0de/strings
INCLUDE c0de_net/http
NOOP
STRUCT page
BEGIN
type STRING TAG(json: "content-type")
changed STRING TAG(json: "last-modified")
END STRUCT
NOOP
FUNCTION check
PARAMETER server STRING "c0de.at"
PARAMETER endpoint STRING "/"
BEGIN
VARIABLE status INTEGER
VARIABLE api STRUCT c0de_net/http/HTTP_CONNECTION
VARIABLE problem ERROR
VARIABLE answer STRING
VARIABLE info STRUCT page
ASSIGN api.use_ssl TRUE ;
ASSIGN api.server server ;
ASSIGN api.timeout 5 ;
CALL c0de_net/http/HTTP_HEAD problem
PARAMETER connection api ;
PARAMETER endpoint endpoint ;
RESULT result answer
RESULT status status
CALL CLS
CALL PRINT
PARAMETER value server ⊕ endpoint ;
IF problem.code ≠ 0 AND problem.code ≠ c0de_net/http/HTTP_STATUS ;
BEGIN
CALL PRINT
PARAMETER value "DOWN: " ⊕ problem.message ;
EXIT 2 ;
END IF
CALL c0de/strings/FROM_JSON
PARAMETER source answer ;
PARAMETER destination info ;
CALL PRINT
PARAMETER value "Status " ⊕ status ;
CALL PRINT
PARAMETER value info.type ;
CALL PRINT
PARAMETER value info.changed ;
IF problem.code = c0de_net/http/HTTP_STATUS ;
BEGIN
EXIT 1 ;
END IF
END FUNCTIONAufbauen und starten
- Setze den Zeitgeberblock, einen Komparator, der von ihm weg zeigt, und die Redstone-Lampe vor den Komparator.
- Binde die Anzeigewand an
statuslamp/check. - Stelle den Zeitgeberblock auf
statuslamp/checkund einen Abstand von 1200 Ticks (eine Minute) ein. Leg die Kartenserverundendpointhinein, wenn du eine andere Seite prüfen willst.
Die Wand zeigt die Seite und ihre Antwort, und die Lampe bleibt dunkel:
c0de.at/
Status 200
text/html; charset=utf-8
Thu, 12 Nov 2026 07:28:38 GMT
Mit dem Endpunkt /api/nothing zeigt die Wand Status 404 und application/json; charset=utf-8, und die Lampe leuchtet mit Signalstärke 1. Für einen Server, den es nicht gibt, zeigt sie DOWN: und den Grund, und das Signal ist 2.
Den Prozess eines Zeitgeberblocks startet niemand, also kommen die Anfragen vom Computer seines Besitzers. Ist der Besitzer offline, schlägt die Anfrage mit CLIENT_UNAVAILABLE fehl, und die Lampe leuchtet auch – das Programm kann nicht unterscheiden, ob die Seite ausgefallen ist oder niemand fragen kann. Dasselbe passiert, wenn der Besitzer die Anfragen auf seinem Computer abgeschaltet hat.
So funktioniert es
- HEAD liefert die Header doppelt.
headersist ein HASH, undresultenthält – nur bei HEAD – dieselben Header als JSON-Objekt, etwa{"content-type":"text/html; charset=utf-8","last-modified":"…",…}. FROM_JSON liest es in die Strukturpage, deren Tags die zwei Header auswählen, die das Programm zeigt. Fehlt ein Header, bleibt sein Element leer. - Der Fehler bestimmt den Exit-Code. Der CALL fängt jeden Fehler in
problemab. Der Codec0de_net/http/HTTP_STATUS(1000) heißt: Der Server hat mit einem Status ab 400 geantwortet – er läuft, aber etwas stimmt nicht. Jeder andere Code heißt, dass es keine Antwort zu lesen gibt, und das Programm zeigt die Meldung, etwa einen unbekannten Host, und endet mitEXIT 2. - EXIT ist das Signal.
EXIT 1undEXIT 2beenden den Prozess mit diesem Code. Ohne EXIT endet die Funktion normal mit dem Code 0. - Kurzes Timeout.
timeout5 heißt: Eine Seite, die länger als fünf Sekunden braucht, gilt als ausgefallen.
Was ein Server erlaubt
Dieses Programm fragt die Aufgabenliste von c0de.at (siehe Mit einem REST-Dienst sprechen), was sie erlaubt, und probiert dann TRACE daran aus:
PROGRAM methodcheck
NOOP
INCLUDE c0de/strings
INCLUDE c0de_net/http
NOOP
STRUCT request
BEGIN
method STRING
path STRING
END STRUCT
NOOP
FUNCTION ask
PARAMETER endpoint STRING "/api/tutorial/todo"
RESULT methods STRING
RESULT traced INTEGER
BEGIN
VARIABLE api STRUCT c0de_net/http/HTTP_CONNECTION
VARIABLE problem ERROR
VARIABLE headers HASH STRING
VARIABLE answer STRING
VARIABLE seen STRUCT request
VARIABLE known BOOLEAN
ASSIGN api.use_ssl TRUE ;
ASSIGN api.server "c0de.at" ;
ASSIGN api.timeout 10 ;
CALL c0de_net/http/HTTP_OPTIONS
PARAMETER connection api ;
PARAMETER endpoint endpoint ;
RESULT headers headers
CALL HAS_KEY
PARAMETER hash headers ;
PARAMETER key "allow" ;
RESULT result known
ASSIGN methods "unknown" ;
IF known ;
BEGIN
ASSIGN methods headers["allow"] ;
END IF
CALL CLS
CALL PRINT
PARAMETER value "Allowed: " ⊕ methods ;
CALL c0de_net/http/HTTP_TRACE problem
PARAMETER connection api ;
PARAMETER endpoint endpoint ;
RESULT result answer
RESULT status traced
IF problem.code = c0de_net/http/HTTP_STATUS ;
BEGIN
CALL PRINT
PARAMETER value "TRACE refused: " ⊕ problem.message ;
RETURN
END IF
CALL c0de/strings/FROM_JSON
PARAMETER source answer ;
PARAMETER destination seen ;
CALL PRINT
PARAMETER value "TRACE arrived as " ⊕ seen.method ⊕ " " ⊕ seen.path ;
END FUNCTIONBinde einen Laptop an methodcheck / ask. Stelle den Auslöserblock auf methodcheck / ask, leg zwei nicht initialisierte Variablenkarten für die Ergebnisse methods und traced hinein und drück den Knopf. Der Laptop zeigt:
Allowed: GET, HEAD, POST, OPTIONS
TRACE refused: 405 Method Not Allowed- OPTIONS antwortet im Header
allow. Nicht jeder Server schickt ihn, deshalb prüft HAS_KEY zuerst; ein fehlender Schlüssel würde UNKNOWN_KEY auslösen. - TRACE wird oft abgelehnt. Es steht nicht in der Liste, also antwortet der Server mit 405, und HTTP_TRACE löst HTTP_STATUS aus. Das Programm fängt das ab und zeigt die Meldung, statt abzustürzen.
traced, der Status, ist 405. - Ein Server, der TRACE erlaubt, schickt die Anfrage zurück; das Programm liest ihre Methode und ihren Pfad. Viele Server tun das nicht, weil das Echo Header wie Cookies verraten könnte. c0de.at auch nicht: Probier den Endpunkt
/api/tutorial/echo, der auf jede Methode antwortet – OPTIONS nennt dort auch TRACE, aber der Webserver davor lehnt TRACE mit 405 ab, bevor die Anfrage das Echo erreicht. Genau dafür ist TRACE da: zu sehen, was die Rechner zwischen dir und dem Dienst mit einer Anfrage machen.
Probier es selbst
- Prüfe mehrere Seiten mit einem Zeitgeberblock und zeige jede in einer eigenen Zeile. Der Exit-Code ist die Zahl der Seiten, die nicht antworten.
Lösung
PROGRAM statusboard
NOOP
INCLUDE c0de_net/http
NOOP
VARIABLE servers ARRAY STRING
BEGIN
"c0de.at" "api.open-meteo.com"
END VARIABLE
NOOP
FUNCTION checkAll
BEGIN
VARIABLE down INTEGER
VARIABLE api STRUCT c0de_net/http/HTTP_CONNECTION
VARIABLE problem ERROR
ASSIGN api.use_ssl TRUE ;
ASSIGN api.timeout 5 ;
CALL CLS
EACH server servers
BEGIN
ASSIGN api.server server ;
CALL c0de_net/http/HTTP_HEAD problem
PARAMETER connection api ;
IF problem.code = 0 OR problem.code = c0de_net/http/HTTP_STATUS ;
BEGIN
CALL PRINT
PARAMETER value server ⊕ ": up" ;
END
ELSE
BEGIN
CALL PRINT
PARAMETER value server ⊕ ": DOWN" ;
ASSIGN down down + 1 ;
END IF
END EACH
EXIT down ;
END FUNCTIONDie Server stehen in einem Array, und EACH fragt einen nach dem anderen, mit derselben Verbindung und einem neuen server. Hier gilt eine Seite als erreichbar, wenn sie überhaupt antwortet, auch mit einem Fehlerstatus: api.open-meteo.com antwortet für / mit 404, ist aber da. Sind zwei Seiten ausgefallen, bekommt die Lampe Signalstärke 2.
- Baue eine zweite Lampe dazu, die leuchtet, solange die Seite erreichbar ist.
Lösung
Setze eine Redstone-Fackel an die Seite eines Blocks, den der Komparator mit Strom versorgt, und die zweite Lampe neben die Fackel. Die Fackel kehrt das Signal um: Sie ist an, solange der Komparator aus ist, also solange der Exit-Code 0 ist. Das Programm ändert sich nicht.