Écrire une séance d'entraînement sur une montre Garmin par API
Contrairement à ce qu'on lit souvent, Garmin expose bien une API officielle capable d'écrire des séances structurées sur le compte d'un utilisateur. Elle existe, elle est documentée, et elle est fermée par défaut. Voici ce qu'elle permet exactement, et quelles sont les alternatives quand on n'y a pas accès.
Dernière mise à jour : 2026-08-24
Trois voies, et une seule est officielle
Faire arriver une séance sur une montre Garmin sans la saisir à la main revient toujours à l'une de ces trois approches. Elles ne se valent pas, ni en fiabilité ni en conditions d'accès.
| Voie | Ce qu'elle demande | Fiabilité |
|---|---|---|
| API officielle Training | Un agrément au Garmin Developer Program. L'utilisateur autorise l'accès sur un écran Garmin, sans jamais donner son mot de passe. | Stable : c'est un contrat public que Garmin maintient. |
| Fichier FIT | Générer un binaire au format FIT, puis le déposer par câble USB dans le dossier de la montre, ou le faire passer par une plateforme tierce. | Fiable mais manuelle : aucune synchronisation automatique. |
| Endpoints privés de Garmin Connect | L'identifiant et le mot de passe Garmin de l'utilisateur, stockés par l'outil qui s'en sert. | Précaire : ces adresses ne sont pas publiques et peuvent changer sans préavis. |
La troisième voie est de loin la plus répandue dans les projets communautaires, parce qu'elle ne demande aucune autorisation. C'est aussi celle qui expose le plus l'utilisateur, et celle qui casse le jour où Garmin modifie son site.
Ce que permet vraiment la Training API
L'API Training de Garmin, dans sa version 2, couvre deux gestes distincts qu'il ne faut pas confondre : créer une séance dans la bibliothèque du compte, et la poser à une date du calendrier. Une séance créée sans être planifiée reste disponible mais n'apparaît pas au jour dit.
Créer et planifier
La création accepte une séance structurée complète : un enchaînement d'étapes typées échauffement, effort, récupération, retour au calme, avec des blocs de répétition imbriqués. Chaque étape porte une condition de fin et, facultativement, une cible.
- Condition de fin : une durée en secondes, une distance en mètres, ou une étape ouverte que l'athlète termine au bouton.
- Cible : une allure, un pourcentage de fréquence cardiaque maximale, une puissance en watts, une cadence, ou rien du tout.
- Répétitions : un bloc peut être répété, ce qui évite de décrire dix fois le même fractionné.
Trois sports, trois vocabulaires
La course, le vélo et la natation en bassin n'acceptent pas les mêmes cibles. Le vélo raisonne en watts absolus, la natation en zones d'allure et en longueur de bassin, la course en allure ou en pourcentage de VMA. Une séance qui mélange les vocabulaires est rejetée, ou pire, acceptée puis vidée de sa cible.
Piège fréquent : une cible de fréquence cardiaque mal déclarée est acceptée par l'API et se retrouve sur la montre en étape libre, sans consigne. La séance existe, mais elle ne pilote rien.
Ce qu'elle ne permet pas
L'API officielle n'est pas une clé passe-partout. Plusieurs limites sont structurelles et il vaut mieux les connaître avant de bâtir dessus.
- L'accès n'est pas libre : il faut candidater au Garmin Developer Program et être agréé. Un particulier ne peut pas s'en servir pour son usage personnel.
- Elle écrit des séances, pas des plans d'entraînement Garmin Coach : ce sont deux objets différents.
- Elle ne redistribue pas les activités enregistrées par des applications tierces. Une sortie faite sur une plateforme d'entraînement virtuel n'arrive pas par ce canal.
- Les notes audio, ajoutées récemment au constructeur de séances de Garmin Connect, ne sont pas exposées.
Ces limites expliquent pourquoi certains outils choisissent délibérément une autre voie. Elles n'en font pas une mauvaise API : elles en font une API de partenaire, avec les contreparties habituelles.
Pourquoi tant d'outils passent ailleurs
Les projets communautaires que l'on trouve publiquement s'appuient presque tous sur une bibliothèque qui simule la connexion de l'application Garmin Connect. Elle fonctionne, elle est simple à installer, et elle demande votre identifiant et votre mot de passe Garmin.
Ce choix a un coût que l'on mesure rarement à l'installation : vos identifiants sortent de chez Garmin, les jetons obtenus expirent vite, et l'outil cesse de fonctionner le jour où Garmin change une adresse interne. Plusieurs de ces projets précisent d'ailleurs eux-mêmes qu'ils ne sont pas destinés à un usage commercial.
Un repère simple avant d'installer quoi que ce soit : si l'outil demande votre mot de passe Garmin, il n'utilise pas l'API officielle. Avec elle, l'autorisation se donne sur un écran Garmin et se retire depuis votre compte Garmin.
Comment Running Workout s'y prend
Running Workout est agréé au Garmin Developer Program et écrit par l'API Training officielle. Concrètement, cela change trois choses pour l'athlète.
- Aucun mot de passe Garmin n'est jamais demandé : le compte se lie une fois sur l'écran d'autorisation de Garmin, et se délie depuis Garmin.
- Les séances sont écrites et planifiées à la date voulue, puis synchronisées sur la montre comme n'importe quelle séance créée à la main.
- Course, vélo intérieur ou extérieur, et natation en bassin sont pris en charge avec les cibles propres à chaque discipline.
Le service expose aussi ces capacités à un assistant IA par un serveur distant, ce qui permet de décrire une séance en langage naturel et de la retrouver au poignet. C'est l'objet du guide de connexion.
Questions fréquentes
Garmin a-t-elle vraiment une API publique pour écrire des séances ?
Oui. L'API Training fait partie du Garmin Developer Program et permet de créer puis de planifier des séances structurées sur le compte d'un utilisateur qui l'a autorisé. Elle est documentée et maintenue. Ce qui n'est pas public, c'est l'accès : il faut être agréé comme partenaire.
Puis-je m'en servir pour mon usage personnel ?
Pas directement. Le programme s'adresse à des services, pas à des particuliers. Pour un usage personnel, il reste le fichier FIT déposé par câble, une passerelle tierce, ou un service déjà agréé qui expose la fonctionnalité.
Un outil qui demande mon mot de passe Garmin est-il dangereux ?
Il n'est pas nécessairement malveillant, mais il vous fait sortir du cadre prévu : vos identifiants sont stockés ailleurs que chez Garmin, vous ne pouvez pas révoquer l'accès depuis votre compte Garmin, et vous dépendez d'adresses internes qui peuvent changer. L'autorisation par écran Garmin évite ces trois problèmes.
Une séance écrite par API arrive-t-elle automatiquement sur la montre ?
Oui, dès lors qu'elle est planifiée à une date : elle descend sur la montre à la synchronisation suivante, exactement comme une séance créée dans Garmin Connect. Une séance créée sans date reste dans la bibliothèque du compte.
Peut-on écrire des séances de natation et de vélo, ou seulement de course ?
Les trois. Chaque sport a ses propres cibles : watts et cadence pour le vélo, zones d'allure et longueur de bassin pour la natation, allure ou pourcentage de VMA pour la course. Il faut respecter le vocabulaire de chacun, sous peine de voir la cible disparaître silencieusement.
Faire écrire vos séances par votre assistant
Running Workout branche Claude, ChatGPT ou Gemini sur votre compte Garmin, par l'API officielle. Rien à installer, aucun mot de passe Garmin à donner.
Voir le guide de connexion