REST API dokumentace

Přístup k databázi kasinových her z Casinokatalog.cz. Použijte API pro zobrazení her, filtrování podle poskytovatele nebo kasina a získání detailních informací o každé hře.

Base URL

https://www.casinokatalog.cz

Autentizace

API klíč (X-API-Key)

Formát

JSON / HTTPS

Autentizace

Každý požadavek musí obsahovat platný API klíč. Klíč lze zaslat dvěma způsoby:

Varianta 1 — HTTP hlavička (doporučeno)

HTTP

GET /api/games
X-API-Key: váš-api-klíč

Varianta 2 — Query parametr

HTTP

GET /api/games?api_key=váš-api-klíč

⚠️ API klíč je citlivý údaj. Nikdy ho neuvádějte přímo v klientském (prohlížečovém) JavaScriptu. Používejte ho výhradně na serveru.

Endpointy

Příklady volání

Načtení prvních 10 slotů od Pragmatic Play (JavaScript / fetch)

JavaScript

const response = await fetch(
  "https://www.casinokatalog.cz/api/games?limit=10&type=slot&providerSlug=pragmatic-play",
  {
    headers: {
      "X-API-Key": "váš-api-klíč"
    }
  }
)
const data = await response.json()
console.log(data.games)       // pole her
console.log(data.totalCount)  // celkový počet výsledků
console.log(data.nextCursor)  // kurzor pro další stránku

Stránkování — načtení další stránky

JavaScript

// První stránka
const first = await fetch(
  "https://www.casinokatalog.cz/api/games?limit=50",
  { headers: { "X-API-Key": "váš-api-klíč" } }
).then(r => r.json())

// Druhá stránka (použijte nextCursor z první odpovědi)
const second = await fetch(
  `https://www.casinokatalog.cz/api/games?limit=50&cursor=${first.nextCursor}`,
  { headers: { "X-API-Key": "váš-api-klíč" } }
).then(r => r.json())

Detail hry (Python)

Python

import requests

response = requests.get(
    "https://www.casinokatalog.cz/api/games/sweet-bonanza",
    headers={"X-API-Key": "váš-api-klíč"}
)
game = response.json()
print(game["name"])    # Sweet Bonanza
print(game["rtpMin"])  # 96.48

cURL

bash

curl -H "X-API-Key: váš-api-klíč" \
  "https://www.casinokatalog.cz/api/games?limit=5&type=slot"

Chybové kódy

HTTP kód	Důvod	Tělo odpovědi
200	Úspěch	`{ "games": [...], ... }`
401	Chybí nebo neplatný API klíč	`{ "error": "Invalid or missing API key" }`
404	Hra nenalezena (GET /api/games/:slug)	`{ "error": "Game not found" }`
500	Interní chyba serveru	`{ "error": "Internal server error" }`

Poznámky

• Maximální počet her na jeden požadavek je 200. Pro více výsledků použijte stránkování (cursor).
• API vrací pouze aktivní hry — neaktivní hry nejsou ve výsledcích.
• Všechny endpointy podporují CORS — lze volat přímo z prohlížeče (pozor na expozici klíče, viz varování výše).
• Pole thumbnailUrl, screenshotUrls a logoUrl mohou být null, pokud obrázek není nahrán.
• API klíč je přiřazen konkrétnímu partnerovi a může být deaktivován. Při problémech kontaktujte Casinokatalog.cz.

Sdílet dokumentaci:

https://www.casinokatalog.cz/api-docs