API e widget
Le stesse letture pubbliche che alimentano questo sito, più tre widget da incorporare in una pagina.
Tutte le letture sono pubbliche e autorizzate da una chiave: nessun dato personale, nessun identificativo interno.
| Indirizzo | Cosa restituisce | Autorizzazione |
|---|
GET /public/widgets/{kind}/{subject_id} | Il contenuto di un widget, già filtrato per il pubblico. | read:public.standings |
GET /public/tournaments/{tournamentId}/standings | La classifica ufficiale di un torneo, dai soli risultati omologati. | read:public.standings |
GET /public/matches/{matchId} | Una partita con lo stato che il pubblico può vedere. | read:public.matches |
GET /public/matches/{matchId} · autorizzazione read:public.matches
id: string(uuid)
scheduled_at: string(date-time) | null
schedule_precision: "exact" | "date_only" | "unknown"
scheduled_on: string(date) | null
state: "scheduled" | "live" | "ended" | "report_draft" | "report_submitted" | "report_official" | "corrected" | "cancelled" | "postponed"
home_team_id: string(uuid)
away_team_id: string(uuid)
score_home: integer | null
score_away: integer | nullIl contratto pubblica lo schema ma non un esempio: mostriamo i campi reali invece di inventarne uno.Generato dallo stesso documento servito alle integrazioni, non riscritto a mano.
Scegli tema e dimensione, guarda l’anteprima reale e copia il codice. Il widget funziona solo dalle origini che hai autorizzato.
| Nome | Tipo | A cosa serve |
|---|---|---|
read:public.standings | lettura | classifica di un torneo |
read:public.matches | lettura | calendario, risultati, scheda partita |
read:public.teams | lettura | schede squadra e widget squadra |
read:public.players | lettura | marcatori e profili pubblici |
read:public.media | lettura | foto approvate e pubblicabili |
read:public.live | lettura | risultati in tempo reale, dove attivi |
read:public.widgets | lettura |
| widget configurati e origini ammesse |
| Nome | Tipo | A cosa serve |
|---|---|---|
public_widget | pubblico | solo letture pubbliche, con origini ammesse |
partner | organizzatore | integrazioni dell’organizzatore, tracciate |
operator_console | piattaforma | strumenti interni, non API pubbliche |
| Stato | Significato |
|---|---|
429 rate_limited | Hai superato il limite di traffico. La risposta dice fra quanti secondi ritentare e il widget mostra uno stato leggibile, non un riquadro vuoto. |
unavailable | Il riferimento pubblico non è configurato o non ha ancora righe pubblicabili. Non è un errore tuo. |
forbidden | Origine, autorizzazione o modulo non abilitati: viene dichiarato senza mostrare dati parziali. |
backend_down | Il servizio non ha risposto: il riquadro resta leggibile e si può ritentare. |