REST API
Kösd a saját botodat, weboldaladat vagy eszközeidet a szervereidhez. JSON HTTPS-en keresztül Bearer tokennel; a játékosok IP-címe és a BattlEye GUID-ok sosem szerepelnek benne.
Végpontok
Alap URL https://dayzhub.cloud/api/v1/console · percenként 120 kérés.
| Metódus | Útvonal | Mit csinál | Hatókör |
|---|---|---|---|
| GET | /openapi.json | Ez az API OpenAPI 3.1 fájlként (nyilvános, nem kell hozzá token). | nyilvános |
| GET | /servers | A szervereid állapottal, játékosokkal, valós FPS-sel és üzemidővel. | olvasás |
| GET | /servers/:serverId | Egy szerver és mindenki, aki online. | olvasás |
| GET | /servers/:serverId/players | Játékosok játékidővel, munkamenetekkel, ölésekkel és halálokkal. | olvasás |
| GET | /servers/:serverId/events | A napló: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | olvasás |
| GET | /servers/:serverId/bans | Aktív kitiltások minden listán, amit a szerver használ. | olvasás |
| GET | /servers/:serverId/bans/:ban | Egy tiltás az azonosítója alapján: indok, bizonyítékok, és hogy aktív, lejárt vagy visszavont. | olvasás |
| POST | /servers/:serverId/bans | Kitiltás: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = végleges). | írás |
| DELETE | /servers/:serverId/bans/:ban | Kitiltás feloldása a szerver saját listáján. | írás |
| POST | /servers/:serverId/actions | Bármelyik Műveletek-akció: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | írás |
| POST | /servers/:serverId/kick | Játékos kirúgása indoklással, amit ő is lát. | írás |
| POST | /servers/:serverId/message | Üzenet küldése egy játékosnak vagy mindenkinek. | írás |
| GET | /servers/:serverId/whitelist | A fehérlista: be van-e kapcsolva, és kik vannak rajta. | olvasás |
| POST | /servers/:serverId/whitelist | Játékosok hozzáadása a fehérlistához (legfeljebb 5000). | írás |
| DELETE | /servers/:serverId/whitelist/:steamId | Játékos eltávolítása a fehérlistáról (az utolsó nem törölhető, amíg be van kapcsolva). | írás |
| GET | /servers/:serverId/priority | A prioritásos játékosok, akik átugorják a sort. | olvasás |
| POST | /servers/:serverId/priority | Játékosok hozzáadása a prioritási listához (legfeljebb 1000). | írás |
| DELETE | /servers/:serverId/priority/:steamId | Játékos eltávolítása a prioritási listáról. | írás |
| GET | /servers/:serverId/sessions | Játékmenetek csatlakozástól kilépésig, a legújabbak elöl. | olvasás |
| GET | /servers/:serverId/stats | A játékosszám és az FPS története, 5 percenként egy pont. | olvasás |
| GET | /servers/:serverId/leaderboard | Ranglista: ölések, halálok, játékidő, leghosszabb ölés, K/D, PvE K/D vagy megölt fertőzöttek. | olvasás |
| GET | /servers/:serverId/hud | Játékon belüli ranglista: hét ranglista legjobb játékosai és a kért játékosok helyezése. | olvasás |
| POST | /servers/:serverId/hud | Ugyanaz, mint a HUD-hívás, POST-ként (DayZ játékszerverekhez). | olvasás |
| GET | /players/lookup | Játékos keresése az összes szervereden SteamID64 vagy név alapján. | olvasás |
A pénz-, bank-, ATM-, garázs- és bázistörlés-műveletek csak az irányítópultról futtathatók, tokennel soha.
Minden token percenként 300, naponta 150000 kérést küldhet (a keresések és a naplók többet számítanak, mint az egyszerű olvasás).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · A teljes dokumentáció és a kliens példák a docs/API.md és a docs/sdk helyen vannak.
Tokenek
2 token, nincs fix korlát.
Aláírt webhookok
Küldd a szervereid eseményeit a saját weboldaladnak vagy botodnak aláírt JSON-ként: belépések, kilépések, ölések, tiltások, szerverállapot, jelentések és riasztások.
Minden kézbesítés JSON, eseményazonosítóval, amellyel az ismétlések figyelmen kívül hagyhatók. A sikertelen kézbesítéseket 30 másodperc, 2 perc, 10 perc, 1 óra és 6 óra múlva újrapróbáljuk; 20 egymás utáni hiba után a webhook kikapcsol. Visszajátszási ablak: 300 másodperc.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)