Web API, webhooky a Discord
Tři způsoby, jak propojit obchod s vlastním webem, botem nebo databází: odkazy na produkty (tlačítko „Koupit“ na tvém webu), veřejné JSON API s produkty a cenami a webhooky, které ti pošlou každou událost. K tomu oficiální Discord bot s logy.
Odkazy a tlačítko na web
Platba, souhlasy s podmínkami i doručení vždy proběhnou v tvém obchodě na vip.blazehost.cz/s/tvuj-server. Z webu tam hráče pošleš odkazem — volitelně s předvyplněným produktem, hráčem a množstvím:
https://vip.blazehost.cz/s/tvuj-server?p=ID_PRODUKTU&player=Notch&qty=3&gift=1&coupon=LETO20p otevře nákup produktu, player předvyplní hráče, qty množství (jen jednorázové produkty), gift=1 zapne nákup jako dárek a coupon rovnou použije slevový kód. Hotový odkaz i HTML tlačítko najdeš v panelu: Server → Obchod → Tlačítko a API.
Veřejné JSON API
Jen pro čtení, bez přihlášení a s povoleným CORS — můžeš ho volat přímo z prohlížeče na svém webu.
GET https://vip.blazehost.cz/api/public/v1/stores/tvuj-server{
"store": { "name": "Můj Survival", "slug": "tvuj-server", "game": "MINECRAFT",
"url": "https://vip.blazehost.cz/s/tvuj-server", "logoUrl": "…", "checkoutOpen": true },
"categories": [{ "id": "…", "name": "Ranky" }],
"products": [{
"id": "clx…", "name": "VIP", "kind": "VIP", "durationDays": 30, "maxQuantity": 1,
"price": { "amount": 11900, "currency": "CZK", "formatted": "119 Kč" },
"regularPrice": { "amount": 14900, "currency": "CZK", "formatted": "149 Kč" },
"priceEur": { "amount": 499, "currency": "EUR", "formatted": "4,99 €" }, // null = jen v Kč
"regularPriceEur": null,
"alwaysAsCode": false,
"checkoutUrlEur": "https://vip.blazehost.cz/s/blazecraft?p=…&cur=EUR",
"saleEndsAt": "2026-10-31T23:00:00.000Z",
"perks": ["/fly"], "giftable": true, "categoryId": "…", "imageUrl": null,
"checkoutUrl": "https://vip.blazehost.cz/s/tvuj-server?p=clx…"
}]
}Ceny jsou v haléřích (amount). price je vždy to, co hráč právě zaplatí; během akce je vyplněné regularPrice (běžná cena k přeškrtnutí) a případně saleEndsAt, jinak jsou null. Odpověď se cachuje 60 s, limit je 120 požadavků za minutu z jedné IP.
const res = await fetch('https://vip.blazehost.cz/api/public/v1/stores/tvuj-server');
const { products } = await res.json();
for (const p of products) {
console.log(p.name, p.price.formatted, p.checkoutUrl);
}Webhooky
V panelu (Server → Integrace → Webhooky) přidáš HTTPS adresu a vybereš události. Při každé události pošleme POST s JSON tělem. Odpověz kódem 2xx do 8 sekund; jinak to zkusíme znovu (po 1 min, 5 min, 30 min, 2 h a 6 h). Po 15 neúspěších v řadě se webhook vypne a v panelu uvidíš proč.
POST /tvuj-endpoint
Content-Type: application/json
User-Agent: BlazeHost-Webhooks/1.0
X-BlazeHost-Event: order.paid
X-BlazeHost-Delivery: cly… (unikátní ID doručení – použij pro deduplikaci)
X-BlazeHost-Signature: t=1767225600,v1=5f2b…
{
"id": "clx…", "type": "order.paid", "created": "2026-10-01T12:00:00.000Z",
"server": { "id": "…", "slug": "tvuj-server", "name": "Můj Survival" },
"data": { "orderNumber": "VIP-20261001-AB12CD", "packageName": "VIP", "kind": "VIP", "quantity": 1,
"amount": 14900, "net": 12665, "currency": "CZK", "provider": "GOPAY",
"player": "Notch", "identifierType": "MC_NAME", "gift": false, "expiresAt": "…" }
}Události
order.paid·gift.purchased·order.refunded·order.disputed— nákupy a platbycode.redeemed— uplatněný dárkový / giveaway kóddelivery.completed·delivery.failed— doručení na server.delivery.failedpřijde až po vyčerpání pokusů (objednávka se refunduje) nebo po pádu serveru uprostřed doručení (ruční kontrola) a neseorderNumber,error(původní text pluginu) aerrorText(česky pro lidi).payout.requested·payout.completed·payout.rejected·payout.failed— výplatyserver.offline·server.online— stav pluginutest.ping— tlačítko „Test“ v panelu
Ověření podpisu
Podpis je HMAC-SHA256 tajným klíčem webhooku (zobrazí se jednou při vytvoření, v panelu ho můžeš kdykoli vyměnit) přes řetězec "<t>.<tělo požadavku>". Odmítni požadavky starší než 5 minut (ochrana proti přehrání).
import crypto from 'node:crypto';
export function verify(rawBody, header, secret) {
const { t, v1 } = Object.fromEntries(header.split(',').map((p) => p.split('=')));
if (Math.abs(Date.now() / 1000 - Number(t)) > 300) return false;
const expected = crypto.createHmac('sha256', secret).update(`${t}.${rawBody}`).digest('hex');
return crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v1));
}function verify(string $raw, string $header, string $secret): bool {
parse_str(str_replace(',', '&', $header), $p);
if (abs(time() - (int) $p['t']) > 300) return false;
return hash_equals(hash_hmac('sha256', $p['t'] . '.' . $raw, $secret), $p['v1']);
}X-BlazeHost-Delivery.Oficiální Discord bot
V Server → Integrace → Discord bot tlačítkem „Připojit Discord“ přidáš bota BlazeHost na svůj Discord server (tím zároveň ověříš, že ho spravuješ) a přidáš kanály z tohoto serveru, kam má posílat logy — do každého kanálu jiné události (např. #nakupy jen nákupy, #staff doručení a stav serveru). Stejný bot přiděluje a odebírá Discord role u VIP balíčků. Bot nikdy nikoho neoznačuje (žádné @everyone).
Vlastní integrace doručení
Chceš doručovat jinam než přes oficiální plugin (jiná hra, vlastní systém)? Použij stejné HTTP API jako plugin — vyzvedni doručení, proveď je a potvrď. Popis najdeš v API reference a v návodu Vývoj vlastního pluginu. Kódy lze uplatnit i voláním POST /api/plugin/v1/redeem s tokenem serveru.