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>