API di Invetta per sviluppatori

api per sviluppatori

‹ Classifica

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.

classifica

GET/api/ranking

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.

campi della risposta
playersgiocatori totali su tutti i server in classifica
updatedistante dell'ultimo dato (unix, secondi)
servers[].id · slugidentificativo numerico e nome per gli URL (/server/<slug>)
servers[].onlinegiocatori online ora (null = offline)
servers[].esttrue se il server blocca il ping e il numero è la stima di minecraft-italia
servers[].record · record_daterecord storico di giocatori e data
servers[].peak48picco delle ultime 48 ore
servers[].trendvariazione % rispetto a 24 ore fa
servers[].hottrue se è "in fiamme" (molto sopra la sua media)
servers[].address · vmin · vmax · tagsIP, versioni supportate, modalità
servers[].icon_idlogo: /api/logo/<icon_id>

singolo server

GET/api/server/{id}?w=g|s|m

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.

campi della risposta
positionposizione attuale in classifica
online · record · peak48 · trend · estcome 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
hourly24 valori: media dei giocatori per ora del giorno (0-23), ultimi 14 giorni
colorcolore dominante del logo (comodo per i grafici)

grafici

GET/api/series?w=g|s|m&n=1-20

Le serie dei primi n server (default 10) e total, l'andamento dei giocatori totali: i dati del grande grafico in home.

tempo reale

SSE/api/live?r=1

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.

storico csv

CSV/api/server/{id}/csv?w=g|s|m

Lo storico di un server da aprire con Excel o Fogli Google: data_ora;unix;giocatori_medi;stima_minecraft_italia.

immagini

PNG/badge/{slug}.png

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.

Esempio di badge

Classifica · Bot Telegram · Canale · Regolamento · API
invetta.top · @invetta