Centrum nápovědy
mcservery.euDiscord
  • Centrum nápovědy
  • 📓Jak používat mcservery.eu
    • Hlasování
    • Uživatelské účty
      • Propojení účtu s Discordem
  • 🛠️Správci serverů
    • Přidání nového serveru
    • Odměny za hlasování (Votifier)
    • API
    • Zpětný odkaz
      • Ověřený server
    • Převod vlastnictví serveru
  • ⚙️Nastavení serveru
    • Doména serveru
    • Propagace serveru
Powered by GitBook
On this page
  • Co API umí?
  • Jak API používat?
  • Získání klíče
  • Rate limit
  • API reference
  • Základní informace o serveru
  • Hlasování
  • Hlasující hráči za posledních 30 dní
  • Počet hlasů
  • Status serveru
  • Status serveru
  • Související články

Was this helpful?

Edit on GitHub
  1. Správci serverů

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.

PreviousOdměny za hlasování (Votifier)NextZpětný odkaz

Last updated 2 years ago

Was this helpful?

Co API umí?

  • 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í.

Jak API používat?

Získání klíče

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

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

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ů.

Proč limitujeme počty 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í.

Jaké limity jsou nastaveny?

Maximum je 10 požadavků během 10 vteřin.

Co se stane pokud limit překročím?

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é.

API reference

Základní informace o serveru

Hlasování

Hlasující hráči za posledních 30 dní

GET http://api.mcservery.eu/players/?api_key=

Zobrazí jednotlivé hlasy podle uživatelského jména a času kdy byl hlas udělen.

Query Parameters

Name
Type
Description

api_key*

String

Klíč pro daný server

{
    'code'    => 1,
    'message' => 'Je vyžadován API key, dokumentaci naleznete na: https://github.com/McServery/API-Dokumentace'
}
{
    'code'    => 2,
    'message' => 'API key je neplatný'
}
{ 
  "username": "ArtyomCZ", "time": "2020-08-25 18:38:00"
}

Počet hlasů

GET http://api.mcservery.eu/votes/?api_key=

Zobrazí počet hlasů pro daný server.

Query Parameters

Name
Type
Description

api_key*

String

Klíč pro daný server

{
    "Votes": "1"
}
{
    'code'    => 2,
    'message' => 'API key je neplatný'
}
{
    'code'    => 1,
    'message' => 'Je vyžadován API key, dokumentaci naleznete na: https://github.com/McServery/API-Dokumentace'
}

Status serveru

Status serveru

GET http://api.mcservery.eu/status/?api_key=

Query Parameters

Name
Type
Description

api_key*

String

{
    'code' => 1, 
    'message' => 'Je vyžadován API key, dokumentaci naleznete na: https://github.com/McServery/API-Dokumentace'
}
{
    'code' => 2,
    'message' => 'API key je neplatný'
}
{
    'code' => 3,
    'message' => 'Server offline'
}

Související články

Něco nám uniklo?

Nebojte se! Rádi poradíme na nebo ✌️

🛠️
Přidání nového serveru
Discordu
info@mcservery.eu
http://mcservery.eu/login.php
McServery API: Žebříček hlasujících na Váš webmcservery.eu/blog
Pomocí endpointu /players/ lze vytvořit žebříček hlasujících pro Váš server.
Logo