API
Umožňuje komunikaci a výměnu dat. S rozhraním API můžete komunikovat prostřednictvím požadavků HTTP z libovolného jazyka.
- Zobrazení všech veřejně dostupných informací o serveru
- Seznam hráčů hlasujících pro server za posledních 30 dní
- Aktuální počet hlasů
- Status a další informace serveru (ip adresa, port, motd, verze, mód, hráči/sloty)
- Detailní statistiky - https://mcservery.eu/stats
Nikomu nesdělujte ani neposílejte svůj API klíč. V případě vyzrazení vygenerujte nový – původní přestane být funkční.
Pro používání api je nutné vygenerovat api key který vám zajistí přístup k informacím pro server se kterým je klíč navázaný. Klíč vygenerujete po přihlášení k účtu který je spojený s daným serverem. Je nutné být přihlášený na http://mcservery.eu/login.php
Pro vygenerování klíče si po přihlášení k Vašemu zobrazte detail Vámi přidaného serveru.
Pod popisem serveru naleznete box s názvem „Upravit server“. Zde stačí kliknout na tlačítko vygenerovat api key.
Rate limit je maximální počet API volání, které aplikace nebo uživatel může v určitém časovém období provést. Pokud je tento limit překročen, dojde k zablokování požadavků.
Je to běžnou praxí pro API a limity jsou zavedeny z několika důvodů:
- Pomáhají chránit API proti zneužití nebo nesprávnému použití. Například útočník by mohl zaplavit API požadavky v pokusu o přetížení serveru.
- Limity pomáhají zajistit, že každý má spravedlivý přístup k API. Pokud jedna osoba nebo aplikace provede nadměrný počet požadavků, mohlo by to zpomalit API pro všechny ostatní.
Maximum je 10 požadavků během 10 vteřin.
Dojde k blokaci IP adresy ze které jsou požadavky odesílaný. Blokace trvá 10 vteřin.
Pokud narazíte na chybu 429 nebo 1015, znamená to, že jste v krátkém časovém období provedli příliš mnoho požadavků a API odmítá plnit další požadavky, dokud neuplyne stanovené časové období.
Stejné limity se vztahují i na přístup na web, tedy ne jen na API požadavky jako takové.
get
http://api.mcservery.eu
/players/?api_key=
Hlasující hráči za posledních 30 dní
get
http://api.mcservery.eu
/votes/?api_key=
Počet hlasů
McServery API: Žebříček hlasujících na Váš web
mcservery.eu/blog
Pomocí endpointu /players/ lze vytvořit žebříček hlasujících pro Váš server.
get
http://api.mcservery.eu
/status/?api_key=
Status serveru
Něco nám uniklo?