Dés
L'endpoint /dice lance des dés en notation RPG (NdX ou NdX+M).
GET/v4/dice
Paramètres
| Paramètre | Requis | Description |
|---|---|---|
roll | Oui | Notation de dés (ex : 2d6+3, 1d20, 4d8). 1–100 dés, 2–1000 faces. Le + peut être encodé en espace. |
Champs de réponse
| Champ | Type | Description |
|---|---|---|
roll | string | La notation de dés analysée |
count | number | Nombre de dés lancés |
sides | number | Nombre de faces par dé |
modifier | number | Modificateur ajouté (0 si aucun) |
results | number[] | Résultats individuels de chaque dé |
total | number | Somme de tous les dés + modificateur |
Exemples de code
curl -X GET \
"https://api.sylvain.sh/v4/dice?roll=2d6%2B3"Essayer
Gestion des erreurs
Si les paramètres sont manquants ou invalides, l'API retournera une erreur :
| Message d'erreur | Description |
|---|---|
Please provide a valid dice roll (?roll={NdX|NdX+M}) | Le paramètre roll est manquant ou invalide |