/v1/competitions
const url = 'https://example.com/v1/competitions?ids=103%2C302&sport=302&limit=20&lang=ar';const options = {method: 'GET'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://example.com/v1/competitions?ids=103%2C302&sport=302&limit=20&lang=ar'Parameters
Section intitulée « Parameters »Query Parameters
Section intitulée « Query Parameters »Compétitions demandées, ids séparés par des virgules (100 max)
Example
103,302Compétitions demandées, ids séparés par des virgules (100 max)
Un sport (id de /v1/sports)
Example
302Un sport (id de /v1/sports)
Curseur de la page suivante, tel que renvoyé dans meta.cursor
Curseur de la page suivante, tel que renvoyé dans meta.cursor
Taille de la page, de 1 à 100 (défaut : 20)
Example
20Taille de la page, de 1 à 100 (défaut : 20)
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Responses
Section intitulée « Responses »Compétitions, triées par id, avec leur sport et leur saison courante (point d’entrée de /v1/standings)
object
Une compétition. currentSeason est le point d’entrée vers ses classements (/v1/standings?season=<id>) ; null quand la source n’en désigne pas.
object
Identifiant opaque d’une compétition
Logo d’une compétition, en PNG carré : small en 32 × 32 px (liste, en-tête de bloc), large en 100 × 100 px (fiche). Servi pour les compétitions de football, null pour les autres sports. Une compétition dont iDalgo n’a pas le fichier répond 404 à cette adresse : prévoyez un repli (nom seul)
object
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Une image servie par le CDN des médias iDalgo
object
Adresse absolue de l’image, servie par le CDN
Largeur, en pixels
Hauteur, en pixels
Un sport : code pour le rendu, id pour filtrer les autres routes (?sport=)
object
Identifiant opaque d’un sport
Code stable d’un sport, qui choisit son profil de rendu ; other sans profil dédié. Liste ouverte : ignorer une valeur inconnue.
Méta d’une liste paginée par curseur
object
Date de génération de la réponse
Version du contrat de la réponse : v1 pour une ressource /v1, celle du module pour un module (/modules/<nom>/v<n> → v<n>)
Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l’anglais, puis le français.
Curseur à renvoyer en ?cursor= pour la page suivante ; null sur la dernière
object
Chemin de la ressource, paramètres triés
Page suivante ; absent sur la dernière
Example
{ "meta": { "version": "v1", "lang": "ar" }}Contenu inchangé depuis l’ETag envoyé en If-None-Match
Paramètre invalide ou inconnu, ou curseur invalide
Erreur au format application/problem+json (RFC 9457)
object
Code stable d’une erreur de l’API. Liste ouverte : ignorer une valeur inconnue.
Explication propre à cette requête
Identifiant de la requête (aussi en en-tête X-Request-Id) sur une erreur internal-error, à donner au support
Example generated
{ "type": "example", "title": "example", "status": 1, "code": "example", "detail": "example", "requestId": "example"}