Accès API et jetons
Reliez vos propres outils à votre ligue : un site de club qui affiche les terrains en direct, une borne d'accueil, un fil de résultats ou un script qui prépare les tournois. Les administrateurs de la ligue activent l'accès API et créent des jetons API ; les développeurs les utilisent avec les SDK officiels.
Ce qu'un jeton API peut faire
Un jeton appartient à une ligue et y agit avec les permissions choisies : lire les joueurs, les terrains et les parties, enregistrer l'arrivée des joueurs, lancer et terminer des parties, gérer les tournois et les saisons, exporter des données ou gérer les réservations de terrains. Il ne peut jamais gérer les membres, la facturation ou l'accès API lui-même, et il n'atteint que l'API publique, pas le reste de l'application.
Activer l'accès API
Allez dans Configuration > Accès API et activez Autoriser l'accès API. L'accès API est inclus dans les forfaits payants. Seuls les administrateurs ayant la permission Gérer l'accès API voient cette page ; un administrateur du compte peut la donner dans Configuration > Membres. Désactiver l'accès refuse tous les jetons de la ligue, sans les supprimer. Les jetons en cache sur les autres serveurs peuvent continuer de fonctionner jusqu'à l'expiration du cache (jusqu'à 60 secondes par défaut).
Créer un jeton
Choisissez Créer un jeton, donnez-lui un nom qui dit ce qui l'utilise, choisissez sa durée (jusqu'à un an) et cochez les permissions nécessaires. Vous ne pouvez donner que des permissions que vous avez vous-même. Le jeton est alors affiché une seule fois : copiez-le et conservez-le en lieu sûr.
Le jeton n'est affiché qu'une fois et vaut un mot de passe pour votre ligue. Gardez-le sur un serveur ou dans un gestionnaire de secrets ; ne le mettez jamais dans une page web, une application mobile ou un document partagé.
Choisir le minimum de permissions
Ne donnez à un jeton que ce dont son intégration a besoin. Un tableau des scores n'a besoin que de Voir les terrains ; une borne d'accueil a aussi besoin de Changer le statut des joueurs. Les actions faites avec un jeton sont enregistrées sous son nom (API : nom), pour les distinguer des personnes dans l'historique de la ligue.
Expiration et révocation
Chaque jeton cesse de fonctionner à sa date d'expiration. Révoquez un jeton depuis la liste à tout moment : il cesse de fonctionner d'ici une minute. Les jetons appartiennent à la ligue : ils continuent de fonctionner si l'administrateur qui les a créés part, et tout administrateur ayant la permission peut les révoquer. La liste indique la dernière utilisation de chaque jeton.
Webhooks
Avec l'accès API activé, vous pouvez ajouter jusqu'à 2 webhooks dans Configuration > Accès API : League Dispatcher envoie alors chaque événement de la ligue (arrivées, parties lancées et terminées, scores, tournois, changements de réglages) à votre serveur, en direct, avec les mêmes données que les applications. Les webhooks ne sont envoyés que lorsque l'accès API est activé et inclus dans votre forfait.
Quand vous ajoutez un webhook, League Dispatcher lui envoie d'abord un défi de vérification, que votre serveur doit renvoyer ; tant qu'il ne l'a pas fait, le webhook reste « Non vérifié » et ne reçoit aucun événement, si bien que personne ne peut diriger des webhooks vers un serveur qui ne les a pas demandés. Utilisez Vérifier une fois votre serveur prêt, et de nouveau après avoir changé l'URL. Choisissez comment votre serveur reconnaît League Dispatcher. Signature (recommandé) : chaque envoi est signé avec un secret généré pour vous et affiché une seule fois, au format Standard Webhooks, si bien qu'une requête falsifiée ou rejouée est refusée ; renouvelez-le à tout moment, l'ancien secret continue de signer pendant 24 heures. Secret partagé : votre propre secret est envoyé tel quel dans un en-tête que vous nommez (par exemple Authorization). Dans les deux cas, vous pouvez renommer l'en-tête, et chaque envoi contient aussi l'identifiant et le nom de la ligue.
Utilisez Envoyer un événement de test pour vérifier votre point de terminaison. Un envoi en échec est retenté quelques fois avec le même webhook-id, pour que votre serveur puisse ignorer les doublons. Après 5 échecs consécutifs, les envois s'arrêtent une minute, puis un seul nouvel essai décide : l'attente double après chaque nouvel essai en échec, jusqu'à une heure, et les événements ne sont pas renvoyés entre-temps. Un test réussi relance immédiatement les envois. Un point de terminaison qui échoue pendant environ deux jours est mis en pause et affiche la dernière erreur ; corrigez-le, puis réactivez-le dans ses réglages.
Pour les développeurs
SDK officiels pour TypeScript, Python et .NET, avec des exemples prêts à l'emploi. Ils sont expérimentaux : une nouvelle version peut demander des changements dans votre intégration. Voir le guide du développeur.
Chaque opération accessible avec un jeton d’API, avec ses paramètres, ses réponses et des exemples, figure dans la référence de l’API.