Documentazione Api

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

CampoDescrizioneEsempio
Nome server *Slug del server specificato nel file server-info.yml come "www"slimecraft
Chiave APILa chiave API del tuo server385d256b056180352ec6d2213a91e6e2

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

CampoDescrizioneTipoNullableEsempio
nameNome del serverStringaNo"Slimecraft"
slugSlug del serverStringaNo"slimecraft"
addressIndirizzo del serverStringaNo"mc.slimecraft.io"
positionPosizione in listaInteroNo7
votesTotalVoti totali del meseInteroNo533
votesTodayVoti di oggi fino al momento della richiestaInteroNo8
votesYesterdayVoti di ieriInteroNo14
userVotesLista degli utenti che hanno votato oggiListaSi Vedi la relativa sezione
hiddenServer nascosto dalla listaBooleanoNofalse
versionsLista ordinata delle versioni del serverListaSi["1.8","1.9","1.10","1.11","1.12"]
versionsStringStringa delle versioni del serverStringaSi"da 1.8 a 1.12"
onlineServer attualmente onlineBooleanoNotrue
playersNumero di giocatori attualmente connessi al serverInteroNo23
slotNumero di slot del serverInteroNo50
staffLista dei membri dello staffListaSi Vedi la relativa sezione
categoriesLista delle categorie del serverListaSi["premium","survival","factions"]
lastVotesUpdateTimestamp in ms dell'ultimo aggiornamento dei votiInteroSi1620252010000

Dettaglio userVotes

CampoDescrizioneTipoNullableEsempio
discordUsernameUsername di Discord dell'utenteStringaNoFabrimat
discordDiscriminatorDiscriminatore di Discord dell'utenteStringaNo4869
discordIDID di Discord dell'utenteStringaNo125265482889691136
votedAtTimestamp in secondi dell'ora del votoStringaNo1656867995
minecraftUUIDUUID di Minecraft Java dell'account dell'utenteStringaSi3f646b10-55f4-4374-85b9-f61cd10a036f
minecraftNicknameNickname di Minecraft dell'utenteStringaSiFabrimat

Dettaglio staff

CampoDescrizioneTipoNullableEsempio
uuidUUID di Minecraft JavaStringaSi3f646b10-55f4-4374-85b9-f61cd10a036f
usernameUsername di MinecraftStringaNoFabrimat