ForHosting KIT · Strumenti per sviluppatori

Mescolare un mazzo con un seme

Questo strumento trasforma un seme intero in un ordine preciso delle 52 carte di un mazzo standard.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Riutilizzando lo stesso seme, Lei ottiene la medesima sequenza: simulazioni, test, esercizi e partite ripetibili diventano così più semplici da verificare e condividere. Il risultato usa codici compatti per valore e seme, include ogni carta una sola volta e viene prodotto senza rete, orologio o casualità nascosta. Semi diversi generano normalmente ordini diversi, pur mantenendo identici la costruzione del mazzo e il procedimento documentato.

Crei un mescolamento ripetibile con un intero

Inserisca un numero intero nel campo <code>seed</code>. La capacità costruisce anzitutto un mazzo standard di 52 carte in un ordine canonico fisso: picche, cuori, quadri e fiori, con ciascun seme dall’asso al re. Applica poi una sequenza pseudocasuale inizializzata dal seme a un mescolamento Fisher-Yates. Poiché tutti gli input del processo sono fissi, anche l’ordine risultante è fisso. Il seme 42 produce oggi esattamente la stessa risposta che produrrà in un’altra richiesta, in un altro ambiente o in una successiva esecuzione di test. Questa ripetibilità è lo scopo principale dello strumento. Uno sviluppatore può inserire un mazzo mescolato in un fixture senza conservare 52 valori, un docente può distribuire un esercizio comune e un gioco può registrare il seme necessario a ricostruire la distribuzione iniziale. La risposta riporta anche il seme, così i risultati salvati restano comprensibili. Sono ammessi soltanto interi JSON sicuri; decimali, stringhe numeriche, valori mancanti, infiniti e interi fuori dall’intervallo esatto di JavaScript vengono rifiutati senza arrotondamenti impliciti.

Legga correttamente l’ordine restituito

L’array <code>deck</code> contiene esattamente 52 stringhe univoche nell’ordine di pesca. Ogni stringa unisce un valore a un codice di una lettera per il seme. I valori sono <code>A</code>, da <code>2</code> a <code>10</code>, <code>J</code>, <code>Q</code> e <code>K</code>. I semi sono <code>S</code> per picche, <code>H</code> per cuori, <code>D</code> per quadri e <code>C</code> per fiori. Di conseguenza, <code>AS</code> indica l’asso di picche e <code>10D</code> il dieci di quadri. Il primo elemento dell’array è la carta in cima, seguito dalla seconda carta da pescare e dalle successive. La capacità non distribuisce mani, non aggiunge jolly, non valuta combinazioni di poker e non modifica l’ordine dopo averlo restituito. Queste scelte spettano all’applicazione chiamante. Per distribuire cinque carte a quattro giocatori, per esempio, consumi le prime venti voci secondo lo schema desiderato. Un risultato semplice ed esplicito evita assunzioni sulle regole del tavolo e rende l’intera permutazione facile da copiare, confrontare, serializzare o passare a un simulatore.

Usi responsabilmente il mescolamento deterministico

Un mescolamento deterministico è progettato per la riproducibilità, non per la segretezza. Chiunque conosca il seme e l’algoritmo può ricostruire l’intero mazzo. Questa capacità è quindi adatta a test, dimostrazioni, simulazioni, rompicapi con semi pubblicati e giochi in cui la possibilità di ripetere conta più dello stato nascosto. Non la usi per scommesse, premi, decisioni di sicurezza o situazioni nelle quali prevedere le carte future offrirebbe un vantaggio. In tali casi scelga una fonte casuale crittograficamente sicura e ne mantenga riservato lo stato. Nell’ambito previsto, il seme semplifica molto il debug: lo includa nel rapporto di un test fallito, ripeta localmente la stessa distribuzione e confronti il comportamento carta per carta. Può inoltre eseguire serie con semi consecutivi per ottenere scenari stabili senza archiviare grandi fixture nel controllo versione. L’implementazione non usa rete, orologio, stato globale mutabile, <code>Math.random</code> o dati esterni. La definizione fissa e i 51 scambi limitati rendono semplici da verificare sia l’esecuzione sia l’output.

Riprodurre un errore di gioco

Salvi il seme nel rapporto del problema e ricrei lo stesso mazzo iniziale durante il debug della distribuzione o del punteggio.

Preparare fixture di test stabili

Generi ordini mescolati realistici che restano invariati tra esecuzioni locali e integrazione continua.

Condividere una simulazione didattica

Assegni a ogni partecipante lo stesso seme affinché gli esercizi di probabilità partano da un mazzo identico.

Quanto costa una richiesta?

Il prezzo dell’API è $0.002 per richiesta; lo stesso mescolamento deterministico può essere eseguito gratuitamente nel browser.

Lo stesso seme restituisce sempre lo stesso mazzo?

Sì. Costruzione, generatore pseudocasuale e passaggi di mescolamento sono fissi, quindi un seme valido riproduce lo stesso ordine.

Quali carte sono comprese?

Il risultato include le 52 carte standard di picche, cuori, quadri e fiori, senza jolly.

Perché il mio seme è stato rifiutato?

Deve essere un intero JSON nell’intervallo sicuro ed esatto. Decimali, stringhe, valori mancanti e interi troppo grandi non sono validi.

Questo mescolamento è adatto a scommesse o sicurezza?

No. È intenzionalmente riproducibile e quindi prevedibile da chi conosce il seme e l’algoritmo.

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

POSThttps://api.kit.forhosting.com/game/card-deck-shuffle-seeded

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

curl -X POST https://api.kit.forhosting.com/game/card-deck-shuffle-seeded \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"seed":42}'
{
  "seed": 42
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.card_deck_shuffle_seeded",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

HTTPCodiceSignificato
401unauthorizedChiave API mancante o non valida: controlla l'header Authorization.
402insufficient_balanceCredito esaurito: ricarica per continuare a eseguire attività.
404unknown_typeTipo di attività sconosciuto: controlla il campo type della richiesta.
429rate_limitedTroppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →