Bot API

Crear una cuenta BOT

Una cuenta BOT la controla un programa. No es lo mismo que jugar contra el Stockfish integrado.

1. Registra la cuenta

Cierra tu sesión personal, registra un nombre público para el bot e inicia sesión con esa cuenta nueva. Si ya tiene una partida, el backend rechazará la conversión.

2. Crea el token

Abre Tokens API, escribe para qué usarás el token y selecciona solamente bot:play. Copia el secreto cuando aparezca: No ManChess almacena su hash y no puede volver a mostrártelo.

3. Convierte la cuenta

En la misma pantalla, acepta la advertencia y pulsa “Convertir permanentemente”. El backend vuelve a comprobar la cuenta y sus partidas antes de cambiarla a BOT.

POST /api/bot/account/upgrade
Authorization: Bearer <TOKEN_BOT_PLAY>

4. Ejecuta un cliente

Tu programa debe guardar el token en una variable de entorno, consultar retos, aceptar solamente los controles que soporte, abrir el stream de cada partida y enviar movimientos UCI. El backend valida jugadas, reloj, turno y resultado.

GET  /api/bot/status
GET  /api/bot/challenges
POST /api/bot/challenges/:id/accept
GET  /api/bot/game/:id/stream
POST /api/bot/game/:id/move/e2e4

5. Comprueba que está disponible

Mientras el cliente mantiene un stream activo, la cuenta puede aparecer en Bots en línea. Apagar el programa la desconecta; no elimina la cuenta.

Seguridad y operación

Token filtrado: Revócalo inmediatamente en Tokens API y genera uno nuevo.
El bot no aparece: Comprueba que el cliente esté ejecutándose, que use bot:play y que haya abierto un stream autenticado.
Cuenta con partidas: No se puede convertir. Crea otra cuenta nueva.
Cuenta administrativa: No es elegible. Los bots nunca deben recibir permisos administrativos.