API per i club
I tornei del tuo club sul tuo sito, aggiornati da soli: li crei su Pegasus Arena e compaiono anche lì. Gratis, senza chiavi e senza registrarti.
Cosa sono
Sono indirizzi che restituiscono i tornei di Pegasus Arena in un formato che un programma sa leggere. Un sito di club li usa per mostrare i suoi prossimi tornei, o i podi di quelli finiti, senza ricopiarli a mano.
- Solo lettura. Da qui si leggono i tornei e basta: per crearli, modificarli e iscriversi si passa dal sito.
- Solo dati pubblici. Gli stessi che chiunque vede sulla pagina di un torneo. Niente bozze, niente email, niente dati privati.
- Senza chiavi. Non serve registrarsi: basta l'indirizzo. Si possono chiamare anche dal browser, da qualsiasi sito.
Il calendario, senza codice
Se il sito del club non ha uno sviluppatore, questo è il modo più semplice. Ogni club ha il suo calendario:
https://pegasusarena.it/api/v1/calendar.ics?club=etrurianAl posto di etrurian va il nome del tuo club come sta nell'indirizzo della sua pagina (l'elenco è qui sotto). Senza ?club=… hai i tornei di tutti i club.
- Google Calendar: «Altri calendari», poi «+» e «Da URL», e incolli l'indirizzo.
- Apple Calendar: «Archivio», poi «Nuova iscrizione a calendario».
- Outlook: «Aggiungi calendario», poi «Sottoscrivi dal Web».
Ci sono i prossimi tornei e quelli finiti negli ultimi 60 giorni; quelli annullati restano, segnati come annullati. Un torneo non ancora chiuso dura 4 ore nel calendario: è una stima, l'orario vero di fine arriva quando il torneo si chiude. I calendari si aggiornano da soli, con i loro tempi (Google anche una volta al giorno).
I tornei in JSON
GET https://pegasusarena.it/api/v1/tournaments?club=etrurianRisponde con l'elenco dei tornei. I parametri, tutti facoltativi:
- club: i tornei del club, sia quelli che organizza sia quelli che co-organizza con altri club. Senza, quelli di tutti.
- region: i tornei che si giocano in una regione, scritta in minuscolo col trattino al posto degli spazi e dell'apostrofo: toscana, emilia-romagna, valle-d-aosta. Si può usare insieme a club.
- status: upcoming (il predefinito) per quelli in programma e in corso, dal più vicino; completed per quelli finiti, dal più recente, col podio.
- limit: quanti, da 1 a 50. Se non lo metti sono 20.
La risposta (un torneo, accorciata):
{
"tournaments": [
{
"slug": "etrurian-open",
"name": "Etrurian Open",
"url": "https://pegasusarena.it/tornei/etrurian-open",
"image_url": "https://pegasusarena.it/tornei/etrurian-open/opengraph-image",
"status": "registration",
"starts_at": "2026-11-15T14:00:00.000Z",
"completed_at": null,
"venue": { "name": "Sala Etrurian", "address": "Via …", "city": "Firenze", "region": "Toscana" },
"club": { "slug": "etrurian", "name": "Etrurian", "city": "Firenze", "region": "Toscana", "logo_url": "…", "url": "https://pegasusarena.it/club/etrurian" },
"co_hosts": [],
"ranked": true,
"team_size": null,
"format": "Swiss + top cut a 8",
"price_cents": 500,
"cap": 48,
"players": 21,
"registration_open": true,
"podium": null
}
]
}Un torneo solo
GET https://pegasusarena.it/api/v1/tournaments/{slug}Lo slug è la parte finale dell'indirizzo del torneo: https://pegasusarena.it/tornei/etrurian-open. Risponde con { "tournament": { … } }, con gli stessi campi dell'elenco. Qui ci sono anche i tornei annullati, con lo stato cancelled.
I campi
- status: registration (in programma), running (in corso), completed (finito), cancelled (annullato).
- starts_at, completed_at, updated_at: date e ore in UTC (ISO 8601). Per l'ora italiana usa il fuso Europe/Rome, come nell'esempio qui sotto.
- url: la pagina del torneo, dove ci si iscrive e si segue il bracket. Mettila sempre come link.
- image_url: l'immagine del torneo per la condivisione (1200 × 630).
- venue: nome della sala, indirizzo e città (ognuno può essere null) e la regione dove si gioca. club e co_hosts: chi organizza, con logo e pagina.
- ranked: se dà punti per la classifica. team_size: 2 o 3 nei tornei a squadre, altrimenti null. format: il formato in parole («Swiss + top cut a 8»). Prima dell'avvio, se il top cut dipende da chi viene, è «… + top cut secondo i presenti».
- price_cents: la quota in centesimi di euro (500 = 5 €; 0 = gratis). prizes e description: testo libero scritto dal club, o null.
- cap: i posti (null = senza limite). players: gli iscritti, o chi ha giocato se il torneo è partito. registration_open: se in questo momento ci si può iscrivere.
- podium: nei tornei finiti i primi tre posti, con il link al profilo (a pari merito possono essere di più, per esempio due terzi se non c'è la finale per il 3°); nei tornei a squadre il nome della squadra e i suoi giocatori in members. Negli altri tornei è null.
Col tempo possono arrivare campi nuovi: il tuo codice deve ignorare quelli che non conosce. Quelli che ci sono non cambiano.
Un esempio
I prossimi tornei del club in una lista, con JavaScript nel browser. Nella pagina serve una lista vuota, <ul id="tornei"></ul>, e lo script va messo come modulo:
<script type="module">
const risposta = await fetch("https://pegasusarena.it/api/v1/tournaments?club=etrurian");
const { tournaments } = risposta.ok ? await risposta.json() : { tournaments: [] };
const quando = (iso) =>
new Date(iso).toLocaleString("it-IT", {
timeZone: "Europe/Rome", weekday: "long", day: "numeric",
month: "long", hour: "2-digit", minute: "2-digit",
});
const lista = document.querySelector("#tornei");
for (const t of tournaments) {
const voce = document.createElement("li");
const link = document.createElement("a");
link.href = t.url;
link.textContent = t.name; // textContent, mai innerHTML
voce.append(link, " · " + quando(t.starts_at) + (t.venue.city ? " · " + t.venue.city : ""));
lista.append(voce);
}
</script>Il nome dei club
Il valore da mettere in club:
- Apex: apex
- Astranova: astranova
- Aura Bladers: aura-bladers
- Blade Breakers: blade-breakers
- Etrurian: etrurian
- Galaxy Titans: galaxy-titans
- Phoenix: phoenix
- Ronin: ronin
- Storm: storm
- Thunder Pegasus: thunder-pegasus
Regole d'uso
- Gratis, per tutti. Non chiediamo niente e non serve avvisarci, ma ci fa piacere saperlo.
- I dati arrivano con qualche minuto di ritardo (al massimo 7). Chiederli più spesso non serve: arriva la stessa risposta. Per il punteggio live c'è la pagina del torneo.
- Metti il link al torneo. Le iscrizioni, il check-in e i risultati sono su Pegasus Arena.
- La versione 1 non si rompe. Se un giorno servirà cambiare qualcosa in modo diverso, arriverà una v2 e la v1 resterà in piedi per un bel po'.
- Un dubbio o un campo che manca? Scrivi a ciao@saturdaycompany.it.