Vai al contenuto
Pegasus
Arena

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=etrurian

Al 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=etrurian

Risponde 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.