API de lançamento de dados aleatórios em JSON

A API do DéJeté permite adicionar um gerador de dados aleatórios a um site, jogo, protótipo ou script sem reconstruir uma interface de lançamento.

A resposta contém o resultado de cada dado em formato JSON, pronto para processamento no servidor ou na sua aplicação.

Parâmetros da API para lançar dados

Envie um pedido GET com o número de dados e o número de faces, como no exemplo abaixo.

Exemplo de chamada: https://www.dejete.com/api?nbde=5&tpde=6

O parâmetro “nbde” indica o número de dados e “tpde” define o número de faces de cada dado. Neste exemplo são lançados 5 dados de 6 faces.

Obter e utilizar os resultados JSON

O pedido GET devolve uma resposta JSON que pode ser descodificada e integrada no seu script ou programa.

Exemplo de integração em 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 contém os campos JSON “id” e “value”: “id” identifica o dado e “value” contém o valor aleatório obtido.

Quando utilizar a API de dados do DéJeté?

A API é útil para protótipos de jogos, ferramentas pedagógicas e pequenas automações que precisam de lançamentos numéricos. Antes da integração, pode testar o comportamento no lançador de dados online ou na página de dados de RPG de d4 a d100.