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/adminTodas 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-aleatorioPOST /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=cursorUso 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: 12Los
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étodo | Ruta | Descripción |
|---|---|---|
| GET | /games | Listar juegos accesibles |
| POST | /games | Crear 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-secret | Nuevo game_secret_token / gamepanel_secret_token (valor completo en respuesta) |
| POST | /games/{id}/rotate-public-token | Nuevo 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-configurationsPOST /level-configurationsPATCH /level-configurations/{id}DELETE /level-configurations/{id}GET /xp-configurationsPOST /xp-configurationsPATCH /xp-configurations/{id}DELETE /xp-configurations/{id}GET /initial-inventoryPOST /initial-inventoryPATCH /initial-inventory/{id}DELETE /initial-inventory/{id}GET /daily-rewardsPOST /daily-rewardsPATCH /daily-rewardsGET /battle-pass/seasonsPOST /battle-pass/seasons— crea temporada, aplica preset y primera olaGET|PATCH /battle-pass/seasons/{id}POST /battle-pass/seasons/{id}/levelsPOST /battle-pass/seasons/{id}/missions— incluyemission_keys[]con operador=,>=, etc.GET|POST /battle-pass/seasons/{id}/waves
---
XP configuration (GameKeyXpValue)
---
Inventario inicial
Items:
item_variant_id o item_id + quantity.---
Daily rewards (una config por juego)
---
Battle Pass
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=12Ver
docs/MCP_GAMEPANEL_ADMIN.md.---
Seguridad
ADMIN_API_BOOTSTRAP_TOKEN.admin:token + revocar vÃa logout).set en lecturas.