ForHosting KIT · Utilidades de desarrollo

Selector de ganador de sorteo con semilla

Este selector de ganadores con semilla elige un nombre de una lista ordenada y ofrece el mismo resultado siempre que la lista, los pesos y la semilla permanezcan iguales.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Asigne una participación a cada persona o cantidades mayores para reflejar acciones adicionales, paquetes de boletos u otras reglas publicadas. Como el cálculo no utiliza el reloj ni una fuente aleatoria oculta, usted puede guardar la semilla y los datos junto al resultado, repetir el sorteo más adelante y demostrar exactamente cómo se eligió a la persona ganadora.

Prepare una lista ordenada con pesos fieles a las reglas

Comience con una fila por participante y mantenga las filas en un orden deliberado y estable. Cada fila necesita un nombre que no esté vacío. El valor opcional entries es un número entero positivo: omítalo para asignar una participación, use dos para duplicar el peso de selección y así sucesivamente. Una persona con cinco participaciones ocupa cinco posiciones del conjunto conceptual de boletos, mientras que otra con una sola participación ocupa una posición. La herramienta no elimina nombres duplicados, porque podrían representar registros separados legítimos y unirlos sin aviso modificaría las probabilidades publicadas. Si la fuente puede contener duplicados, decida antes del sorteo si debe consolidarlos y documente esa decisión. También debe cerrar la lista ordenada definitiva antes de anunciar la semilla. Ordenar, añadir o quitar una fila, cambiar un nombre o modificar una cantidad altera los intervalos ponderados y puede cambiar el resultado. El cálculo admite hasta 10,000 filas y valida cada peso en lugar de redondear fracciones o aceptar marcadores con peso cero. Así, cada fila enviada participa y cada cantidad declarada contribuye directamente a su probabilidad.

Use una semilla para poder reproducir el sorteo

La semilla puede ser cualquier texto no vacío elegido para el sorteo, por ejemplo un identificador de campaña unido a una etiqueta de la fecha de cierre. La herramienta transforma el texto exacto en un valor fijo sin signo de 32 bits mediante un hash documentado y después lo asigna a una posición del intervalo total de participaciones ponderadas. Recorre los participantes en el orden recibido y devuelve la fila cuyo intervalo acumulado contiene esa posición. La misma semilla, el mismo orden, los mismos nombres y las mismas cantidades siempre generan idéntica salida tanto en la API como en el navegador. Las mayúsculas, los espacios y la puntuación de la semilla importan, por lo que debe guardar la cadena original exacta. Para un proceso público, considere comprometerse antes del cierre con el método para obtener la semilla, por ejemplo un valor claramente identificado de un acontecimiento externo publicado después del plazo. Esta herramienta es determinista, no criptográficamente aleatoria: busca ofrecer una selección repetible y fácil de auditar, no crear un secreto imprevisible. No revele demasiado pronto una semilla libremente elegida si todavía se puede alterar la lista según el resultado previsto.

Registre y verifique el resultado ganador

El resultado incluye el nombre ganador, el índice de su fila empezando en cero, la posición ponderada seleccionada también desde cero, el total de participaciones y el hash numérico derivado de la semilla. Conserve los datos completos junto con esos campos en el expediente del sorteo. Otra persona podrá enviar las mismas filas ordenadas y la misma semilla, confirmar el total y obtener al mismo ganador sin depender de una captura de pantalla ni de un botón aleatorio sin explicación. El índice distingue además dos registros que compartan el mismo nombre visible, mientras que la posición ponderada muestra dónde cayó la selección dentro del conjunto conceptual. Si una repetición ofrece otro resultado, compare los datos guardados carácter por carácter: incluso un nombre recortado, una fila reordenada, un peso ajustado o una semilla con otras mayúsculas representa un sorteo distinto. La versión del navegador resulta práctica para una selección manual transparente; la API cuesta $0.002 por solicitud cuando usted necesita automatizar el procedimiento en su software de campañas o registro de auditoría. En ambos canales, el algoritmo carece de red, hora actual y estado mutable, por lo que el entorno y la fecha de ejecución no cambian la respuesta.

Sortear un premio en redes sociales

Cierre la lista de personas válidas tras el plazo, publique o archive la semilla y elija un ganador reproducible.

Respetar reglas de participaciones adicionales

Asigne cantidades mayores por acciones válidas y mantenga una selección proporcional a los pesos registrados.

Auditar la selección de una campaña

Guarde los datos ordenados y el hash devuelto para que otra persona pueda reproducir el resultado anunciado.

¿Cuánto cuesta cada sorteo?

El precio de la API es $0.002 por solicitud. El mismo cálculo determinista también puede ejecutarse gratis en el navegador.

¿Qué ocurre si se omite la cantidad de participaciones?

Esa persona recibe una participación. Los pesos indicados deben ser números enteros positivos.

¿La misma semilla elige siempre al mismo ganador?

Sí, siempre que la semilla y la lista ordenada completa, incluidos nombres y cantidades, sean idénticas.

¿Importa cambiar el orden de los participantes?

Sí. El orden define el intervalo de cada persona en el conjunto ponderado, por lo que reordenar las filas crea otros datos de sorteo.

¿La selección es criptográficamente aleatoria?

No. Es un selector determinista y transparente diseñado para ser reproducible. Si necesita imprevisibilidad, use una fuente de semilla que nadie pueda manipular.

¿Por qué se conservan por separado los nombres duplicados?

La herramienta respeta cada fila recibida porque los registros duplicados pueden ser intencionados. El índice devuelto identifica la fila ganadora.

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

POSThttps://api.kit.forhosting.com/game/giveaway-winner-pick

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

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"
  }
}

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

max_items10000
HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →