Bot API

Mit építhetsz vele

A Bot API lehetővé teszi, hogy a saját weboldalad vagy eszközeid élő adatokat olvassanak a Discord-szerveredről. Csak olvas. Semmi, amit vele építesz, nem változtathatja meg a szerveredet, és nem nyúlhat a tagjaidhoz. Íme néhány ötlet, amit egy délután alatt be lehet állítani.

• Ranglista-widgetMutasd meg a 10 legmagasabb szintű túlélődet a közösséged weboldalán.
• Nyereményjáték visszaszámlálóTedd ki a kezdőlapodra a futó nyereményjátékot, a nyereményét és a befejezési idejét.
• Jegyek számaMutasd meg, hány jegy van nyitva és milyen gyorsan válaszol a csapatod, egy staff irányítópulton vagy egy "körülbelül 10 percen belül válaszolunk" szalagcímen.
• ÁllapotjelvényJelenítsd meg, hogy a játékszervered online van-e, és hány játékos van rajta.
• Bolti terméklistaListázd az Adománybolt termékeit árakkal a saját oldaladon, és linkelj egyenesen a fizetéshez.

Lépésről lépésre: hozd létre a tokenedet

A token egy hosszú titkos jelszó, amellyel egy weboldal vagy eszköz olvashatja a szerveredet. Az irányítópultodon hozod létre.

1. 01

   Nyisd meg a Bot API oldalt

   Jelentkezz be a dayzhub.net oldalon, nyisd meg az irányítópultot, válaszd ki a szervered, és az oldalmenü Kezelés részében válaszd a Bot API pontot. Csak a Szerver kezelése jogosultsággal rendelkezők látják. A csapathozzáférés tagjai nem.

2. 02

   Adj neki nevet

   Írj be egy rövid nevet, amiből tudod, mire való, például "Weboldal ranglista". Weboldalanként vagy eszközönként használj külön tokent.

3. 03

   Válaszd ki, mit olvashat

   Jelöld be a négyzeteket a szükséges adatokhoz, például nyereményjátékok vagy a szintranglista. Minél kevesebb négyzet, annál biztonságosabb. Később bármikor készíthetsz másik tokent.

4. 04

   Engedélyezett weboldal (csak néha)

   Hagyd üresen, kivéve ha egy weboldal közvetlenül a látogatóid böngészőjéből hívja az API-t. Ebben az esetben pontosan írd be az oldalad címét, például https://yoursite.com, útvonal nélkül a végén.

5. 05

   Nyomd meg a Token létrehozása gombot, és másold ki

   Megjelenik egy doboz a tokenneddel, ami dhba_ előtaggal kezdődik. Nyomd meg a Másolás gombot, és azonnal illeszd be egy biztonságos helyre. Csak egyszer jelenik meg. Ha elveszted, újat hozol létre.

6. 06

   Tartsd titokban

   Kezeld a tokent jelszóként. Ne tedd ki Discordra, ne rakd nyilvános GitHub-projektbe, és ne másold be olyan weboldalba, amelyet a látogatók olvashatnak. Tartsd a saját szervereden vagy egy jelszókezelőben.

Az első kérésed

Ellenőrizzük, hogy működik-e a tokened. Két dologra van szükséged: az éppen kimásolt tokenre és a szervered azonosítójára (a Discordban kapcsold be a Fejlesztői módot a beállításokban, majd kattints jobb gombbal a szerveredre, és válaszd a Szerver azonosítójának másolása pontot). Az alábbi első híváshoz csak a token kell.

Minden példában cseréld ki a dhba_YOUR_TOKEN szöveget a valódi tokenedre. Mindegyik az Authorization nevű fejlécben küldi el a tokent. A webcímbe tenni nem működik.

Windows PowerShell (use curl.exe with the .exe, plain curl means something else in PowerShell)

curl.exe -H "Authorization: Bearer dhba_YOUR_TOKEN" https://dayzhub.net/api/v1/bot/me

curl (macOS, Linux and most hosting)

curl -H "Authorization: Bearer dhba_YOUR_TOKEN" https://dayzhub.net/api/v1/bot/me

