Clé API Garmin + tableau de bord d'entraînement dans Claude Code

Le guide pour créer ta clé API personnelle Garmin et le prompt à coller dans Claude Code pour qu'il te construise ton tableau de bord d'entraînement.

Ce que tu te construis

Garmin donne maintenant à chaque utilisateur une clé API personnelle. C'est la voie officielle : pas de mot de passe à partager, pas de bibliothèque non officielle, et ça atteint tout ton historique. Chez moi ça remonte à juillet 2021 : 1589 activités, 1894 jours de pas, la fréquence cardiaque au repos, le stress, la Body Battery, 1638 nuits de sommeil et chaque nuit de variabilité cardiaque depuis que la montre l'enregistre.

Ce qu'il te faut

À coller dans Claude Code, pas dans une discussion Claude classique : le guide crée des fichiers et lance des commandes sur ton ordinateur, ce qu'une fenêtre de chat ne sait pas faire.

Étape 1 : créer ta clé

  1. Connecte-toi à Garmin Connect sur le web
  2. Va dans Paramètres, puis Clé API personnelle : connect.garmin.com/modern/settings/personalApiToken
  3. Clique sur Créer une clé
  4. Choisis la durée de validité : 30 jours, 90 jours, 180 jours ou un an
  5. Copie la clé tout de suite, elle ne s'affiche qu'une seule fois. Garde-la comme un mot de passe.

La documentation officielle est ici : developer.garmin.com/gc-developer-program/personal/personal-api

Garmin t'envoie un mail une semaine avant l'expiration, et tu peux créer une nouvelle clé à tout moment.

Étape 2 : le prompt

Ouvre Claude Code dans un dossier vide, puis colle ça :

Tu vas m'aider à exploiter mes données Garmin avec ma clé API personnelle.

1. Explique-moi comment récupérer ma clé API personnelle sur connect.garmin.com/modern/settings/personalApiToken, puis demande-la moi.
2. Enregistre-la dans un fichier .env local, et ajoute .env à .gitignore pour qu'elle ne sorte jamais de mon ordinateur.
3. Échange la clé contre un token d'accès via l'endpoint Obtain Token sur personal.connectapi.garmin.com, en passant la clé dans l'en-tête Authorization.
4. Récupère tout mon historique disponible : activités (résumés JSON et fichiers FIT), résumés quotidiens (pas, fréquence cardiaque au repos, stress, Body Battery), sommeil et variabilité cardiaque. Stocke tout en local.
5. Fais-moi un inventaire : depuis quand remontent mes données, combien d'activités, combien de jours couverts, mois par mois.
6. Pose-moi 3 questions courtes sur mon entraînement (objectif, sports principaux, style visuel que j'aime).
7. Construis un tableau de bord HTML autonome qui s'ouvre dans mon navigateur : charge d'entraînement, fatigue, distance et temps cumulés, heures par mois par sport, sommeil et variabilité cardiaque.
8. Ouvre-le et dis-moi ce que mes données racontent sur ma progression.

Étape 3 : laisse tourner

Claude Code te demande ta clé, enregistre tout, télécharge ton historique, te pose ses questions et génère la page. Tu l'ouvres dans ton navigateur et tu as ton propre tableau de bord d'entraînement.

Une question ? Réponds directement à ce message.