API pubblica
Costruisci bot Discord, mod e siti con i dati veri del server. Gratis, senza chiave, in JSON.
- Indirizzo di base:
https://astronovamc.it/api/v1. Tutte le rotte sonoGETe rispondono in JSON. - Ogni risposta ha
statoerisultato; se qualcosa non va,errorecon la spiegazione in italiano. - Niente chiave e niente registrazione. Il limite è di 120 richieste di fila, poi 2 al secondo per indirizzo: oltre, la risposta è
429e basta aspettare qualche secondo. - I dati si aggiornano dal vivo; le risposte si possono tenere in cache 30 secondi. Le chiamate dal browser sono permesse (CORS aperto).
const r = await fetch('https://astronovamc.it/api/v1/giocatori/ItzFedex_');
const { risultato } = await r.json();
console.log(risultato.nome, risultato.modalita.smp.blocchi_rotti);Cosa si può chiedere
Se il server è acceso, quanti giocatori ci sono e chi, i TPS, l’indirizzo e le versioni con cui si entra.
GET /api/v1/serverIl profilo pubblico: se è online, primo e ultimo accesso, tempo di gioco, rank, clan, voti e, per ogni modalità, uccisioni, morti, mob, blocchi e saldo. I giocatori Bedrock si trovano anche senza il punto davanti al nome.
GET /api/v1/giocatori/ItzFedex_25 posizioni per pagina, fino alla pagina 20. Categorie: uccisioni, morti, mob, blocchi_rotti, blocchi_piazzati, tempo, ricchezza, venduto, speso, isole, livello_isola, voti. modalita è smp, oneblock o vanilla (non tutte le classifiche esistono ovunque: la risposta dice dove).
GET /api/v1/classifiche/blocchi_rotti?modalita=smp&pagina=1Le aste in corso, dalla più vicina alla chiusura: oggetto (col nome italiano), venditore, prezzo «compra subito», offerta attuale e scadenza.
GET /api/v1/aste?pagina=1Le ultime aste concluse con una vendita, con chi ha comprato e a quanto: la base per seguire i prezzi del mercato.
GET /api/v1/aste/vendute?pagina=1Tutti gli oggetti dello /shop con prezzo d’acquisto, di vendita e di vendita netta (tolta la trattenuta). Filtri: cerca (nome italiano o id inglese) e categoria.
GET /api/v1/prezzi?cerca=diamanteI 23 spawner del negozio: prezzo, drop, e la stima del gioco di Stelle ed esperienza all’ora, quando si riempie il magazzino e in quanto si ripagano.
GET /api/v1/spawnerUsala bene
- Scrivi da dove vengono i dati: «dati di AstroNovaMC» con un link a astronovamc.it.
- Non fingerti il server o lo staff: il tuo bot è tuo, e deve dirlo.
- Escono solo i dati che il sito mostra già a tutti. Se ti serve altro, o hai un’idea per una rotta nuova, chiedi su Discord.
