REST API
Podłącz własnego bota, stronę lub narzędzia do swoich serwerów. JSON przez HTTPS z tokenem Bearer; adresy IP graczy i GUID-y BattlEye nigdy się w nim nie pojawiają.
Endpointy
Bazowy URL https://dayzhub.cloud/api/v1/console · 120 zapytań na minutę.
| Metoda | Ścieżka | Co robi | Zakres |
|---|---|---|---|
| GET | /openapi.json | To API jako plik OpenAPI 3.1 (publiczny, token nie jest potrzebny). | publiczny |
| GET | /servers | Twoje serwery ze statusem, graczami, prawdziwym FPS i czasem działania. | odczyt |
| GET | /servers/:serverId | Jeden serwer i wszyscy gracze online. | odczyt |
| GET | /servers/:serverId/players | Gracze z czasem gry, sesjami, zabójstwami i śmierciami. | odczyt |
| GET | /servers/:serverId/events | Log: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | odczyt |
| GET | /servers/:serverId/bans | Aktywne bany na każdej liście, której używa serwer. | odczyt |
| GET | /servers/:serverId/bans/:ban | Jeden ban według jego ID: powód, dowody oraz czy jest aktywny, wygasły czy cofnięty. | odczyt |
| POST | /servers/:serverId/bans | Ban: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = na stałe). | zapis |
| DELETE | /servers/:serverId/bans/:ban | Zdejmij bana z własnej listy serwera. | zapis |
| POST | /servers/:serverId/actions | Dowolna akcja z Operacji: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | zapis |
| POST | /servers/:serverId/kick | Wyrzucić gracza z powodem, który zobaczy. | zapis |
| POST | /servers/:serverId/message | Wysłać wiadomość do jednego gracza lub do wszystkich. | zapis |
| GET | /servers/:serverId/whitelist | Biała lista: czy jest włączona i kto na niej jest. | odczyt |
| POST | /servers/:serverId/whitelist | Dodać graczy do białej listy (do 5000). | zapis |
| DELETE | /servers/:serverId/whitelist/:steamId | Usunąć gracza z białej listy (ostatniego nie można usunąć, gdy jest włączona). | zapis |
| GET | /servers/:serverId/priority | Gracze priorytetowi, którzy pomijają kolejkę. | odczyt |
| POST | /servers/:serverId/priority | Dodać graczy do listy priorytetowej (do 1000). | zapis |
| DELETE | /servers/:serverId/priority/:steamId | Usunąć gracza z listy priorytetowej. | zapis |
| GET | /servers/:serverId/sessions | Sesje gry od wejścia do wyjścia, od najnowszych. | odczyt |
| GET | /servers/:serverId/stats | Historia liczby graczy i FPS, jeden punkt co 5 minut. | odczyt |
| GET | /servers/:serverId/leaderboard | Ranking: zabójstwa, śmierci, czas gry, najdłuższe zabójstwo, K/D, K/D PvE lub zabici zainfekowani. | odczyt |
| GET | /servers/:serverId/hud | Ranking w grze: najlepsi gracze siedmiu rankingów i pozycje wskazanych graczy. | odczyt |
| POST | /servers/:serverId/hud | To samo co wywołanie HUD, jako POST (dla serwerów DayZ). | odczyt |
| GET | /players/lookup | Znaleźć gracza na wszystkich Twoich serwerach po SteamID64 lub nazwie. | odczyt |
Akcje dotyczące pieniędzy, banku, bankomatów, garaży i czyszczenia bazy można wykonać tylko w panelu, nigdy tokenem.
Każdy token może wysłać 300 żądań na minutę i 150000 na dobę (wyszukiwania i logi liczą się za więcej niż zwykły odczyt).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · Pełna dokumentacja i przykłady klientów są w docs/API.md i docs/sdk.
Tokeny
2 tokenów, bez stałego limitu.
Podpisane webhooki
Wysyłaj zdarzenia ze swoich serwerów na własną stronę lub bota jako podpisany JSON: wejścia, wyjścia, zabójstwa, bany, status serwera, zgłoszenia i alerty.
Każde dostarczenie to JSON z identyfikatorem zdarzenia, dzięki któremu pomijasz powtórki. Nieudane dostarczenia są ponawiane po 30 sekundach, 2 minutach, 10 minutach, 1 godzinie i 6 godzinach; po 20 porażkach z rzędu webhook jest wyłączany. Okno anty-replay: 300 sekund.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)