REST API
Collega ai tuoi server il tuo bot, sito o strumenti. JSON su HTTPS con un token Bearer; gli IP dei giocatori e i GUID BattlEye non ci sono mai.
Endpoint
URL di base https://dayzhub.cloud/api/v1/console · 120 richieste al minuto.
| Metodo | Percorso | Cosa fa | Ambito |
|---|---|---|---|
| GET | /openapi.json | Questa API come file OpenAPI 3.1 (pubblico, nessun token necessario). | pubblico |
| GET | /servers | I tuoi server con stato, giocatori, FPS reali e uptime. | lettura |
| GET | /servers/:serverId | Un server più tutti quelli online. | lettura |
| GET | /servers/:serverId/players | Giocatori con tempo di gioco, sessioni, uccisioni e morti. | lettura |
| GET | /servers/:serverId/events | Il log: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | lettura |
| GET | /servers/:serverId/bans | Ban attivi su ogni lista usata dal server. | lettura |
| GET | /servers/:serverId/bans/:ban | Un ban tramite il suo id: motivo, prove e se è attivo, scaduto o revocato. | lettura |
| POST | /servers/:serverId/bans | Ban: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = permanente). | scrittura |
| DELETE | /servers/:serverId/bans/:ban | Rimuovi un ban dalla lista del server. | scrittura |
| POST | /servers/:serverId/actions | Qualsiasi azione di Operazioni: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | scrittura |
| POST | /servers/:serverId/kick | Espellere un giocatore con un motivo che vedrà. | scrittura |
| POST | /servers/:serverId/message | Inviare un messaggio a un giocatore o a tutti. | scrittura |
| GET | /servers/:serverId/whitelist | La whitelist: se è attiva e chi vi compare. | lettura |
| POST | /servers/:serverId/whitelist | Aggiungere giocatori alla whitelist (fino a 5000). | scrittura |
| DELETE | /servers/:serverId/whitelist/:steamId | Rimuovere un giocatore dalla whitelist (l'ultimo non si può togliere finché è attiva). | scrittura |
| GET | /servers/:serverId/priority | I giocatori con priorità che saltano la coda. | lettura |
| POST | /servers/:serverId/priority | Aggiungere giocatori all'elenco priorità (fino a 1000). | scrittura |
| DELETE | /servers/:serverId/priority/:steamId | Rimuovere un giocatore dall'elenco priorità. | scrittura |
| GET | /servers/:serverId/sessions | Sessioni di gioco dall'ingresso all'uscita, le più recenti per prime. | lettura |
| GET | /servers/:serverId/stats | Storico di giocatori e FPS, un punto ogni 5 minuti. | lettura |
| GET | /servers/:serverId/leaderboard | Classifica: uccisioni, morti, tempo di gioco, uccisione più lunga, K/D, K/D PvE o infetti uccisi. | lettura |
| GET | /servers/:serverId/hud | Classifica in gioco: i migliori giocatori di sette classifiche e la posizione dei giocatori richiesti. | lettura |
| POST | /servers/:serverId/hud | Uguale alla chiamata dell'HUD, come POST (per i server DayZ). | lettura |
| GET | /players/lookup | Trovare un giocatore su tutti i tuoi server tramite SteamID64 o nome. | lettura |
Le azioni su denaro, banca, bancomat, garage e cancellazione della base si possono eseguire solo dalla dashboard, mai con un token.
Ogni token può fare 300 richieste al minuto e 150000 al giorno (ricerche e log contano più di una semplice lettura).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · La documentazione completa e gli esempi di client sono in docs/API.md e docs/sdk.
Token
2 token, nessun limite fisso.
Webhook firmati
Invia gli eventi dei tuoi server al tuo sito o bot come JSON firmato: ingressi, uscite, uccisioni, ban, stato del server, segnalazioni e avvisi.
Ogni invio è JSON con un id evento con cui ignorare i duplicati. Gli invii falliti vengono ritentati dopo 30 secondi, 2 minuti, 10 minuti, 1 ora e 6 ore; il webhook si disattiva dopo 20 errori di fila. Finestra anti-replay: 300 secondi.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)