Classement
Classement d’une saison, une poule à la fois. Les colonnes suivent la forme du classement : aux points (league-table, football, rugby…) ou au pourcentage de victoires (win-percentage, basket).
Le bouton « ⋮ » d’une ligne, ou un clic sur la ligne, déplie la fiche de l’équipe : son prochain match de la saison et ses cinq derniers matchs (score, adversaire, domicile ou extérieur). Ces matchs sont lus à l’ouverture, une fois par équipe. Avec un gabarit de lien team (voir Liens vers vos pages), la fiche porte un bouton « Fiche complète » vers la page de l’équipe sur votre site.
<div data-idalgo-component="RankingTable" data-idalgo-param-season="374703"></div><script src="https://delivery.idalgo.live/sdk/v1.js" async></script>Paramètres
Section intitulée « Paramètres »| Paramètre | Obligatoire | Description | Exemple |
|---|---|---|---|
season |
Oui | Saison (currentSeason.id de /v1/competitions) |
374703 |
group |
Non | Poule (id issu de /v1/seasons/{id}) ; par défaut, la première |
849303 |
split |
Non | overall (défaut), home ou away |
home |
after |
Non | Classement après une journée ; par défaut, la dernière journée jouée | day:6865802 |
lang |
Non | Langue des noms (défaut fr) ; l’interface reste en français (voir Langue) |
en |
mode |
Non | Mode : light (défaut), dark ou auto, qui suit le réglage de l’appareil du lecteur ; par défaut, celui de votre thème (voir Mode sombre) |
dark |
highlight |
Non | Ids d’équipes à mettre en avant, séparés par des virgules | 26603 |
timezone |
Non | Fuseau horaire de vos lecteurs (IANA), pour la date et l’heure du prochain match d’une équipe dépliée (défaut Europe/Paris) |
America/Montreal |
Erreurs et états
Section intitulée « Erreurs et états »En erreur, le widget n’est pas rendu : le SDK affiche « Impossible de charger le widget », avec un
bouton « Réessayer » si l’erreur est passagère (réseau, serveur), ou appelle votre onError (voir
SDK) ; en intégration côté serveur,
la réponse porte le statut, un message et un code stable { "error": "…", "code": "…" }.
| Statut | Cas | Code de l’API |
|---|---|---|
400 |
season absent ou non numérique ; group, split, after, lang, timezone ou mode invalide |
invalid-request |
404 |
Saison inconnue | season-not-found |
404 |
Pas de classement pour cette saison, cette poule ou après cette journée | standings-unavailable |
502 |
API iDalgo injoignable ou réponse non conforme | — |
Dans la fiche dépliée d’une équipe, « Chargement des matchs… » s’affiche pendant la lecture, puis « Aucun match à venir cette saison. » ou « Aucun match joué. » quand il n’y en a pas ; si la lecture échoue, « Les matchs de l’équipe n’ont pas pu être chargés. ».
Le widget lit GET /v1/standings, puis, pour une fiche dépliée, GET /v1/contests (prochain match) et GET /v1/teams/{id}/form (derniers matchs) : les mêmes données sont disponibles en JSON pour vos propres interfaces.