Csomagok és kulcsok
Standard: 1 csak olvasható kulcs. Pro: legfeljebb 5 kulcs, amelyek írni is tudnak (whitelist, prioritási lista, kirúgás, üzenet, kitiltások), valamint aláírt webhookok. Community: korlátlan kulcs, játékoskeresés és ranglisták, magasabb korlátok. A Free csomagban nincs kulcs.
- Nyisd meg az API oldalt, és válaszd az Új token lehetőséget.
- Nevezd el, válassz olvasást vagy írást, és ha szeretnéd, korlátozd néhány szerverre vagy egy lejárati dátumra.
- Másold ki a tokent: csak egyszer jelenik meg.
Hívások és korlátok
JSON HTTPS-en a https://dayzhub.cloud/api/v1/console címen, Authorization: Bearer fejléccel és a tokeneddel. Minden kulcsnak saját korlátja van percenként és naponta (Standard 30 és 3000, Pro 120 és 30000, Community 300 és 150000). A játékosok IP-címei és BattlEye GUID-jai sosem szerepelnek benne.
Az API oldal megmutatja a pontos alap-URL-t, a géppel olvasható OpenAPI-leírás pedig nyilvános a /api/v1/console/openapi.json címen.
Aláírt webhookok (Pro)
A saját végpontod aláírt JSON-ként kapja a csatlakozásokat, kilépéseket, öléseket, kitiltásokat, a szerver állapotát, a bejelentéseket és a riasztásokat, újrapróbálkozásokkal és kézbesítési naplóval. Adj hozzá egy végpontot az API oldalon, és másold ki a titkát (whsec_...).
Az aláírás ellenőrzése
- Olvasd ki az X-DHC-Timestamp és az X-DHC-Signature fejlécet: az aláírás így néz ki: t=1760000000,v1=abc.
- Számítsd ki az időbélyeg, egy pont és a pontos nyers kérés törzs HMAC-SHA256 értékét a végpontod titkával, kisbetűs hexadecimálisként.
- Hasonlítsd össze minden v1 értékkel állandó idejű összehasonlítással.
- Utasítsd el a kézbesítést, ha az időbélyeg több mint 5 percet tér el az órádtól, és hagyd figyelmen kívül azt az eseményazonosítót, amelyet már feldolgoztál.
Jó tudni: A törzs nyers bájtjait használd, bármilyen JSON-feldolgozás előtt. A Node, Python, curl és PowerShell példák az API-referenciában vannak.