REST API
Подключите своего бота, сайт или инструменты к своим серверам. JSON по HTTPS с Bearer-токеном; IP игроков и GUID BattlEye там никогда не бывает.
Эндпоинты
Базовый URL https://dayzhub.cloud/api/v1/console · 120 запросов в минуту.
| Метод | Путь | Что делает | Права |
|---|---|---|---|
| GET | /openapi.json | Это API в виде файла OpenAPI 3.1 (публичный, токен не нужен). | публичный |
| GET | /servers | Ваши серверы со статусом, игроками, реальным FPS и аптаймом. | чтение |
| GET | /servers/:serverId | Один сервер и все, кто онлайн. | чтение |
| GET | /servers/:serverId/players | Игроки со временем в игре, сессиями, убийствами и смертями. | чтение |
| GET | /servers/:serverId/events | Лог: join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | чтение |
| GET | /servers/:serverId/bans | Активные баны во всех списках, которые использует сервер. | чтение |
| GET | /servers/:serverId/bans/:ban | Один бан по ID: причина, доказательства и статус - активен, истёк или отозван. | чтение |
| POST | /servers/:serverId/bans | Бан: {"steamId":"7656…","minutes":0,"reason":"…"} (0 = навсегда). | запись |
| DELETE | /servers/:serverId/bans/:ban | Снять бан из собственного списка сервера. | запись |
| POST | /servers/:serverId/actions | Любое действие из Операций: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | запись |
| POST | /servers/:serverId/kick | Кикнуть игрока с причиной, которую он увидит. | запись |
| POST | /servers/:serverId/message | Отправить сообщение одному игроку или всем. | запись |
| GET | /servers/:serverId/whitelist | Белый список: включён ли он и кто в нём. | чтение |
| POST | /servers/:serverId/whitelist | Добавить игроков в белый список (до 5000). | запись |
| DELETE | /servers/:serverId/whitelist/:steamId | Убрать игрока из белого списка (последнего нельзя убрать, пока список включён). | запись |
| GET | /servers/:serverId/priority | Приоритетные игроки, которые проходят без очереди. | чтение |
| POST | /servers/:serverId/priority | Добавить игроков в приоритетный список (до 1000). | запись |
| DELETE | /servers/:serverId/priority/:steamId | Убрать игрока из приоритетного списка. | запись |
| GET | /servers/:serverId/sessions | Игровые сессии от входа до выхода, сначала новые. | чтение |
| GET | /servers/:serverId/stats | История онлайна и FPS, одна точка каждые 5 минут. | чтение |
| GET | /servers/:serverId/leaderboard | Рейтинг: убийства, смерти, время игры, самое дальнее убийство, K/D, PvE K/D или убитые зараженные. | чтение |
| GET | /servers/:serverId/hud | Таблица лидеров в игре: лучшие игроки семи рейтингов и места запрошенных игроков. | чтение |
| POST | /servers/:serverId/hud | То же, что вызов HUD, через POST (для игровых серверов DayZ). | чтение |
| GET | /players/lookup | Найти игрока на всех ваших серверах по SteamID64 или нику. | чтение |
Действия с деньгами, банком, банкоматами, гаражами и очисткой базы доступны только в панели, но не через токен.
Каждый токен может делать 300 запросов в минуту и 150000 в сутки (поиск и логи считаются дороже простого чтения).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · Полная документация и примеры клиентов лежат в docs/API.md и docs/sdk.
Токены
2 токенов, без жёсткого лимита.
Подписанные вебхуки
Отправляйте события ваших серверов на свой сайт или бота в виде подписанного JSON: входы, выходы, убийства, баны, статус сервера, жалобы и оповещения.
Каждая доставка - это JSON с идентификатором события, по которому можно игнорировать повторы. Неудачные доставки повторяются через 30 секунд, 2 минуты, 10 минут, 1 час и 6 часов; после 20 неудач подряд вебхук отключается. Окно защиты от повторов: 300 секунд.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)