Owner API a AI agenti
Programový přístup k tvým VIP obchodům: servery, objednávky, hráči s aktivním VIP, výdělky a výplaty. Stejné operace jsou dostupné jako REST API (/api/v1) i jako MCP server (/api/mcp) pro AI asistenty (Claude, ChatGPT, Cursor…). Strojově čitelný kontrakt: /api/v1/openapi.json.
Token
Vytvoříš ho v sekci Majitel → API tokeny → „Owner API a AI agenti“. Zobrazí se jednou, platí 30 dní až rok a přestane fungovat okamžitě po zneplatnění, změně hesla nebo odhlášení ze všech zařízení. Pro každou integraci si vytvoř vlastní token, ať jde zrušit samostatně.
Authorization: Bearer bvo_TVUJ_TOKENOprávnění (scopes):
servers:read servery, stav obchodu, balíčky, stav pluginu
orders:read objednávky a stav jejich doručení
players:read hráči s aktivním VIP
earnings:read zůstatky, kniha výdělků, historie výplat
deliveries:test testovací doručení (neškodný "say" broadcast, nic neuděluje)REST API
curl -H "Authorization: Bearer $BVO" https://vip.blazehost.cz/api/v1/servers
curl -H "Authorization: Bearer $BVO" "https://vip.blazehost.cz/api/v1/orders?status=PAID&limit=50"
curl -H "Authorization: Bearer $BVO" https://vip.blazehost.cz/api/v1/servers/SERVER_ID/diagnosticsSeznamy jsou seřazené od nejnovějšího a stránkují se kurzorem: odpověď obsahuje nextCursor, který pošleš jako ?cursor=…; null znamená konec. limit je 1–100. Částky jsou v haléřích (10000 = 100,00 Kč) s uvedenou měnou.
Chyby a limity
{ "error": "This token lacks the \"earnings:read\" scope.",
"code": "INSUFFICIENT_SCOPE", "requiredScope": "earnings:read",
"requestId": "6f1c…" }Rozhoduj se podle code (např. UNAUTHENTICATED, INSUFFICIENT_SCOPE, NOT_FOUND, VALIDATION_ERROR, INVALID_CURSOR, RATE_LIMITED, TOO_MANY_OPEN_TESTS), text se může změnit. Cizí ID vrací stejné 404 jako neexistující. Limit: 120 požadavků v nárazu, 2 za sekundu průběžně na token; po překročení 429 s hlavičkou Retry-After.
MCP pro AI asistenty
Endpoint POST /api/mcp (Streamable HTTP, bezstavový). Asistent uvidí jen nástroje, na které má token oprávnění: list_servers, get_server, get_server_diagnostics, list_orders, get_order, list_active_vips, get_earnings_summary, list_earnings_ledger, list_payouts, send_test_delivery, get_test_delivery.
# Claude Code
claude mcp add --transport http blazehost-vip https://vip.blazehost.cz/api/mcp \
--header "Authorization: Bearer bvo_TVUJ_TOKEN"