API dokumentace

Server

Pokud se nenajde server podle slug tak vrátíme 404.

GET https://www.minecraft-list.cz/api/server/{slug}
200 Získá základní informace o serveru 
                        {
    "name": "Minecraft server name",
    "rank": 2,
    "slug": "minecraft-server-name",
    "votes": 455,
    "rating": 4.95,
    "reviews_count": 4,
    "uptime": 99.99,
    "online_players": 92,
    "max_players": 100
}
GET https://www.minecraft-list.cz/api/votes/{slug}
200 Získá počet aktivních hlasů a jejich kompletní seznam. 
                        {
    "votes_count": 543,
    "votes": [
        {
            "created_at": "2021-11-30 20:20:20",
            "delivered_at": "2021-11-30 20:20:27",
            "username": "Kogol"
        },
        {
            "created_at": "..."
        }
    ]
}
GET https://www.minecraft-list.cz/api/reviews/{slug}
200 Získá počet recenzí a jejich kompletní seznam. 
                        {
    "reviews_count": 9,
    "server_rating": 4.95,
    "reviews": [
        {
            "created_at": "2021-11-30 20:20:20",
            "updated_at": "2021-11-30 20:22:20",
            "username": "Kolega",
            "review": "Tento server celkem ujde.",
            "rating": 3,
            "upvotes": -32,
            "votes_count": 128,
            "server_reply": "Dekujeme za tvou recenzi ale plne nesouhlasime. -Kogol"
        },
        [
            "..."
        ]
    ]
}
GET https://www.minecraft-list.cz/api/top-voters/{slug}
200 Vrátí seznam 20 top aktivních hlasujích seřazený podle hlasů. 
                        [
    {
        "username": "Kogol",
        "votes": 129
    },
    {
        "username": "Dragan",
        "votes": 128
    },
    {
        "username": "..."
    }
]
GET https://www.minecraft-list.cz/api/votes/{slug}/{month}/{year}
200 Vrátí všechny hlasy v daném měsíci. (měsíc a rok musí být číslo) 
                        {
    "votes": [
        {
            "created_at": "2022-01-04 17:11:35",
            "delivered_at": "2022-01-04 17:31:35",
            "username": "Dragan"
        },
        {
            "created_at": "2022-01-04 17:21:32",
            "delivered_at": "2022-01-05 16:11:35",
            "username": "Kogol"
        },
        {
            "created_at": "..."
        }
    ],
    "votes_count": 5678
}

Server + hráč

GET https://www.minecraft-list.cz/api/server/{slug}/player/{player}
200 Údaje o aktivních hlasech hráče na daném serveru. 
                        {
    "votes": [
        {
            "created_at": "2022-01-04 17:11:35",
            "delivered_at": "false",
            "username": "Kogol"
        },
        {
            "created_at": "2022-01-04 17:11:55",
            "delivered_at": "2022-01-05 17:31:35",
            "username": "Kogol"
        }
    ],
    "vote_streak": 2,
    "votes_count": 2,
    "username": "Kogol",
    "next_vote_at": "2022-01-04 17:23:54"
}
GET https://www.minecraft-list.cz/api/server/{slug}/player/{player}/next-vote
200 Vrátí čas dalšího možného hlasování a username hráče. 
                        {
    "username": "Kogol",
    "next_vote_at": "2022-01-06 17:11:67"
}