Intégrez les résultats de judo sur n'importe quel site
Wix, Squarespace, Jimdo, Google Sites, ou site sur mesure — un code à copier-coller suffit. Deux méthodes : iframe (recommandé) ou JavaScript (avancé).
Iframe ou JavaScript ?
Iframe
- Un seul code à coller
- Compatible tous les éditeurs de site
- Aucune compétence technique requise
- Affiché dans un cadre (séparé du reste de la page)
JavaScript
- S'intègre directement dans votre page
- Rendu plus harmonieux (pas de cadre)
- Thème clair ou sombre
- Nécessite un accès au code HTML de la page
Méthode 1 — Iframe
Copiez ce code et collez-le dans votre page (bloc HTML, embed, ou éditeur de code selon votre plateforme).
<iframe src="https://judo-results.fr/embed?key=VOTRE_CLE_API"
width="100%" height="600" frameborder="0"
title="Résultats Judo"></iframe>
Remplacez VOTRE_CLE_API par votre clé (disponible dans Mon organisation, section « Sites autorisés »).
Options
| Paramètre | Valeurs | Description |
|---|---|---|
| seasons | 1, 2 ou 3 | Nombre de saisons affichées (défaut : 1) |
Exemple avec 3 saisons : /embed?key=jr_xxx&seasons=3
Comment intégrer selon votre plateforme
Wix
Ajoutez un élément "HTML Embed" (via Ajouter → Embed → Custom embeds → Embed a widget). Collez le code iframe.
Squarespace
Ajoutez un bloc "Code" dans votre page. Collez le code iframe. Assurez-vous que l'option "Display source" est décochée.
Jimdo
Ajoutez un "Widget/HTML" dans votre page. Collez le code iframe dans le champ de code.
Google Sites
Allez dans Insérer → Incorporer → "Incorporer du code". Collez le code iframe.
Méthode 2 — JavaScript (avancé)
Pour les sites sur mesure : les résultats s'intègrent directement dans votre page, sans cadre. Nécessite un accès au code HTML de votre page.
<div id="judo-results"></div>
<script src="https://judo-results.fr/widget.js"
data-key="VOTRE_CLE_API" async></script>
Options
| Attribut | Valeurs | Description |
|---|---|---|
| data-key | jr_xxx | Votre clé API (obligatoire) |
| data-theme | light / dark | Thème clair ou sombre (défaut : clair) |
| data-seasons | 1, 2 ou 3 | Nombre de saisons (défaut : 1) |
| data-container | ID | ID de l'élément conteneur (défaut : judo-results) |
Référence technique
Ces endpoints sont utilisés automatiquement par l'iframe et le widget JS. Listés ici à titre de référence pour les développeurs.
| Endpoint | Description |
|---|---|
| GET /embed?key=jr_xxx | Page HTML complète (liste) — iframe |
| GET /embed/competitions/{'{id}'}?key=jr_xxx | Page HTML complète (détail) — iframe |
| GET /widget/competitions?key=jr_xxx | Fragment HTML (liste) — widget JS |
| GET /widget/competitions/{'{id}'}?key=jr_xxx | Fragment HTML (détail) — widget JS |
| GET /widget.js | Script d'intégration (~9 Ko) |
| GET /widget.css | CSS des résultats (scopé, light + dark) |