Přeskočit na obsah

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:

URL
https://vip.blazehost.cz/s/tvuj-server?p=ID_PRODUKTU&player=Notch&qty=3&gift=1&coupon=LETO20

p 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.

HTTP
GET https://vip.blazehost.cz/api/public/v1/stores/tvuj-server
JSON
{
  "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.

JavaScript
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č.

HTTP
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 platby
  • code.redeemed — uplatněný dárkový / giveaway kód
  • delivery.completed · delivery.failed — doručení na server. delivery.failed přijde až po vyčerpání pokusů (objednávka se refunduje) nebo po pádu serveru uprostřed doručení (ruční kontrola) a nese orderNumber, error (původní text pluginu) a errorText (česky pro lidi).
  • payout.requested · payout.completed · payout.rejected · payout.failed — výplaty
  • server.offline · server.online — stav pluginu
  • test.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í).

Node.js
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));
}
PHP
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']);
}
Ověřuj podpis nad surovým tělem požadavku (před parsováním JSON) a stejné doručení může výjimečně přijít dvakrát — deduplikuj podle 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.