API REST
Liga o teu próprio bot, site ou ferramentas aos teus servidores. JSON por HTTPS com um token Bearer; os IPs dos jogadores e os GUIDs do BattlEye nunca aparecem.
Endpoints
URL base https://dayzhub.cloud/api/v1/console · 120 pedidos por minuto.
| Método | Caminho | O que faz | Âmbito |
|---|---|---|---|
| GET | /openapi.json | Esta API como ficheiro OpenAPI 3.1 (público, não precisa de token). | público |
| GET | /servers | Os teus servidores com estado, jogadores, FPS reais e tempo online. | leitura |
| GET | /servers/:serverId | Um servidor e todos os que estão online. | leitura |
| GET | /servers/:serverId/players | Jogadores com tempo de jogo, sessões, kills e mortes. | leitura |
| GET | /servers/:serverId/events | O registo: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | leitura |
| GET | /servers/:serverId/bans | Bans ativos em todas as listas que o servidor usa. | leitura |
| GET | /servers/:serverId/bans/:ban | Um banimento pelo seu id: motivo, provas e se está ativo, expirado ou revogado. | leitura |
| POST | /servers/:serverId/bans | Banir: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = permanente). | escrita |
| DELETE | /servers/:serverId/bans/:ban | Levantar um ban da lista própria do servidor. | escrita |
| POST | /servers/:serverId/actions | Qualquer ação de Operações: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | escrita |
| POST | /servers/:serverId/kick | Expulsar um jogador com um motivo que ele vê. | escrita |
| POST | /servers/:serverId/message | Enviar uma mensagem a um jogador ou a todos. | escrita |
| GET | /servers/:serverId/whitelist | A whitelist: se está ligada e quem está nela. | leitura |
| POST | /servers/:serverId/whitelist | Adicionar jogadores à whitelist (até 5000). | escrita |
| DELETE | /servers/:serverId/whitelist/:steamId | Remover um jogador da whitelist (o último não sai enquanto estiver ligada). | escrita |
| GET | /servers/:serverId/priority | Os jogadores prioritários que passam à frente na fila. | leitura |
| POST | /servers/:serverId/priority | Adicionar jogadores à lista de prioridade (até 1000). | escrita |
| DELETE | /servers/:serverId/priority/:steamId | Remover um jogador da lista de prioridade. | escrita |
| GET | /servers/:serverId/sessions | Sessões de jogo da entrada à saída, as mais recentes primeiro. | leitura |
| GET | /servers/:serverId/stats | Histórico de jogadores e FPS, um ponto de 5 em 5 minutos. | leitura |
| GET | /servers/:serverId/leaderboard | Classificação: abates, mortes, tempo de jogo, abate mais longo, K/D, K/D PvE ou infetados abatidos. | leitura |
| GET | /servers/:serverId/hud | Classificação no jogo: os melhores jogadores de sete tabelas e a posição dos jogadores pedidos. | leitura |
| POST | /servers/:serverId/hud | O mesmo que a chamada do HUD, como POST (para servidores DayZ). | leitura |
| GET | /players/lookup | Encontrar um jogador em todos os teus servidores por SteamID64 ou nome. | leitura |
As ações de dinheiro, banco, ATM, garagem e limpeza de base só podem ser feitas no painel, nunca com um token.
Cada token pode fazer 300 pedidos por minuto e 150000 por dia (as pesquisas e os registos contam mais do que uma leitura simples).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · A documentação completa e os exemplos de cliente estão em docs/API.md e docs/sdk.
Tokens
2 tokens, sem limite fixo.
Webhooks assinados
Envia os eventos dos teus servidores para o teu site ou bot como JSON assinado: entradas, saídas, abates, banimentos, estado do servidor, denúncias e alertas.
Cada entrega é JSON com um id de evento que serve para ignorar repetições. As entregas falhadas são repetidas após 30 segundos, 2 minutos, 10 minutos, 1 hora e 6 horas; o webhook é desligado após 20 falhas seguidas. Janela anti-repetição: 300 segundos.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)