Tutti i numeri di Invetta sono liberi da usare nel tuo tracker, bot o sito: GET in JSON, nessuna chiave, CORS aperto (si chiamano anche dal browser).
Base: · i dati si aggiornano a ogni giro di ping (circa 15-25 secondi).
Se usi i numeri cita Invetta con un link a invetta.top. Per il tempo reale usa lo stream /api/live invece di interrogare la classifica di continuo.
Tutti i server in classifica, già ordinati per giocatori online. È la chiamata da cui partire: qui trovi l'id e lo slug di ogni server.
| players | giocatori totali su tutti i server in classifica |
| updated | istante dell'ultimo dato (unix, secondi) |
| servers[].id · slug | identificativo numerico e nome per gli URL (/server/<slug>) |
| servers[].online | giocatori online ora (null = offline) |
| servers[].est | true se il server blocca il ping e il numero è la stima di minecraft-italia |
| servers[].record · record_date | record storico di giocatori e data |
| servers[].peak48 | picco delle ultime 48 ore |
| servers[].trend | variazione % rispetto a 24 ore fa |
| servers[].hot | true se è "in fiamme" (molto sopra la sua media) |
| servers[].address · vmin · vmax · tags | IP, versioni supportate, modalità |
| servers[].icon_id | logo: /api/logo/<icon_id> |
La scheda di un server: online, posizione in classifica, record, picco, la serie per il grafico e la media per ora del giorno. w = finestra del grafico: g 24 ore, s 7 giorni, m 30 giorni.
| position | posizione attuale in classifica |
| online · record · peak48 · trend · est | come nella classifica |
| points | [unix, giocatori, stima]: un punto ogni 5 min (24h), 1 ora (7g) o 6 ore (30g); stima = 1 se il dato viene da minecraft-italia |
| hourly | 24 valori: media dei giocatori per ora del giorno (0-23), ultimi 14 giorni |
| color | colore dominante del logo (comodo per i grafici) |
Le serie dei primi n server (default 10) e total, l'andamento dei giocatori totali: i dati del grande grafico in home.
Stream Server-Sent Events: resta collegato e ricevi i dati appena arrivano, senza polling. Evento tick = {v, players} a ogni dato nuovo; con ?r=1 arriva anche ranking, la classifica completa (stesso formato di /api/ranking). Si riconnette da solo.
Lo storico di un server da aprire con Excel o Fogli Google: data_ora;unix;giocatori_medi;stima_minecraft_italia.
Badge sempre aggiornato con giocatori online e posizione, da mettere sul sito del server. Altre immagini: /og/{slug}.png (scheda) e /record/{slug}.png (card del record). Il codice pronto da incollare è nella pagina di ogni server.
