API de lancer de dés aléatoire en JSON

L’API DéJeté permet d’ajouter un générateur de dés aléatoires à un site, un jeu, un prototype ou un script sans reconstruire l’interface de lancer.

La réponse contient les résultats de chaque dé au format JSON, afin d’être traitée côté serveur ou dans votre application.

Paramètres de l’API pour lancer des dés

Pour appeler l’API, envoyez une requête GET avec le nombre de dés et le nombre de faces souhaités, comme dans l’exemple ci-dessous.

Exemple d’appel : https://www.dejete.com/api?nbde=5&tpde=6

Le paramètre « nbde » indique le nombre de dés à lancer et « tpde » le nombre de faces de chaque dé. Dans cet exemple, l’API lance 5 dés à 6 faces.

Récupérer et exploiter les résultats JSON

La requête GET renvoie une réponse JSON. Il suffit ensuite de la décoder pour exploiter les résultats dans votre script ou votre programme.

Exemple d’intégration en PHP :

<?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>';
     }
?>

Chaque résultat contient les champs JSON « id » et « value » : « id » identifie le dé lancé et « value » contient la valeur aléatoire obtenue.

Quand utiliser l’API de dés DéJeté ?

L’API convient aux prototypes de jeux, outils pédagogiques et petits automatismes nécessitant un tirage numérique. Pour vérifier visuellement un comportement avant l’intégration, testez d’abord le lanceur de dés en ligne ou la page des dés JDR de d4 à d100.