API et tokens¶
Connectez vos propres outils à My Live Sport : tableau de bord, traitement de résultats, régie ou automatisation. Les contrats et les exemples de cette rubrique sont publics. Un jeton reste nécessaire pour accéder aux données web ; la consultation de l’aide ne donne aucun accès à vos matchs.
| Besoin | API à utiliser | Accès |
|---|---|---|
| Lire les championnats, matchs, événements, compositions ou classements depuis un service externe | API web | Jeton d’entreprise créé par un administrateur dans Compte → API et tokens. |
| Créer ou modifier des événements dans un match depuis votre outil | API web | Jeton avec Lecture et écriture d’événements, droits sur le match et licence valide. |
| Piloter les boutons, le chrono et les habillages du poste de régie | API locale AppSport | API activée dans AppSport settings → Local API, match chargé, clé locale si exigée. |
| Utiliser Bitfocus Companion | API locale AppSport | Téléchargement et guide du module Companion. |
| Recevoir les scores et horloges de Scoreboard OCR | Entrée OCR de l’API locale | Configuration et sorties OGraf, vMix et CasparCG. |
Créer et utiliser un jeton web Comprendre l’API locale Consulter les Swagger publics
Les jetons web et les clés locales sont indépendants. Un jeton web ne commande pas les sorties du PC et ne remplace pas la clé à renseigner dans Companion.
La rubrique API et tokens, le Swagger intégré et les endpoints de gestion sont réservés aux administrateurs de l’entreprise. Les autres utilisateurs n’y ont pas accès. Un administrateur ne peut gérer que les jetons des entreprises qu’il administre ; chaque jeton est limité aux données de l’entreprise choisie et à sa licence active.
Documentation Swagger et contrats OpenAPI¶
- Swagger de l’API web et contrat OpenAPI web.
- Swagger de l’API locale et contrat OpenAPI local.
- Swagger avec essais dans l’application : connexion avec un compte administrateur d’entreprise puis Authorize avec un jeton d’entreprise. Les opérations POST effectuent des écritures réelles.
L’API web expose les opérations décrites dans son contrat. Les autres routes internes de l’application, la gestion des comptes, les imports, les suppressions et le rendu ne sont pas autorisés par ces jetons.