Skip to content
On this page

API dokumentace

API poskytuje informace ve formátu JSON na základě API tokenu, který naleznete ve Správě serveru.

Informace o serveru

GET https://minecraftservery.eu/api/v1/server/{token}/info

json
{
    "name": "SlimeCraft",
    "subtitle": "Survival · Creative · Minihry",
    "position": {
        "votes": 12,
        "rating": 21,
        "players": 11
    },
    "slug": "slimecraft",
    "players": 18,
    "max_players": 100,
    "votes": 2589,
    "rating": 4.8
}

Hlasy serveru

GET https://minecraftservery.eu/api/v1/server/{token}/votes

json
{
    "count": 3,
    "votes": [
        {
            "nickname": "Dotteex",
            "delivered": true,
            "created": 1684263341
        },
        {
            "nickname": "Dotteex",
            "delivered": false,
            "created": 1684430598
        },
        {
            "nickname": "xNistic",
            "delivered": true,
            "created": 1684434394
        }
    ]
}

Nejlepší hlasující

GET https://minecraftservery.eu/api/v1/server/{token}/top-voters

json
[
    {
        "nickname": "Dotteex",
        "count": 2
    },
    {
        "nickname": "xNistic",
        "count": 1
    }
]

Hlasy hráče

GET https://minecraftservery.eu/api/v1/server/{token}/player/{nickname}

json
{
    "nickname": "Dotteex",
    "count": 2,
    "nextPossibleVote": 1684437798,
    "votes": [
        {
            "nickname": "Dotteex",
            "delivered": true,
            "created": 1684263341
        },
        {
            "nickname": "Dotteex",
            "delivered": false,
            "created": 1684430598
        }
    ]
}

Recenze + vyzvednuté odměny

GET https://minecraftservery.eu/api/v1/server/{token}/reviews

json
[
    {
        "username": "Dotteex",
        "rating": 5,
        "content": "Oceňuji chvályhodnou práci majitele a developerů.",
        "created": 1684426321,
        "updated": null,
        "reply": "Děkujeme za recenzi.",
        "reward": null
    },
    {
        "username": "Nistic",
        "rating": 5,
        "content": "Server je prostě top, není co víc dodat.",
        "created": 1684429111,
        "updated": 1684429131,
        "reply": null,
        "reward": {
            "nickname": "xNistic",
            "claimed": 1684429161
        }
    }
]

Parametry a filtry

Formát data a času

Do URL lze vložit parametr ?format= pro jiný formát data a času.

Hodnota parametruPříkladPoznámka
timestamp (výchozí)1683842400Unix Timestamp
DateTime2023-05-18 12:00:00
iso2023-05-18T12:00:00.000000ZISO 8601
dmy18.05.2023
dmy-hm18.05.2023 12:00
dmy-hms18.05.2023 12:00:00

Limit záznamů

Do URL lze vložit parametr ?limit= pro omezení počtu záznamů. Funguje pouze u nejlepších hlasujících.