API di MineAlpha
Con una richiesta HTTP GET al seguente indirizzo (opportunamente modificato in base alle proprie esigenze), è possibile recuperare informazioni dalla nostra lista server.
https://api.minealpha.it/v6/server-info/SERVER-NAME?key=APIKEY
Formato Richiesta
| Campo | Descrizione | Esempio |
|---|---|---|
| Nome server * | Slug del server specificato nel file server-info.yml come "www" | slimecraft |
| Chiave API | La chiave API del tuo server | 385d256b056180352ec6d2213a91e6e2 |
La chiave API è opzionale e serve per accedere ai dati relativi ai voti degli utenti.
Per ottenerla, è sufficiente utilizzare il comando /apikey sul Discord di MineAlpha. Se necessario, puoi richiedere una nuova chiave tramite il comando /apikey new.
Contenuto Risposta
| Campo | Descrizione | Tipo | Nullable | Esempio |
|---|---|---|---|---|
| name | Nome del server | Stringa | No | "Slimecraft" |
| slug | Slug del server | Stringa | No | "slimecraft" |
| address | Indirizzo del server | Stringa | No | "mc.slimecraft.io" |
| position | Posizione in lista | Intero | No | 7 |
| votesTotal | Voti totali del mese | Intero | No | 533 |
| votesToday | Voti di oggi fino al momento della richiesta | Intero | No | 8 |
| votesYesterday | Voti di ieri | Intero | No | 14 |
| userVotes | Lista degli utenti che hanno votato oggi | Lista | Si | Vedi la relativa sezione |
| hidden | Server nascosto dalla lista | Booleano | No | false |
| versions | Lista ordinata delle versioni del server | Lista | Si | ["1.8","1.9","1.10","1.11","1.12"] |
| versionsString | Stringa delle versioni del server | Stringa | Si | "da 1.8 a 1.12" |
| online | Server attualmente online | Booleano | No | true |
| players | Numero di giocatori attualmente connessi al server | Intero | No | 23 |
| slot | Numero di slot del server | Intero | No | 50 |
| staff | Lista dei membri dello staff | Lista | Si | Vedi la relativa sezione |
| categories | Lista delle categorie del server | Lista | Si | ["premium","survival","factions"] |
| lastVotesUpdate | Timestamp in ms dell'ultimo aggiornamento dei voti | Intero | Si | 1620252010000 |
Dettaglio userVotes
| Campo | Descrizione | Tipo | Nullable | Esempio |
|---|---|---|---|---|
| discordUsername | Username di Discord dell'utente | Stringa | No | Fabrimat |
| discordDiscriminator | Discriminatore di Discord dell'utente | Stringa | No | 4869 |
| discordID | ID di Discord dell'utente | Stringa | No | 125265482889691136 |
| votedAt | Timestamp in secondi dell'ora del voto | Stringa | No | 1656867995 |
| minecraftUUID | UUID di Minecraft Java dell'account dell'utente | Stringa | Si | 3f646b10-55f4-4374-85b9-f61cd10a036f |
| minecraftNickname | Nickname di Minecraft dell'utente | Stringa | Si | Fabrimat |
Dettaglio staff
| Campo | Descrizione | Tipo | Nullable | Esempio |
|---|---|---|---|---|
| uuid | UUID di Minecraft Java | Stringa | Si | 3f646b10-55f4-4374-85b9-f61cd10a036f |
| username | Username di Minecraft | Stringa | No | Fabrimat |