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.
-
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" }} -
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" -
Lisez son classement :
Fenêtre de terminal curl "$IDALGO_API/v1/standings?season=374703"
Ce qu’il faut savoir
Section intitulée « Ce qu’il faut savoir »- 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-ControletETag: 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.