JavaScript on your own server (Node 18 or newer). Keep the token in an environment variable.

const res = await fetch("https://dayzhub.net/api/v1/bot/guilds/YOUR_SERVER_ID/giveaways?status=active", {
  headers: { Authorization: "Bearer " + process.env.DAYZHUB_BOT_API_TOKEN }
});
const { ok, data } = await res.json();
console.log(data);

JavaScript in a visitor's browser (needs the Allowed website setting on the token, and shows the token to everyone, so use a token with the fewest boxes ticked)

fetch("https://dayzhub.net/api/v1/bot/guilds/YOUR_SERVER_ID/leaderboard/levels?limit=10", {
  headers: { Authorization: "Bearer dhba_YOUR_TOKEN" }
}).then(r => r.json()).then(j => console.log(j.data));

Mit kapsz vissza

Minden válasz JSON. A sikeres válaszokban "ok": true és az adataid szerepelnek. A listák "page" résszel jönnek: ha a "hasMore" értéke true, küldd vissza a "nextCursor" értéket ?cursor= formában a következő oldalhoz. A dátumok UTC szerint vannak.

GET /me: who the token belongs to

{
  "ok": true,
  "data": {
    "guildId": "123456789012345678",
    "name": "Website leaderboard",
    "prefix": "dhba_aB3dE",
    "scopes": ["leveling:read", "giveaways:read"],
    "allowedOrigin": null,
    "rateLimitPerMin": 60,
    "createdAt": "2026-10-01T12:00:00.000Z",
    "plan": "premium1",
    "limits": { "tokens": 2, "perMinute": 60 },
    "tokensUsed": 1
  }
}

GET /guilds/ID/leaderboard/levels?limit=2

{
  "ok": true,
  "data": [
    { "rank": 1, "member": { "id": "111111111111111111", "anonymous": false }, "xp": 18450, "level": 27 },
    { "rank": 2, "member": { "id": null, "anonymous": true }, "xp": 17020, "level": 26 }
  ],
  "page": { "limit": 2, "hasMore": true, "nextCursor": "eyJpZCI6IjY..." }
}

GET /guilds/ID/giveaways?status=active

{
  "ok": true,
  "data": [{
    "id": "6650f0c2a1b2c3d4e5f60718",
    "prize": "Premium VIP for 30 days",
    "status": "active",
    "type": "reaction",
    "winnerCount": 1,
    "entryCount": 86,
    "endsAt": "2026-10-08T18:00:00.000Z",
    "requirements": { "role": false, "verified": true, "minInvites": 0 },
    "host": { "id": "111111111111111111", "anonymous": false },
    "winners": []
  }],
  "page": { "limit": 25, "hasMore": false, "nextCursor": null }
}

GET /guilds/ID/tickets/summary

{
  "ok": true,
  "data": {
    "open": 4,
    "closed": 212,
    "total": 216,
    "last30Days": { "created": 38, "closed": 41, "averageRating": 4.7, "ratingCount": 29, "averageFirstResponseMinutes": 9.5 },
    "byCategory": [ { "category": "Support", "open": 3, "closed": 150 } ]
  }
}

GET /guilds/ID/shop/products

{
  "ok": true,
  "shop": { "name": "Survivor HQ Shop", "description": "Support the server", "slug": "survivor-hq", "url": "https://dayzhub.net/shop/survivor-hq" },
  "data": [{
    "id": "6650f0c2a1b2c3d4e5f60999", "name": "VIP Role", "slug": "vip-role", "description": "Priority queue and a gold name",
    "price": 9.99, "compareAtPrice": null, "currency": "EUR", "type": "subscription", "interval": "monthly",
    "thumbnailUrl": null, "featured": true, "inStock": true, "url": "https://dayzhub.net/shop/survivor-hq/vip-role"
  }],
  "page": { "limit": 25, "hasMore": false, "nextCursor": null }
}

GET /guilds/ID/server-status

