API per tiri di dado casuali in JSON

L’API DéJeté permette di aggiungere un generatore di dadi casuali a un sito, gioco, prototipo o script senza ricreare un’interfaccia di lancio.

La risposta contiene il risultato di ogni dado in formato JSON, pronto per essere elaborato lato server o nella tua applicazione.

Parametri dell’API per tirare i dadi

Invia una richiesta GET indicando il numero di dadi e il numero di facce, come nell’esempio seguente.

Esempio di chiamata: https://www.dejete.com/api?nbde=5&tpde=6

Il parametro “nbde” indica il numero di dadi, mentre “tpde” definisce il numero di facce di ogni dado. Nell’esempio vengono lanciati 5 dadi a 6 facce.

Recuperare e usare i risultati JSON

La richiesta GET restituisce una risposta JSON che puoi decodificare e integrare nel tuo script o programma.

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

Ogni risultato contiene i campi JSON “id” e “value”: “id” identifica il dado e “value” contiene il valore casuale ottenuto.

Quando usare l’API di dadi DéJeté?

L’API è utile per prototipi di giochi, strumenti didattici e piccole automazioni che richiedono tiri numerici. Prima dell’integrazione puoi verificare il comportamento con il lanciatore di dadi online o con la pagina dei dadi GDR da d4 a d100.