Desarrolladores

Qué hace

Cinco puntos finales, una acción cada uno: elegir ganadores de una lista, repartir una lista en equipos equilibrados, publicar una lista como ruleta compartida, hacer un sorteo con registro publicado y volver a leer ese registro para comprobarlo. Cada respuesta correcta lleva un enlace a una página que una persona puede abrir, así que el asistente que la usó puede mostrar cómo llegó al resultado.

Gratis, como el resto

No hay plan de pago, ni facturación, ni tarjeta. La clave es gratuita y viene con una cuenta, y una cuenta es un correo y un enlace — sin contraseña. Aquí nada suma a una factura; los límites de abajo existen para que quien llama una vez no se gaste la capacidad del día de los demás.

Conseguir una clave

Entra en la página de tu cuenta y pulsa el botón. La clave se muestra una sola vez, porque solo guardamos su huella — cópiala en ese momento. Envíala en una cabecera Authorization: Bearer. Puedes tener varias claves, ponerles nombre para saber qué programa lleva cuál y revocar cualquiera cuando quieras.

Cuenta

Límites

Sin clave: 60 llamadas al día desde una dirección. Con clave: 5000 llamadas al día para la cuenta, tenga las claves que tenga. Las dos ventanas se reinician a medianoche UTC. Superado el margen, la respuesta es 429 y una cabecera que dice cuántos segundos esperar.

No es una herramienta de juegos de azar

Nunca toca dinero. No hay boletos, ni cuotas de entrada, ni premios, ni probabilidades de ganar en ninguna parte ni en ningún idioma, y no los habrá: una herramienta que gestionara eso sería otro producto con otra licencia. Úsala para elegir con justicia dentro de una lista que ya tienes.

Las condiciones

A la API le valen las mismas condiciones que a las páginas, más tres cosas: no puede usarse para juegos de azar por dinero, ni para acosar, ni para promover la violencia o la autolesión; los límites pueden cambiar sin avisar; y no hay ninguna promesa de nivel de servicio, así que no montes nada crítico encima.

Términos

Versiones y cambios

La versión va en la ruta. Un cambio que rompería a quien llama sale como versión nueva y no como retoque de esta, y una versión retirada sigue respondiendo al menos seis meses después de anunciarse aquí su retirada. En una respuesta pueden aparecer campos nuevos en cualquier momento, así que léelos con tolerancia.

El servidor MCP

Un asistente que habla el Model Context Protocol puede hacer todo esto sin escribir HTTP por su cuenta. El servidor responde en una sola dirección, un mensaje por petición, sin sesión que abrir ni cerrar, y ofrece cuatro herramientas: elegir un ganador, formar equipos, publicar una ruleta y comprobar un sorteo que hizo otra persona. Gasta la misma clave y las mismas llamadas al día que los puntos finales, así que nada de lo que puedes hacer cambia según la puerta por la que entres. Los nombres de las herramientas de abajo forman parte del protocolo, así que están en inglés.

POST /mcp

pick_winner
make_teams
create_wheel
verify_draw

Referencia

Cada punto final, sus campos y las respuestas que puede dar. La descripción de lo mismo para máquinas está en un solo archivo:

/openapi.json

La referencia de los puntos finales está escrita en inglés.