API für zufällige Würfelergebnisse in JSON

Mit der DéJeté-API lässt sich ein Zufalls-Würfelgenerator in eine Website, ein Spiel, einen Prototyp oder ein Skript einbauen, ohne eine eigene Würfeloberfläche zu entwickeln.

Die Antwort enthält das Ergebnis jedes Würfels im JSON-Format und kann serverseitig oder in einer Anwendung weiterverarbeitet werden.

Parameter der Würfel-API und Anfrageformat

Sende eine GET-Anfrage mit der Anzahl der Würfel und der gewünschten Seitenzahl, wie im Beispiel unten.

Beispielaufruf: https://www.dejete.com/api?nbde=5&tpde=6

Der Parameter „nbde“ legt die Anzahl der Würfel fest, „tpde“ die Seitenzahl jedes Würfels. Im Beispiel werden 5 sechsseitige Würfel geworfen.

JSON-Würfelergebnisse auslesen und verwenden

Die GET-Anfrage liefert eine JSON-Antwort, die du decodieren und in deinem Skript oder Programm verwenden kannst.

PHP-Beispiel:

<?php
     $resultat = file_get_contents('https://www.dejete.com/api?nbde=5&tpde=6');
     $json = json_decode($resultat);
     foreach($json as $de)
     {
          echo $de->id.' : '.$de->value.'<br>';
     }
?>

Jedes Ergebnis enthält die JSON-Felder „id“ und „value“: „id“ bezeichnet den Würfel, „value“ den zufällig gewürfelten Wert.

Wann eignet sich die DéJeté-Würfel-API?

Die API eignet sich für Spieleprototypen, Lernwerkzeuge und kleine Automationen, die numerische Zufallswürfe benötigen. Vor der Integration kannst du das Verhalten mit dem Online-Würfelgenerator oder der Seite für RPG-Würfel von W4 bis W100 prüfen.