Aller au contenu

Premier appel à l'API

L’API de données iDalgo est en lecture seule (GET), publique et cachée par un CDN. Elle sert les widgets iDalgo et peut alimenter directement vos propres interfaces.

  1. Listez les sports pour obtenir leurs identifiants :

    Fenêtre de terminal
    curl "$IDALGO_API/v1/sports"
    {
    "data": [{ "id": "102", "code": "football", "name": "Football" }],
    "meta": {
    "cursor": null,
    "generatedAt": "2026-10-19T08:00:00.000Z",
    "version": "v1",
    "lang": "fr"
    },
    "links": { "self": "/v1/sports" }
    }
  2. Trouvez une compétition et sa saison en cours (currentSeason.id) :

    Fenêtre de terminal
    curl "$IDALGO_API/v1/competitions?sport=102"

    Vous connaissez son nom plutôt que son identifiant ? Cherchez-la : la recherche trouve compétitions, équipes et personnes, sans tenir compte des accents ni de la casse.

    Fenêtre de terminal
    curl "$IDALGO_API/v1/search?q=ligue%201&type=competition"
  3. Lisez son classement :

    Fenêtre de terminal
    curl "$IDALGO_API/v1/standings?season=374703"
  • Votre serveur envoie votre clé secrète en Authorization: Bearer idl_sk_…, jamais dans l’URL : voir Votre clé.
  • Chaque réponse a la même enveloppe { data, meta, links } : voir Conventions.
  • Les listes se paginent par curseur (meta.cursor, links.next) : voir Pagination.
  • Chaque réponse porte Cache-Control et ETag : respectez-les, voir Cache et fraîcheur.
  • Le contrat complet est dans la référence, et téléchargeable au format OpenAPI 3.1 : openapi.json, de quoi générer un client typé.
  • Pour afficher un widget iDalgo rendu par votre serveur plutôt que vos propres écrans, voir Intégration côté serveur.