ForHosting KIT · Strumenti per sviluppatori

Estrazione ponderata e ripetibile del vincitore

Questo selettore con seme sceglie un nome da una lista ordinata e restituisce sempre lo stesso risultato finché lista, pesi e seme restano invariati.

● BetaGratis · nel tuo browser
Usalo da WebAPIEmailTelegramApp presto

Lei può assegnare una partecipazione a ogni persona oppure quantità maggiori per rappresentare azioni bonus, pacchetti di biglietti o altre regole pubblicate. Poiché il calcolo non usa l'orologio né una sorgente casuale nascosta, può salvare il seme e i dati insieme all'esito, ripetere successivamente l'estrazione e dimostrare con precisione come è stata scelta la persona vincitrice.

Prepari una lista ordinata con pesi corretti

Inizi con una riga per ogni partecipante e mantenga le righe in un ordine intenzionale e stabile. Ogni riga deve contenere un nome non vuoto. Il valore facoltativo entries è un numero intero positivo: lo ometta per assegnare una partecipazione, usi due per raddoppiare il peso di selezione e così via. Una persona con cinque partecipazioni occupa cinque posizioni nel bacino concettuale dei biglietti, mentre chi ne ha una occupa una sola posizione. Lo strumento non unisce i nomi duplicati perché potrebbero rappresentare record separati legittimi; accorparli senza avviso cambierebbe le probabilità pubblicate. Se la fonte può contenere duplicati, decida prima dell'estrazione se consolidarli e annoti tale decisione. Blocchi inoltre la lista ordinata definitiva prima di annunciare il seme. Ordinare, aggiungere o eliminare una riga, rinominare qualcuno o modificare una quantità cambia gli intervalli ponderati e può quindi cambiare il vincitore. Il calcolo accetta fino a 10,000 righe e convalida ogni peso, invece di arrotondare frazioni o accettare segnaposto con peso zero. Il contratto resta così chiaro: ogni riga inviata partecipa e ogni quantità dichiarata contribuisce direttamente alla sua probabilità.

Usi un seme per rendere ripetibile l'estrazione

Il seme può essere qualsiasi testo non vuoto scelto per l'estrazione, ad esempio un identificativo della campagna abbinato a un'etichetta della data di chiusura. Il selettore converte il testo esatto in un valore fisso senza segno a 32 bit mediante un hash documentato, quindi associa quel valore a una posizione nell'intervallo totale delle partecipazioni ponderate. Scorre i partecipanti nell'ordine fornito e restituisce la riga il cui intervallo cumulativo contiene tale posizione. Seme, ordine, nomi e quantità identici producono sempre lo stesso output sia nell'API sia nel browser. Maiuscole, spazi e punteggiatura del seme sono significativi: salvi la stringa originale esatta invece di riscriverla. Per una procedura pubblica, valuti di stabilire prima della chiusura come verrà ottenuto il seme, per esempio da un valore esterno chiaramente identificato e pubblicato dopo la scadenza. Lo strumento è deterministico, non crittograficamente casuale: serve a una selezione ripetibile e a una verifica semplice, non a generare un segreto imprevedibile. Non divulghi in anticipo un seme scelto liberamente se partecipanti o organizzatori possono ancora modificare la lista in base all'esito previsto.

Registri e verifichi il risultato vincente

Il risultato comprende il nome vincente, l'indice della relativa riga a partire da zero, la posizione ponderata selezionata anch'essa da zero, il totale delle partecipazioni e l'hash numerico ricavato dal seme. Conservi l'input completo con questi campi nel registro del concorso. Un revisore potrà inviare le stesse righe ordinate e lo stesso seme, confermare il totale e ottenere il medesimo vincitore senza fidarsi di uno screenshot o di un pulsante casuale privo di spiegazioni. L'indice distingue inoltre due record che mostrano lo stesso nome, mentre la posizione ponderata indica dove è caduta la scelta nel bacino concettuale. Se una nuova esecuzione produce un esito diverso, confronti i dati salvati carattere per carattere: persino un nome ripulito, una riga spostata, un peso corretto o una differenza tra maiuscole nel seme costituisce un'altra estrazione. La versione nel browser è adatta a una selezione manuale trasparente; l'API costa $0.002 per richiesta quando Lei deve automatizzare la procedura nel software della campagna o in un registro di audit. In entrambi i canali l'algoritmo non usa rete, ora corrente o stato modificabile, quindi ambiente e data di esecuzione non alterano la risposta.

Estrarre un premio sui social media

Blocchi i nomi idonei dopo la scadenza, pubblichi o archivi il seme e selezioni un vincitore riproducibile.

Applicare le regole delle partecipazioni bonus

Assegni quantità maggiori alle azioni valide mantenendo la selezione proporzionale ai pesi registrati.

Verificare la selezione di una campagna

Conservi l'input ordinato e i dati hash restituiti affinché un'altra persona possa riprodurre il risultato annunciato.

Quanto costa una singola estrazione?

Il prezzo dell'API è $0.002 per richiesta. Lo stesso calcolo deterministico può anche essere eseguito gratuitamente nel browser.

Cosa accade se il numero di partecipazioni viene omesso?

Alla persona viene assegnata una partecipazione. I pesi espliciti devono essere numeri interi positivi.

Lo stesso seme seleziona sempre lo stesso vincitore?

Sì, purché il seme e l'intera lista ordinata, compresi nomi e quantità, siano identici.

Cambiare l'ordine dei partecipanti influisce?

Sì. L'ordine definisce l'intervallo di ogni persona nel bacino ponderato, quindi riordinare le righe crea un input differente.

L'estrazione è crittograficamente casuale?

No. È un selettore deterministico e trasparente progettato per essere ripetibile. Se conta l'imprevedibilità, usi una fonte del seme che nessuno possa manipolare.

Perché i nomi duplicati restano separati?

Lo strumento rispetta ogni riga ricevuta perché i duplicati possono essere intenzionali. L'indice restituito identifica la riga vincente.

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/giveaway-winner-pick

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/giveaway-winner-pick \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entrants":[{"name":"Avery","entries":1},{"name":"Blake","entries":3},{"name":"Casey"}],"seed":"spring-campaign-2026"}'
{
  "entrants": [
    {
      "name": "Avery",
      "entries": 1
    },
    {
      "name": "Blake",
      "entries": 3
    },
    {
      "name": "Casey"
    }
  ],
  "seed": "spring-campaign-2026"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "game.giveaway_winner_pick",
  "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.

max_items10000
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 →