{
  "ok": true,
  "data": {
    "listed": true,
    "servers": [{ "name": "Survivor HQ", "slug": "survivor-hq", "url": "https://dayzhub.net/s/survivor-hq", "online": true, "players": 42, "maxPlayers": 60, "address": "game.yourserver.gg:2302", "lastChangeAt": "2026-10-01T09:30:00.000Z" }]
  }
}

When something is wrong, for example a mixed-up server ID (HTTP 403)

{ "ok": false, "error": "guild_mismatch", "code": "guild_mismatch", "message": "This token belongs to another server", "requestId": "3f2b8c1e-5a7d-4e0b-9c64-1d2e3f4a5b6c" }

A végpontok teljes listája és minden mező a gépek által olvasható leírásban található, a /api/v1/bot/openapi.json címen. Minden válasz tartalmazza az X-Request-Id fejlécet, a hibák pedig requestId néven megismétlik. Add meg, amikor az ügyfélszolgálatot keresed.

Korlátok, csomagok és adatvédelem

• Csak olvashatóNincs olyan gomb, amely bármit megváltoztatna. Csak a GET kérésekre érkezik válasz.
• CsomagokA szervered fizetős csomagot vagy aktív ingyenes próbát igényel. A nyereményjáték-adatokhoz Premium 2 kell. A bolt listájához valódi fizetős hozzáférés kell, mert az ingyenes próba nem tartalmazza az Adománybolt funkciót.
• Hány tokened lehetA Premium 1 2 aktív tokent tartalmaz, a Premium 2 5-öt, a Premium 3 pedig 10-et. Az ingyenes próba vagy a szponzorált szerver Premium 1-nek számít. Vond vissza, amit már nem használsz, így helyet szabadítasz fel. Ha a csomagod lejjebb megy, a meglévő tokenjeid tovább működnek. Csak újat nem hozhatsz létre, amíg a korlát alá nem kerülsz.
• SebességkorlátokMinden token Premium 1 mellett percenként 60, Premium 2 mellett 120, Premium 3 mellett 300 kérést küldhet, egy internetcím pedig percenként 300-at. A korlát felett 429-es választ kapsz Retry-After fejléccel, amely megmondja, hány másodpercet kell várnod.
• Kíméletes lekérdezésA válaszok tartalmaznak egy ETag értéket. Küldd vissza If-None-Match fejlécben, és ha semmi sem változott, a teljes adat helyett egy apró 304-es választ kapsz. A 30-60 másodpercenkénti lekérdezés bőven elég, a legtöbb widget ritkábban is kérdezhet.
• Ami soha nem kerül megosztásraA jegyek átiratai és üzenetei, a jelentkezések és válaszaik, a fizetések és rendelések, az e-mail-címek, a nevek és profilképek, valamint a nyereményjátékra jelentkezők. Csak számokat kapsz, valamint numerikus Discord-azonosítókat ott, ahol a funkció már most nyilvánosan mutatja az embereket a Discordban, például a nyereményjáték szervezőjét vagy a szintranglistát.
• Az adatkezelés ellen tiltakozó tagokAki használta a /privacy optout parancsot, mindig névtelenként jelenik meg (az id értéke null). A helyezése és a számai továbbra is beleszámítanak, így az összegek stimmelnek.

Hibaelhárítás

Token visszavonása és cseréje

Azonnal tedd meg, ha egy tokent véletlenül megosztottak, nyilvánosan kitettek, vagy valaki, aki ismerte, elhagyta a csapatodat.

1. 01

   Előbb hozd létre az új tokent

   A Bot API oldalon hozz létre egy pótlást ugyanazokkal a beállításokkal, és másold ki.

2. 02

   Állítsd át a weboldalad vagy eszközöd

   Tedd az új tokent mindenhová, ahol a régit használtad, és ellenőrizd, hogy minden még működik.

3. 03

   Vond vissza a régit

   A tokenjeid listájában nyomd meg a Visszavonás gombot a régin, és erősítsd meg. Azonnal leáll, és minden, ami még használja, 401-et kap. A létrehozás és a visszavonás bekerül a szervered audit naplójába, maga a token soha.

Gyakori kérdések