API de tiradas de dados aleatorias en JSON
La API de DéJeté permite añadir un generador de dados aleatorios a una web, juego, prototipo o script sin reconstruir una interfaz de tiradas.
La respuesta contiene el resultado de cada dado en formato JSON para procesarlo desde el servidor o desde tu aplicación.
Parámetros de la API para tirar dados
Envía una petición GET con la cantidad de dados y el número de caras, como en el ejemplo siguiente.
Ejemplo de llamada: https://www.dejete.com/api?nbde=5&tpde=6
El parámetro «nbde» indica la cantidad de dados y «tpde» el número de caras de cada dado. En este ejemplo se lanzan 5 dados de 6 caras.
Recuperar y usar los resultados JSON
La petición GET devuelve una respuesta JSON que puedes decodificar e integrar en tu script o programa.
Ejemplo de integración 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>';
}
?>
Cada resultado contiene los campos JSON «id» y «value»: «id» identifica el dado y «value» contiene el valor aleatorio obtenido.
¿Cuándo utilizar la API de dados de DéJeté?
La API es útil para prototipos de juegos, herramientas educativas y automatizaciones sencillas que necesitan tiradas numéricas. Antes de integrarla, puedes comprobar el comportamiento con el lanzador de dados online o con la página de dados RPG de d4 a d100.