LES DONNÉES,
OUVERTES.

Commencez ici

FAITES VOTRE PREMIÈRE REQUÊTE.

Aucune clé d’API n’est nécessaire. L’accès est en lecture seule et les réponses peuvent être lues depuis n’importe quelle origine. Merci de rester raisonnable dans vos requêtes. Les enregistrements sont en anglais, quelle que soit la langue de cette page.

curl "https://ultracyclinghub.com/api/editions.json?discipline=road&period=upcoming&limit=3"

La réponse contient results, le total count et une URL next pour la page suivante.

RÉFÉRENCE DES POINTS D’ACCÈS.

Utilisez les filtres de l’annuaire pour trouver des éditions, puis lisez une épreuve complète ou une seule édition. Le schéma documente les champs et filtres disponibles.

GET/api/editions.json

Rechercher des éditions

Recherchez avec les filtres de l’annuaire. Paginez avec page et limit, jusqu’à 100 enregistrements par page. Un filtre invalide renvoie HTTP 400 avec les erreurs par champ.

GET/api/openapi.json

Schéma de l’API

La description OpenAPI des points d’accès de recherche et d’enregistrement.

GET/events/<slug>.json

Une épreuve

Lisez une épreuve avec toutes ses éditions approuvées et ses sources. Remplacez .json par .md pour du Markdown.

GET/events/<slug>/<year>/<id>.json

Une édition

Utilisez l’id d’enregistrement de l’édition, avec le slug de l’épreuve et l’année. L’URL des données contient cet identifiant même si la page HTML ne le contient pas. Le Markdown est aussi disponible en .md.

GET/changes.atom

Modifications des informations publiées

Un flux Atom des corrections apportées aux informations publiées.

Vous préférez du Markdown depuis une URL HTML d’épreuve ou d’édition ? Envoyez l’en-tête Accept: text/markdown.

POUR LES AGENTS IA.

/llms.txt

Règles de lecture et couverture

Commencez par les conventions des données, les consignes de citation et la couverture actuelle.

/llms-full.txt

La collection complète

Les mêmes règles de lecture, suivies de chaque épreuve publiée en Markdown.

UTILISEZ LES DONNÉES AVEC SOIN.

Conservez la provenance

Chaque enregistrement porte sa source_url et sa date verified_on. Une valeur manquante signifie qu’elle n’est pas vérifiée, jamais zéro ni absente.

Citez la source

Les données sont sous licence CC BY 4.0. Faites un lien vers la page de l’épreuve ou de l’édition, nommez « Ultracycling Hub » et indiquez la date de vérification de l’enregistrement.

Confirmez avant de vous inscrire

Les détails d’inscription, les prix et les dates changent. Envoyez les participants chez l’organisateur pour s’inscrire. Lisez comment les fiches sont vérifiées.