API Documentation

Integra i dati in tempo reale di ListaServers.it nel tuo sito web, bot Discord o applicazione personalizzata.

Endpoint Pubblici

Accesso libero ai dati dei server senza necessita di chiavi API per le richieste base.

CORS Abilitato

Puoi chiamare le nostre API direttamente dal tuo codice frontend (JavaScript/React).

Anti-Spam (Cache)

Per garantire stabilità, i dati vengono cachati per 15 secondi. Richieste ripetute restituiranno dati in cache senza rallentare il sistema.

GEThttps://listaservers.it/api/v1/servers/[slug]

Ottieni Dettagli Server

Restituisce i dati completi di un server specifico, inclusi i voti degli ultimi 2 giorni e le statistiche dei giocatori.

Parametri URL

ParametroTipoDescrizione
slugstringL'identificatore univoco del server (es. hytale-test)

Esempio Risposta JSON

{
  "id": "cmovb85ls00025vt0bxbogdkz",
  "name": "Hytale Italia Test",
  "slug": "hytale-test",
  "ip": "127.0.0.1",
  "port": 25565,
  "version": "1.0.0",
  "isOnline": true,
  "players": {
    "online": 42,
    "list": [
      {
        "uuid": "550e8400-e29b-41d4-a716-446655440000",
        "name": "Notch"
      },
      {
        "uuid": "6ba7b810-9dad-11d1-80b4-00c04fd430c8",
        "name": "Lino"
      }
    ]
  },
  "totalVotes": 150,
  "lastVotes": [
    {
      "nickname": "Lino",
      "timestamp": 1715321190
    },
    {
      "nickname": "Steve",
      "timestamp": 1715234790
    }
  ],
  "status": "approved",
  "game": "Hytale",
  "modes": [
    "Survival",
    "PvP"
  ],
  "lastUpdate": "2026-05-10T08:00:00.000Z"
}

Esempi di Utilizzo

JavaScript (Fetch)

fetch("https://listaservers.it/api/v1/servers/hytale-test")
  .then(res => res.json())
  .then(data => {
    console.log("Server Name:", data.name);
    console.log("Online Players:", data.players.online);
  });

Python (Requests)

import requests

url = "https://listaservers.it/api/v1/servers/hytale-test"
response = requests.get(url)
data = response.json()

print(f"Server: {data['name']} - Players: {data['players']['online']}")

Per cosa puoi usarle?

Discord Bot

Mostra lo stato del server e gli ultimi voti direttamente sul tuo canale Discord.

Website Widget

Crea un box nel tuo sito web che mostra quanti giocatori sono online in tempo reale.

Plugin In-Game

Sincronizza i premi per i voti controllando la lista lastVotes tramite API.