Puis-je accéder aux données de Kalisport via une API ?

Retour

Avec le développement des outils d'automatisation et d'intelligence artificielle, nous recevons de plus en plus de demandes concernant l'accès aux données de Kalisport : API, exports automatisés, accès direct aux données, connexion avec un outil externe, etc.

Ces demandes sont légitimes et nous permettent surtout d'identifier de nouveaux usages autour de Kalisport.

Existe-t-il une API Kalisport ?

Oui. Kalisport dispose déjà d'API utilisées par nos propres services, notamment pour permettre les échanges de données avec notre application mobile.

Ces API sont cependant internes : elles ne sont pas publiques et ne sont pas destinées à être utilisées directement par les clubs ou par des services tiers.

À ce jour, nous ne prévoyons pas à court terme l'ouverture d'une API publique permettant d'interroger librement les données de votre espace Kalisport.

Pourquoi ne pas ouvrir simplement l'API existante ?

Une API publique ne consiste pas uniquement à rendre accessibles des points d'entrée déjà utilisés par Kalisport.

Une telle ouverture nécessite de déterminer précisément :

les données pouvant être exposées,
les droits d'accès associés à chaque information,
les mécanismes d'authentification et d'autorisation,
la protection des données personnelles et sensibles,
les limites d'utilisation,
la stabilité des données et des formats proposés dans le temps,
la documentation et la maintenance de l'ensemble.

Une API publique devient un véritable produit que nous devons être capables de maintenir dans la durée.

Si nous ouvrons demain certaines données de Kalisport, nous souhaitons donc le faire de manière maîtrisée, sécurisée et pérenne.

Derrière une demande d'API se cache souvent un besoin fonctionnel

C'est probablement le point le plus important.

Une API est une solution technique. Ce qui nous intéresse en premier lieu est le besoin que vous cherchez à résoudre.

Par exemple, un club peut souhaiter :

connaître en temps réel l'état des adhésions des joueurs d'une équipe avant un entraînement,
transmettre automatiquement certaines informations aux responsables d'équipe,
suivre le nombre de préinscriptions et d'adhérents,
connaître le nombre de renouvellements et de nouveaux adhérents,
disposer de statistiques par équipe, catégorie ou niveau,
connecter Kalisport avec un autre outil utilisé par le club.

Dans certains cas, une API pourrait effectivement permettre à un club de développer lui-même une réponse.

Mais si plusieurs clubs rencontrent le même besoin, nous préférons nous demander :

Comment pouvons-nous répondre directement à ce besoin dans Kalisport ?

Un nouvel indicateur, un tableau de bord, une automatisation ou une intégration avec un service tiers peut alors être plus pertinent qu'une API nécessitant que chaque club développe et maintienne sa propre solution.

Notre approche : privilégier les solutions mutualisées

Depuis le début, notre objectif est de construire Kalisport autour des besoins communs aux clubs et structures sportives.

Nous préférons donc prendre le temps de recenser vos besoins et, lorsqu'ils sont suffisamment partagés, concevoir une solution intégrée dont pourra bénéficier le plus grand nombre.

Cela évite également la multiplication de développements spécifiques réalisés autour de Kalisport, que nous ne maîtrisons pas et dont nous ne pouvons garantir ni la sécurité, ni la compatibilité, ni le fonctionnement dans le temps.

Cela ne signifie pas que nous sommes opposés au principe d'une API publique. Simplement, son ouverture doit répondre à des usages suffisamment identifiés et être conçue comme une véritable fonctionnalité de Kalisport.

Puis-je obtenir un accès direct à la base de données ?

Non.

Nous ne proposons pas d'accès direct à la base de données Kalisport, y compris en lecture seule.

Notre modèle de données est interne à Kalisport et évolue régulièrement avec la plateforme. Il contient également des informations dont l'accès doit respecter les droits des utilisateurs et les règles de protection des données.

Un accès direct contournerait une partie des mécanismes permettant justement de contrôler et de sécuriser ces accès.

Lorsqu'un besoin nécessite de récupérer ou d'exploiter des données, nous préférons donc étudier l'usage recherché et la manière appropriée d'y répondre.

J'ai justement un besoin : que dois-je faire ?

Parlez-nous d'abord de votre besoin plutôt que de la solution technique que vous avez imaginée.

Plutôt que :

"J'aurais besoin d'une API pour récupérer les adhérents."

Expliquez-nous par exemple :

"Je souhaite que mes entraîneurs puissent connaître l'état des adhésions de leurs joueurs avant chaque entraînement."

Ou :

"Je souhaite suivre en temps réel le nombre de renouvellements et de nouveaux adhérents par catégorie."

Précisez-nous ce que vous souhaitez réaliser, qui doit pouvoir accéder à l'information, à quel moment et, le cas échéant, avec quel autre service vous souhaitez échanger des données.

Vos demandes nous permettent d'identifier les usages communs et d'orienter les prochaines évolutions de Kalisport.

En résumé : Kalisport dispose déjà d'API pour ses propres services, mais ne propose actuellement ni API publique ni accès direct à sa base de données. Nous préférons partir de vos usages, recenser les besoins communs et construire des solutions intégrées, sécurisées et pérennes dont pourra bénéficier le plus grand nombre.

Pour aller plus loin

Rechercher dans l'aide en ligne