API REST
Connectez votre propre bot, site ou outils à vos serveurs. JSON sur HTTPS avec un jeton Bearer ; les IP des joueurs et les GUID BattlEye n'y figurent jamais.
Endpoints
URL de base https://dayzhub.cloud/api/v1/console · 120 requêtes par minute.
| Méthode | Chemin | Ce qu'il fait | Portée |
|---|---|---|---|
| GET | /openapi.json | Cette API au format OpenAPI 3.1 (public, aucun jeton requis). | public |
| GET | /servers | Vos serveurs avec statut, joueurs, FPS réels et disponibilité. | lecture |
| GET | /servers/:serverId | Un serveur et tous les joueurs en ligne. | lecture |
| GET | /servers/:serverId/players | Joueurs avec temps de jeu, sessions, kills et morts. | lecture |
| GET | /servers/:serverId/events | Le journal : join, leave, kill, death, hit, aikill, placement, build, dismantle, destroy, base_hit, chat, admin, system. | lecture |
| GET | /servers/:serverId/bans | Bans actifs sur toutes les listes utilisées par le serveur. | lecture |
| GET | /servers/:serverId/bans/:ban | Un bannissement par son id : motif, preuves et s'il est actif, expiré ou révoqué. | lecture |
| POST | /servers/:serverId/bans | Bannir : {"steamId":"7656…","minutes":0,"reason":"…"} (0 = permanent). | écriture |
| DELETE | /servers/:serverId/bans/:ban | Lever un ban de la liste propre au serveur. | écriture |
| POST | /servers/:serverId/actions | N'importe quelle action des Opérations : {"action":"heal","steamId":"7656…"}, "message", "teleport", "give", "kick", "say", "restart"… | écriture |
| POST | /servers/:serverId/kick | Expulser un joueur avec un motif qu'il verra. | écriture |
| POST | /servers/:serverId/message | Envoyer un message à un joueur ou à tout le monde. | écriture |
| GET | /servers/:serverId/whitelist | La liste blanche : si elle est active et qui y figure. | lecture |
| POST | /servers/:serverId/whitelist | Ajouter des joueurs à la liste blanche (jusqu'à 5000). | écriture |
| DELETE | /servers/:serverId/whitelist/:steamId | Retirer un joueur de la liste blanche (le dernier ne peut pas partir tant qu'elle est active). | écriture |
| GET | /servers/:serverId/priority | Les joueurs prioritaires qui passent devant la file d'attente. | lecture |
| POST | /servers/:serverId/priority | Ajouter des joueurs à la liste prioritaire (jusqu'à 1000). | écriture |
| DELETE | /servers/:serverId/priority/:steamId | Retirer un joueur de la liste prioritaire. | écriture |
| GET | /servers/:serverId/sessions | Sessions de jeu de la connexion à la déconnexion, les plus récentes d'abord. | lecture |
| GET | /servers/:serverId/stats | Historique des joueurs et des FPS, un point toutes les 5 minutes. | lecture |
| GET | /servers/:serverId/leaderboard | Classement : éliminations, morts, temps de jeu, plus longue élimination, K/D, K/D PvE ou infectés tués. | lecture |
| GET | /servers/:serverId/hud | Classement en jeu : les meilleurs joueurs de sept classements et le rang des joueurs demandés. | lecture |
| POST | /servers/:serverId/hud | Identique à l'appel du HUD, en POST (pour les serveurs DayZ). | lecture |
| GET | /players/lookup | Trouver un joueur sur tous vos serveurs par SteamID64 ou pseudo. | lecture |
Les actions d’argent, de banque, de distributeur, de garage et d’effacement de base se font uniquement depuis le tableau de bord, jamais avec un jeton.
Chaque jeton peut faire 300 requêtes par minute et 150000 par jour (les recherches et les journaux comptent plus qu'une simple lecture).
curl -H "Authorization: Bearer dhca_…" \ https://dayzhub.cloud/api/v1/console/servers/dhc_demo_survive/events?type=kill&limit=20
openapi.json · La documentation complète et les exemples de client se trouvent dans docs/API.md et docs/sdk.
Jetons
2 jetons, sans limite fixe.
Webhooks signés
Envoyez les événements de vos serveurs vers votre site ou bot en JSON signé : connexions, déconnexions, éliminations, bannissements, état du serveur, signalements et alertes.
Chaque envoi est du JSON avec un id d'événement qui permet d'ignorer les doublons. Les envois échoués sont retentés après 30 secondes, 2 minutes, 10 minutes, 1 heure et 6 heures ; le webhook est désactivé après 20 échecs d'affilée. Fenêtre anti-rejeu : 300 secondes.
X-DHC-Signature: t=1760000000,v1=<hex> v1 = HMAC_SHA256(secret, t + "." + rawBody)