API Documentation

Integra AlexHoursBoost en tu propio servidor, bot o aplicación.

Base URL: https://alexlamasg.lat/api Auth: API Key Format: JSON

Cómo Empezar

1
Registrarte

Crea una cuenta en alexlamasg.lat/register

2
Generar API Key

Ve a Configuración → API Keys → Generar

3
Integrar

Usa tu API key con los endpoints documentados abajo

Autenticación

Todas las peticiones autenticadas requieren el header X-Api-Key:

X-Api-Key: ahb_tu_api_key_aqui
Seguridad: No compartas tu API key. Cada key tiene permisos ligados a tu cuenta y plan.

Rate Limits

PlanPeticiones/minNotas
Free30Ideal para uso personal
Pro120Para bots y automatización
Enterprise500Servidores de alto tráfico

Códigos de Error

CódigoSignificado
400Petición inválida — faltan parámetros
401API key no proporcionada
403API key inválida o límite de plan
404Recurso no encontrado
409Conflicto — recurso ya existe
429Demasiadas peticiones — rate limit
500Error interno del servidor

Mi Cuenta

GET /api/v1/me Obtiene información de tu cuenta
Request
curl -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/me
Response
{ "username": "alex", "plan": "pro", "max_accounts": 5, "max_hours": 500 }

Cuentas Steam

GET /api/v1/accounts Lista todas tus cuentas
curl -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/accounts
{ "accounts": [ { "id": 1, "account_name": "mysteam", "steam_id64": "76561198...", "status": "online", "total_hours_boosted": 125.5, "is_boosting": true, "created_at": "2025-01-15T..." } ] }
POST /api/v1/accounts Agrega una cuenta Steam
Parameters
CampoTipoRequeridoDescripción
account_namestringNombre de usuario Steam
passwordstringContraseña de la cuenta
shared_secretstringNoShared secret de Steam Guard Mobile
curl -X POST https://alexlamasg.lat/api/v1/accounts \ -H "X-Api-Key: ahb_tu_key" \ -H "Content-Type: application/json" \ -d '{"account_name":"misteam","password":"pass123","shared_secret":"abc="}'
{ "success": true, "account_id": 42 }
DELETE /api/v1/accounts/:id Elimina una cuenta
curl -X DELETE -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/accounts/42

Control de Boost

POST /api/v1/accounts/:id/start Inicia el boost de una cuenta
curl -X POST -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/accounts/1/start
{ "success": true, "message": "Boost started for account #1" }
POST /api/v1/accounts/:id/stop Detiene el boost de una cuenta
curl -X POST -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/accounts/1/stop
GET /api/v1/accounts/:id/status Estado detallado de una cuenta
curl -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/accounts/1/status
{ "id": 1, "account_name": "misteam", "steam_id64": "76561198...", "status": "online", "total_hours_boosted": 125.5, "is_boosting": true, "bot_status": "playing" }

Juegos

POST /api/v1/accounts/:id/games Agrega juegos para boost
CampoTipoRequeridoDescripción
gamesarrayArray de objetos con app_id y game_name
curl -X POST https://alexlamasg.lat/api/v1/accounts/1/games \ -H "X-Api-Key: ahb_tu_key" \ -H "Content-Type: application/json" \ -d '{"games":[{"app_id":730,"game_name":"CS2"},{"app_id":570,"game_name":"Dota 2"}]}'
{ "success": true, "added": 2 }
GET /api/v1/accounts/:id/games Lista juegos de una cuenta
curl -H "X-Api-Key: ahb_tu_key" https://alexlamasg.lat/api/v1/accounts/1/games
{ "games": [ { "id": 1, "app_id": 730, "game_name": "CS2" }, { "id": 2, "app_id": 570, "game_name": "Dota 2" } ] }

Estado del Servidor

GET /api/v1/server/status Sin autenticación requerida
curl https://alexlamasg.lat/api/v1/server/status
{ "server_status": "online", "active_bots": 23, "version": "1.0.0" }

Ejemplos de Integración

Node.js Python Bash PHP
const API_KEY = 'ahb_tu_key_aqui'; const BASE = 'https://alexlamasg.lat/api/v1'; // Listar cuentas const res = await fetch(`${BASE}/accounts`, { headers: { 'X-Api-Key': API_KEY } }); const data = await res.json(); console.log(data.accounts); // Iniciar boost await fetch(`${BASE}/accounts/1/start`, { method: 'POST', headers: { 'X-Api-Key': API_KEY } }); // Agregar juegos await fetch(`${BASE}/accounts/1/games`, { method: 'POST', headers: { 'X-Api-Key': API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ games: [ { app_id: 730, game_name: 'Counter-Strike 2' }, { app_id: 570, game_name: 'Dota 2' } ] }) });

SDKs & Wrappers

Node.js SDK
npm install alexhoursboost-sdk
Próximamente
Python SDK
pip install alexhoursboost
Próximamente

¿Listo para empezar?

Genera tu primera API key y empieza a integrar.

Generar API Key