I DATI,
APERTI.
Gli stessi dati con fonti che vedono i ciclisti, pronti per i tuoi strumenti. Leggi eventi pubblicati, edizioni approvate e le loro fonti in JSON o Markdown.
Apri lo schema dell’APIInizia da qui
FAI LA TUA PRIMA RICHIESTA.
Non serve una chiave API. L’accesso è in sola lettura e le risposte possono essere lette da qualsiasi origine. Mantieni le richieste moderate. I record sono in inglese, qualunque sia la lingua di questa pagina.
Esempio · prossime edizioni su strada
curl "https://ultracyclinghub.com/api/editions.json?discipline=road&period=upcoming&limit=3"
La risposta include results, il totale count e un URL next per la pagina successiva.
RIFERIMENTO DEGLI ENDPOINT.
Usa i filtri dell’elenco per trovare le edizioni, poi leggi un evento completo o una singola edizione. Lo schema documenta campi e filtri disponibili.
- GET
/api/editions.json Cerca edizioni
Cerca con i filtri dell’elenco. Pagina con
pageelimit, fino a 100 record per pagina. Un filtro non valido restituisce HTTP 400 con gli errori dei campi.- GET
/api/openapi.json Schema dell’API
La descrizione OpenAPI degli endpoint di ricerca e dei record.
- GET
/events/<slug>.json Un evento
Leggi un evento con tutte le sue edizioni approvate e le fonti. Sostituisci
.jsoncon.mdper il Markdown.- GET
/events/<slug>/<year>/<id>.json Un’edizione
Usa l’
iddel record dell’edizione, insieme allo slug dell’evento e all’anno. L’URL dei dati include questo ID anche quando la pagina HTML non lo fa. Il Markdown è disponibile anche in.md.- GET
/changes.atom Modifiche ai dati pubblicati
Un feed Atom delle correzioni ai dati pubblicati.
Preferisci il Markdown da un URL HTML di un evento o di un’edizione? Invia l’intestazione Accept: text/markdown.
PER AGENTI IA.
Collegati tramite MCP
Il server HTTP senza stato accetta richieste POST e offre due strumenti in sola lettura: search_events e get_event.
https://ultracyclinghub.com/mcp//llms.txtRegole di lettura e copertura
Inizia dalle convenzioni dei dati, dalle indicazioni per citarli e dalla copertura attuale.
/llms-full.txtLa raccolta completa
Le stesse regole di lettura, seguite da ogni evento pubblicato in Markdown.
USA I DATI CON CURA.
- Conserva la provenienza
- Ogni record riporta la sua
source_urle la dataverified_on. Un valore mancante significa non verificato, mai zero o assente. - Cita la fonte
- I dati sono rilasciati con licenza CC BY 4.0. Inserisci un link alla pagina dell’evento o dell’edizione, cita «Ultracycling Hub» e indica la data di verifica del record.
- Conferma prima di iscriverti
- Dettagli di iscrizione, prezzi e date cambiano. Manda i ciclisti dall’organizzatore per iscriversi. Leggi come vengono verificate le schede.