REST API
Připojte ke svým serverům vlastního bota, web nebo nástroje. JSON přes HTTPS s tokenem Bearer; IP adresy hráčů ani GUID BattlEye v něm nikdy nejsou.
Endpointy
Základní URL https://dayzhub.cloud/api/v1/console · 120 požadavků za minutu.
| Metoda | Cesta | Co dělá | Rozsah |
|---|---|---|---|
| GET | /openapi.json | Toto API jako soubor OpenAPI 3.1 (veřejný, token není potřeba). | veřejné |
| GET | /servers | Vaše servery se stavem, hráči, skutečným FPS a dobou běhu. | čtení |
| GET | /servers/:serverId | Jeden server a všichni hráči online. | čtení |
| GET | /servers/:serverId/players | Hráči s herní dobou, relacemi, zabitími a úmrtími. | čtení |
| GET | /servers/:serverId/events | Log: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | čtení |
| GET | /servers/:serverId/bans | Aktivní bany na každém seznamu, který server používá. | čtení |
| GET | /servers/:serverId/bans/:ban | Jeden ban podle jeho ID: důvod, důkazy a zda je aktivní, vypršel nebo byl zrušen. | čtení |
| POST | /servers/:serverId/bans | Ban: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = trvale). | zápis |
| DELETE | /servers/:serverId/bans/:ban | Zrušit ban na vlastním seznamu serveru. | zápis |
| POST | /servers/:serverId/actions | Libovolná akce z Operací: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | zápis |
| POST | /servers/:serverId/kick | Vyhodit hráče s důvodem, který uvidí. | zápis |
| POST | /servers/:serverId/message | Poslat zprávu jednomu hráči nebo všem. | zápis |
| GET | /servers/:serverId/whitelist | Whitelist: zda je zapnutý a kdo na něm je. | čtení |
| POST | /servers/:serverId/whitelist | Přidat hráče na whitelist (max. 5000). | zápis |
| DELETE | /servers/:serverId/whitelist/:steamId | Odebrat hráče z whitelistu (posledního nejde odebrat, dokud je zapnutý). | zápis |
| GET | /servers/:serverId/priority | Prioritní hráči, kteří přeskakují frontu. | čtení |
| POST | /servers/:serverId/priority | Přidat hráče do prioritního seznamu (max. 1000). | zápis |
| DELETE | /servers/:serverId/priority/:steamId | Odebrat hráče z prioritního seznamu. | zápis |
| GET | /servers/:serverId/sessions | Herní relace od připojení po odpojení, nejnovější první. | čtení |
| GET | /servers/:serverId/stats | Historie počtu hráčů a FPS, jeden bod každých 5 minut. | čtení |
| GET | /servers/:serverId/leaderboard | Žebříček: zabití, smrti, odehraný čas, nejdelší zabití, K/D, PvE K/D nebo zabití nakažených. | čtení |
| GET | /servers/:serverId/hud | Žebříček ve hře: nejlepší hráči sedmi žebříčků a pořadí zadaných hráčů. | čtení |
| POST | /servers/:serverId/hud | Stejné jako volání HUD, jako POST (pro herní servery DayZ). | čtení |
| GET | /players/lookup | Najít hráče na všech vašich serverech podle SteamID64 nebo jména. | čtení |
Akce s penězi, bankou, bankomaty, garážemi a mazáním základny lze spustit jen z panelu, nikdy tokenem.
Každý token smí poslat 300 požadavků za minutu a 150000 za den (vyhledávání a logy se počítají víc než prosté čtení).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · Úplná dokumentace a ukázky klientů jsou v docs/API.md a docs/sdk.
Tokeny
2 tokenů, bez pevného limitu.
Podepsané webhooky
Posílejte události ze svých serverů na vlastní web nebo bota jako podepsaný JSON: připojení, odpojení, zabití, bany, stav serveru, hlášení a výstrahy.
Každé doručení je JSON s ID události, podle kterého ignorujete opakování. Neúspěšná doručení se opakují po 30 sekundách, 2 minutách, 10 minutách, 1 hodině a 6 hodinách; po 20 neúspěších v řadě se webhook vypne. Okno proti opakování: 300 sekund.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)