Aller au contenu

Garmin Connect

PeakLine s'intègre directement à Garmin Connect, principalement comme moyen de récupérer des données de bien-être (sommeil, HRV, body battery) et comme pipeline de secours pour les activités qui ne sont pas parvenues jusqu'à Strava.

Bêta

L'intégration Garmin est en bêta. L'intégration Strava reste le chemin principal recommandé pour la synchronisation des activités ; Garmin est surtout utile pour les données que Strava n'expose pas.

Ce que vous pouvez récupérer depuis Garmin

L'intégration utilise l'API basée sur session propre à Garmin (le même flux que celui utilisé par le site officiel Garmin Connect). Une fois connecté, PeakLine peut lire :

  • Activités — y compris celles marquées comme privées sur Strava, puisque Garmin voit tout ce que votre appareil enregistre.
  • Données de sommeil — sommeil total, phases de sommeil (léger / profond / paradoxal / éveillé), score de sommeil.
  • Variabilité de la fréquence cardiaque (HRV) — mesure HRV quotidienne au réveil, référence sur 7 jours, statut (Équilibré / Déséquilibré / Bas / Faible).
  • Body Battery — la métrique de réserve d'énergie de Garmin au fil de la journée.
  • Stress — le score de stress autonome de Garmin, sur toute la journée.
  • FC au repos — tendance quotidienne de la fréquence cardiaque au repos.
  • Charge d'entraînement et récupération — les estimations propres à Garmin de charge d'entraînement et de temps de récupération.

Ce que nous ne lisons pas : les données de santé détaillées (SpO₂, température cutanée, suivi menstruel, etc.). Cela sort du périmètre d'un outil de performance sportive.

Connexion

  1. Ouvrez Paramètres → Intégrations → Garmin dans PeakLine.
  2. Saisissez votre e-mail et votre mot de passe Garmin Connect.
  3. Si votre compte a la MFA activée (cela devrait être le cas), vous serez invité à saisir le code à 6 chiffres de votre application d'authentification.
  4. PeakLine établit une session et stocke un jeton de session chiffré. Nous ne stockons pas votre mot de passe — il est utilisé une seule fois pour obtenir la session, puis immédiatement supprimé.

La session est renouvelée automatiquement lorsqu'elle expire. Si un renouvellement échoue (Garmin invalide parfois les sessions après une longue période d'inactivité), vous serez invité à vous reconnecter.

Ce qu'affiche le tableau de bord

Avec Garmin connecté, le tableau de bord fait apparaître :

  • Tendance HRV — 7 / 28 derniers jours, avec icône de statut.
  • Sommeil de la nuit dernière — durée, phases, score.
  • Body battery actuelle — niveau actuel + le graphique des dernières 24 heures.
  • Moyenne du stress sur 7 jours — utile comme indicateur de récupération.

Ces éléments apparaissent sous forme de cartes supplémentaires au-dessus du flux d'activités. Rien de tout cela ne remplace les données Strava — les intégrations coexistent.

Comment la HRV interagit avec l'entraînement

La HRV est le meilleur indicateur simple de la récupération autonome. PeakLine l'utilise comme vérification de cohérence des Stress Points : si vos SP glissants sur 7 jours sont élevés et que votre HRV est restée en dessous de la référence pendant 3 jours ou plus, le tableau de bord fait apparaître une bannière jaune « surmenage potentiel ».

Ceci est purement informatif. PeakLine n'ajuste pas automatiquement votre plan d'entraînement ; il vous montre simplement les tendances.

Limitations

  • API non officielle. Garmin ne publie pas d'API partenaire officielle pour les particuliers. L'intégration utilise les mêmes appels que l'application web Garmin Connect, ce qui signifie que :
    • Garmin peut modifier l'API à tout moment, ce qui peut casser l'intégration jusqu'à ce que nous la mettions à jour.
    • Certains types de comptes (par exemple entreprise / gérés en famille) peuvent ne pas fonctionner.
  • Pas d'accès en écriture. PeakLine ne peut pas renvoyer d'activités, d'entraînements ou d'itinéraires vers Garmin Connect. (Garmin n'expose pas d'API en écriture pour les intégrations non officielles.)
  • Codes MFA. Chaque reconnexion nécessite un nouveau code MFA — Garmin n'émet pas de jetons à longue durée de vie pour les applications non partenaires.
  • Comptes partagés en famille. Si vous avez un compte Garmin « familial », PeakLine ne voit que l'athlète principal.

Confidentialité

Le jeton de session Garmin chiffré réside dans notre base de données aux côtés de votre compte PeakLine. Déconnecter Garmin supprime le jeton de session immédiatement. Supprimer votre compte PeakLine le purge également.

Nous ne transmettons jamais vos identifiants Garmin où que ce soit, sauf au point de connexion (endpoint) de login propre à Garmin, et uniquement au moment de la connexion / reconnexion.

Voir aussi