Admin API — automatización sin login web

Bearer token, header X-Game-Id, integración MCP para Cursor

Base URL: https://gamepanel.idcgames.com/api/v1/admin

Inicia sesión en el panel y abre MCP Setup para generar el JSON listo para tu IA.

Admin API — Guía para IA y automatización



Esta API permite gestionar el Game Panel sin sesión web: juegos, plataformas (IDC/Steam/Epic), niveles, XP, inventario inicial, daily rewards y Battle Pass.

Base URL



{APP_URL}/api/v1/admin


Todas las respuestas JSON siguen:

{ "success": true, "message": "...", "data": ... }


Autenticación



Alta automática de estudio (recomendado para estudios)



El registro crea una cuenta pendiente y un juego inactivo. El operador debe habilitarlo explícitamente y proporcionar la clave de registro por un canal privado. En producción la clave nunca se publica.

Seguir STUDIO_ONBOARDING.md: registro → acceso al panel y verificación de correo → inscripción 2FA si se exige → login API → configuración MCP. La respuesta del registro no entrega credenciales.

1) Bootstrap (solo primera vez — operador IDC)



Si no existe ningún superadmin, crea uno con un secreto de entorno:

.env:

ADMIN_API_BOOTSTRAP_TOKEN=pon-un-secreto-largo-aleatorio


POST /api/v1/admin/auth/bootstrap
Content-Type: application/json

{
"bootstrap_token": "...",
"name": "Ops Bot",
"email": "ops@example.com",
"password": "",
"password_confirmation": ""
}


Respuesta incluye data.token (Bearer). Guárdalo; no se vuelve a mostrar.

2) Login (usuarios panel existentes)



Roles permitidos: superadmin, admin, manager.

Campos opcionales: include_mcp_setup: true devuelve el mismo bloque mcp_setup que el registro de estudio.

POST /api/v1/admin/auth/tokens
Authorization: Bearer gpa_...
{ "token_name": "cursor", "include_mcp_setup": true }


Emite un token nuevo para MCP sin contraseña.

POST /api/v1/admin/auth/mcp-client-config
Authorization: Bearer gpa_...

{
"mcp_server_script_path": "C:/ruta/.../mcp/gamepanel-admin-server/src/index.js"
}


Devuelve mcp_config_json_pretty listo para el cliente MCP que uses (Cursor, Claude Desktop, etc.). Query ?download=1 adjunta el JSON.

POST /api/v1/admin/auth/login
Content-Type: application/json

{
"email": "admin@example.com",
"password": "",
"token_name": "cursor-mcp"
}


3) CLI



php artisan admin:token admin@example.com --name=cursor


Uso del token



Authorization: Bearer gpa_...


Revocar el token actual:

POST /api/v1/admin/auth/logout
Authorization: Bearer gpa_...


Contexto de juego



Para recursos scoped por juego, envía el header:

X-Game-Id: 12


Los admin/manager pueden omitirlo (se usa su game_id). Los superadmin deben enviarlo salvo en GET /games.

Capabilities



GET /api/v1/admin/capabilities
Authorization: Bearer ...


Lista recursos soportados y presets de Battle Pass.

---

Juegos (superadmin: CRUD global; admin: solo su juego)



MétodoRutaDescripción
GET/gamesListar juegos accesibles
POST/gamesCrear juego (superadmin)
GET/games/{id}Detalle (secretos enmascarados)
PATCH/games/{id}Actualizar nombre, settings, progress_keys, monedas, platform_configs
PATCH/games/{id}/platforms/{platform}Parche parcial (idc, steam, epic, …)
POST/games/{id}/rotate-secretNuevo game_secret_token / gamepanel_secret_token (valor completo en respuesta)
POST/games/{id}/rotate-public-tokenNuevo game_public_token para login

Ejemplo parche Epic:

PATCH /api/v1/admin/games/5/platforms/epic
Authorization: Bearer ...
Content-Type: application/json

{
"enabled": true,
"client_id": "...",
"client_secret": "...",
"deployment_id": "..."
}


Registrar tenant (juego + admin) vía API (superadmin):

POST /api/v1/admin/auth/register-game-tenant


---

Level configuration



Header X-Game-Id obligatorio (superadmin).

  • GET /level-configurations

  • POST /level-configurations

  • PATCH /level-configurations/{id}

  • DELETE /level-configurations/{id}


  • ---

    XP configuration (GameKeyXpValue)



  • GET /xp-configurations

  • POST /xp-configurations

  • PATCH /xp-configurations/{id}

  • DELETE /xp-configurations/{id}


  • ---

    Inventario inicial



  • GET /initial-inventory

  • POST /initial-inventory

  • PATCH /initial-inventory/{id}

  • DELETE /initial-inventory/{id}


  • Items: item_variant_id o item_id + quantity.

    ---

    Daily rewards (una config por juego)



  • GET /daily-rewards

  • POST /daily-rewards

  • PATCH /daily-rewards


  • ---

    Battle Pass



  • GET /battle-pass/seasons

  • POST /battle-pass/seasons — crea temporada, aplica preset y primera ola

  • GET|PATCH /battle-pass/seasons/{id}

  • POST /battle-pass/seasons/{id}/levels

  • POST /battle-pass/seasons/{id}/missions — incluye mission_keys[] con operador =, >=, etc.

  • GET|POST /battle-pass/seasons/{id}/waves


  • Campos de temporada alineados con el panel (progression_preset, progression_mode, mission_unlock_mode, points_per_level, …).

    ---

    MCP (Cursor / Claude Desktop)



    Servidor incluido en mcp/gamepanel-admin-server/.

    Variables:

    GAMEPANEL_BASE_URL=https://tu-panel.example.com
    GAMEPANEL_ADMIN_TOKEN=gpa_...
    GAMEPANEL_GAME_ID=12


    Ver docs/MCP_GAMEPANEL_ADMIN.md.

    ---

    Seguridad



  • No commitear tokens ni ADMIN_API_BOOTSTRAP_TOKEN.

  • Rotar tokens MCP periódicamente (admin:token + revocar vía logout).

  • Credenciales de plataforma se almacenan cifradas; la API devuelve set en lecturas.