Simulateur pile ou face

Un nombre de lancers manquant, nul, négatif ou non entier échoue avec invalid_input au lieu d'inventer un lancer.

Ce qu'un simulateur de pièce équitable renvoie vraiment

Le mappage est fixe, le générateur est fixe et le parcours des lancers est séquentiel, si bien que le couple flips et seed décrit entièrement l'expérience. La réponse énumère le tableau sequence, la chaîne compacte sequence_string, le compte heads, le compte tails et heads_rate afin que vous vérifiiez la loi des grands nombres sur un n modeste sans écrire votre propre boucle. Des entrées identiques produisent toujours le même JSON, car le chemin ne consulte jamais l'horloge murale ni la source aléatoire de l'hôte.

Contrat d'entrée, forme de la réponse et erreurs

Exemple : dix lancers avec la graine quarante-deux produisent toujours la même bande de dix caractères et les mêmes deux comptes. Associez la réponse à votre propre code de graphique si vous avez besoin d'un histogramme des longueurs de séries ; ce point d'accès ne simule que les lancers. Envoyez par POST un corps JSON avec flips égal à un entier positif de un à dix mille ; les alias n, count et times sont acceptés lorsque les clients réutilisent d'anciens noms de formulaire. La seed facultative est un entier fini qui initialise le générateur ; l'alias rng_seed désigne le même champ, et omettre seed utilise la valeur par défaut documentée de un, de sorte qu'un simple nombre de lancers produit encore une bande stable. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique de chiffres ; les chaînes vides, les booléens, les objets et les non-entiers échouent avec invalid_input en nommant le champ. Zéro, les valeurs négatives et les comptes au-dessus du maximum publié sont rejetés, car ce ne sont pas un nombre de lancers entier positif dans le budget du Worker. Ces échecs ne sont pas facturés. En cas de succès, le corps répète flips et seed, renvoie sequence comme un tableau de jetons H et T dans l'ordre des lancers, sequence_string comme les mêmes faces concaténées pour un copier-coller aisé, heads et tails comme des comptes entiers qui somment toujours à flips, heads_rate comme heads divisé par flips arrondi à douze décimales, p égal à un demi et fair égal à true afin que le code en aval branche sans flairer les formes. Gardez n modeste dans les widgets interactifs, figez des goldens pour les graines que vous publiez et traitez invalid_input comme un signal de qualité des données plutôt que de relancer un compte mal formé.

Où un simulateur de pièce à graine justifie son existence

Les générateurs de préparation d'examens ont besoin d'un oracle déterministe qui marque un nombre de lancers erroné comme invalid_input au lieu de renvoyer silencieusement une liste vide qu'un correcteur défectueux pourrait traiter comme un succès. Comme l'implémentation est du parse pur de niveau A, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle et sans réseau sortant. Restez dans le plafond de lancers publié, figez heads_rate arrondi dans les tests, et vous obtenez des séquences de pièce équitable reproductibles pour les devoirs, les greffons LMS et les workers de bord, sans dresser un service aléatoire maison.