Hrajeme.cz

API

Redakce

Chcete do svého e-shopu nebo webu integrovat údaje o hrách z webu Hrajeme.cz? Pokud ano, využijte k tomu veřejné API webu hrajeme.cz, které vrací údaje o hrách v počítačově zpracovatelném XML formátu.

Pro pochopení následujícího popisu potřebujete určité technické znalosti nebo ho předejte člověku, který se vám stará o e-shop/stránky.

Přístup k API je přes odkaz https://www.hrajeme.cz/xmlapi/bggid/<boardgamegeekid>

Kde <boardgamegeekid> je číselné ID hry na webu BoardGameGeek (https://boardgamegeek.com)

Například https://www.hrajeme.cz/xmlapi/bggid/50 vypíše hru Lost Cities.

 

API vrací svou odpověď ve formátu XML.

Dojde-li k chybě, vrátí se <error>popis chyby</error>.

Pokud je vše v pořádku, vrátí se záznam hry v tomto formátu:

<hra id="interní ID hry na hrajeme">
  <url>adresa hry na hrajeme</url>
  <nazev>název hry</nazev>
  <popis>dlouhý popis hry</popis>
  <hodnoceni>
    <prumer>průměrné hodnocení hry na Hrajeme</prumer>
    <pocet>celkový počet hodnocení hry</pocet>
  </hodnoceni>
  <pocethracu>kolik hráčů může hru hrát</pocethracu>
  <vekhracu>od kolika let hra je</vekhracu>
  <pocesteni>je hra česky?</pocesteni>
  <rokvydani>rok vydání</rokvydani>
  <atributy> -- tady jsou jednotlivé atributy hry, vyšší číslo znamená více, rozpětí je 1-5
    <nahoda>míra náhody</nahoda>
    <slozitost>míra složitosti</slozitost>
    <humor>humornost hry</humor>
    <interakce>míra interakce s ostatními ve hře</interakce>
  </atributy>
  <doporuceni>
    <rodina>lze hru doporučit jako rodinnou hru?</rodina>
    <hrac>lze hru doporučit jako hráčskou hru?</hrac>
  </doporuceni>
  <autori>autor hry</autori>
  <vyrobci>kdo hru vydal</vyrobci>
</hra>