API REST
Conecta tu propio bot, web o herramientas a tus servidores. JSON por HTTPS con un token Bearer; las IP de los jugadores y los GUID de BattlEye nunca aparecen.
Endpoints
URL base https://dayzhub.cloud/api/v1/console · 120 peticiones por minuto.
| Método | Ruta | Qué hace | Alcance |
|---|---|---|---|
| GET | /openapi.json | Esta API como archivo OpenAPI 3.1 (público, no hace falta token). | público |
| GET | /servers | Tus servidores con estado, jugadores, FPS reales y tiempo activo. | lectura |
| GET | /servers/:serverId | Un servidor y todos los que están en línea. | lectura |
| GET | /servers/:serverId/players | Jugadores con tiempo de juego, sesiones, kills y muertes. | lectura |
| GET | /servers/:serverId/events | El registro: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | lectura |
| GET | /servers/:serverId/bans | Baneos activos en todas las listas que usa el servidor. | lectura |
| GET | /servers/:serverId/bans/:ban | Un baneo por su id: motivo, pruebas y si está activo, caducado o revocado. | lectura |
| POST | /servers/:serverId/bans | Banear: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = permanente). | escritura |
| DELETE | /servers/:serverId/bans/:ban | Levantar un baneo de la lista propia del servidor. | escritura |
| POST | /servers/:serverId/actions | Cualquier acción de Operaciones: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | escritura |
| POST | /servers/:serverId/kick | Expulsar a un jugador con un motivo que él verá. | escritura |
| POST | /servers/:serverId/message | Enviar un mensaje a un jugador o a todos. | escritura |
| GET | /servers/:serverId/whitelist | La whitelist: si está activa y quién está en ella. | lectura |
| POST | /servers/:serverId/whitelist | Añadir jugadores a la whitelist (hasta 5000). | escritura |
| DELETE | /servers/:serverId/whitelist/:steamId | Quitar a un jugador de la whitelist (el último no se puede quitar mientras esté activa). | escritura |
| GET | /servers/:serverId/priority | Los jugadores con prioridad que se saltan la cola. | lectura |
| POST | /servers/:serverId/priority | Añadir jugadores a la lista de prioridad (hasta 1000). | escritura |
| DELETE | /servers/:serverId/priority/:steamId | Quitar a un jugador de la lista de prioridad. | escritura |
| GET | /servers/:serverId/sessions | Sesiones de juego de la entrada a la salida, las más recientes primero. | lectura |
| GET | /servers/:serverId/stats | Historial de jugadores y FPS, un punto cada 5 minutos. | lectura |
| GET | /servers/:serverId/leaderboard | Clasificación: bajas, muertes, tiempo de juego, baja más lejana, K/D, K/D PvE o infectados abatidos. | lectura |
| GET | /servers/:serverId/hud | Clasificación en el juego: los mejores jugadores de siete tablas y los puestos de los jugadores pedidos. | lectura |
| POST | /servers/:serverId/hud | Lo mismo que la llamada del HUD, como POST (para servidores de DayZ). | lectura |
| GET | /players/lookup | Buscar a un jugador en todos tus servidores por SteamID64 o nombre. | lectura |
Las acciones de dinero, banco, cajero, garaje y borrado de base solo se pueden hacer desde el panel, nunca con un token.
Cada token puede hacer 300 peticiones por minuto y 150000 al día (las búsquedas y los registros cuentan más que una lectura simple).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · La documentación completa y los ejemplos de cliente están en docs/API.md y docs/sdk.
Tokens
2 tokens, sin límite fijo.
Webhooks firmados
Envía los eventos de tus servidores a tu web o bot como JSON firmado: entradas, salidas, bajas, baneos, estado del servidor, denuncias y alertas.
Cada envío es JSON con un id de evento que sirve para ignorar repeticiones. Los envíos fallidos se reintentan a los 30 segundos, 2 minutos, 10 minutos, 1 hora y 6 horas; el webhook se desactiva tras 20 fallos seguidos. Ventana anti-repetición: 300 segundos.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)