アカウント

REST API

独自のBot、Webサイト、ツールをサーバーに接続できます。Bearerトークン付きのHTTPS経由のJSONで、プレイヤーのIPやBattlEye GUIDが含まれることはありません。

リファレンス

エンドポイント

ベースURL https://dayzhub.cloud/api/v1/console · 1分あたり120リクエスト。

メソッド	パス	内容	スコープ
GET	/openapi.json	このAPIのOpenAPI 3.1ファイル(公開、トークン不要)。	公開
GET	/servers	状態、プレイヤー、実際のFPS、稼働時間を含むあなたのサーバー。	読み取り
GET	/servers/:serverId	1台のサーバーとオンラインの全員。	読み取り
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	サーバーが使うすべてのリストの有効なBAN。	読み取り
GET	/servers/:serverId/bans/:ban	IDで指定した1件のBAN:理由、証拠、有効・期限切れ・取り消しのどれか。	読み取り
POST	/servers/:serverId/bans	BAN: {"steamId":"7656…","minutes":0,"reason":"…"}（0 = 永久）。	書き込み
DELETE	/servers/:serverId/bans/:ban	サーバー自身のリストからBANを解除します。	書き込み
POST	/servers/:serverId/actions	オペレーションの任意の操作: {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"…	書き込み
POST	/servers/:serverId/kick	プレイヤーをキックし、本人に表示される理由を伝えます。	書き込み
POST	/servers/:serverId/message	1人のプレイヤーにメッセージを送るか、全員に一斉送信します。	書き込み
GET	/servers/:serverId/whitelist	ホワイトリスト:有効かどうかと、登録されているプレイヤー。	読み取り
POST	/servers/:serverId/whitelist	ホワイトリストにプレイヤーを追加します(最大5000人)。	書き込み
DELETE	/servers/:serverId/whitelist/:steamId	ホワイトリストからプレイヤーを削除します(有効な間は最後の1人は削除できません)。	書き込み
GET	/servers/:serverId/priority	順番待ちを飛ばせる優先プレイヤー。	読み取り
POST	/servers/:serverId/priority	優先リストにプレイヤーを追加します(最大1000人)。	書き込み
DELETE	/servers/:serverId/priority/:steamId	優先リストからプレイヤーを削除します。	書き込み
GET	/servers/:serverId/sessions	参加から退出までのプレイセッション(新しい順)。	読み取り
GET	/servers/:serverId/stats	プレイヤー数とFPSの履歴(5分ごとに1点)。	読み取り
GET	/servers/:serverId/leaderboard	ランキング:キル数、デス数、プレイ時間、最長キル、K/D、PvE K/D、感染者キル数。	読み取り
GET	/servers/:serverId/hud	ゲーム内ランキング HUD：7 つのランキングの上位プレイヤーと、指定したプレイヤーの順位。	読み取り
POST	/servers/:serverId/hud	HUD 呼び出しと同じ内容を POST で（DayZ ゲームサーバー用）。	読み取り
GET	/players/lookup	SteamID64または名前で、すべてのサーバーからプレイヤーを検索します。	読み取り

お金・銀行・ATM・ガレージ・拠点ワイプの操作はダッシュボードからのみ実行でき、トークンでは実行できません。

各トークンは1分あたり300回、1日あたり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個、固定の上限なし。

Discord bot (read) 読み取りdhca_…dhca_…d3m0 · 最終使用 -

Stats site (read, one server) 読み取り 1台のサーバー IP許可リストdhca_…dhca_…f4k3 · 最終使用 - · 有効期限 2027-02-08

イベント

署名付きWebhook

サーバーのイベントを署名付きJSONで自分のサイトやボットに送信します:参加、退出、キル、BAN、サーバー状態、報告、アラート。

Community dashboard 有効 hooks.demo-dayz.invalid/… · whsec_…whsec_…d3m0 · プレイヤー参加, プレイヤー退出, BAN追加, サーバーオフライン, サーバーオンライン · すべてのサーバー · 最終配信 - (200)

各配信はイベントIDを含むJSONで、重複の無視に使えます。失敗した配信は30秒後、2分後、10分後、1時間後、6時間後に再試行され、20回連続で失敗するとWebhookはオフになります。リプレイ許容時間:300秒。

署名の検証方法

X-DHC-Signature: t=1760000000,v1=<hex>
v1 = HMAC_SHA256(secret, t + "." + rawBody)