Cum mi-am legat ceasul Garmin de Notion: sistemul complet, pas cu pas

Pe 2 noiembrie, de ziua mea, am primit un Garmin Venu 4. Prima mea întrebare n-a fost ce știe să facă, ci unde ajung datele.

Răspunsul era „în aplicația Garmin”. Și acolo rămâneau.

De ce nu mi-a ajuns aplicația

Afacerea mea stă de mult într-un singur loc: UNBLOCK OS, sistemul din Notion pe care l-am construit pentru mine. Are câte un bloc pentru fiecare parte a afacerii: Command îmi arată totul pe un ecran, Growth ține lead-urile și conținutul, Delivery clienții și proiectele, iar Finance veniturile, cheltuielile și țintele.

Pentru corp nu aveam nimic. Alerg, ies cu bicicleta pe gravel și fac forță și yoga acasă. Scopul meu e simplu: consecvență, nu valuri. Ceasul urma să-mi măsoare somnul, HRV-ul, pulsul și Body Battery, dar le-aș fi văzut într-o aplicație separată, pe care o deschizi când îți aduci aminte.

Așa că în aceeași seară am construit legătura: 20 de noduri în n8n, 2 tabele noi în Notion și niciun abonament nou. A doua zi dimineață, prima noapte completă era deja în Notion, lângă taskurile zilei.

Mai jos e tot sistemul, pas cu pas. Cifrele din exemple sunt inventate, iar la final îți spun sincer ce încă nu merge.

Cum arată sistemul

1. Ceasul se sincronizează cu Garmin Connect, ca de obicei. Nu instalezi nimic pe el.
2. Garmin Personal API îmi dă datele mele: oficial, gratuit și doar pentru citire.
3. n8n le cere din oră în oră, între 6 și 23, și calculează baza mea (media pe 28 de zile).
4. Notion le pune în două tabele și transformă cifrele de dimineață într-un semnal.

Pasul 1: cheia Garmin Personal API

Am avut noroc cu momentul. Pe 21 octombrie 2026, cu 12 zile înainte să primesc ceasul, Garmin a deschis un nivel nou în programul pentru dezvoltatori: Personal. E o cheie pentru o singură persoană și pentru datele ei, pe care o generezi singur, din contul tău Garmin.

Ce trebuie să știi înainte să o creezi:

• E doar pentru citire. Aduce date, dar nu poate trimite nimic pe ceas: nici antrenamente, nici trasee.
• Nu te anunță când apar date noi. Nu are webhookuri, așa că datele se cer periodic. De aici rularea din oră în oră.
• E pentru uz personal. Pentru o aplicație folosită de alți oameni, Garmin are nivelurile Startup și Enterprise, cu alte reguli.
• Expiră. La creare alegi cât e valabilă: 30, 90, 180 sau 365 de zile. Pune-ți un reminder cu o săptămână înainte, altfel sincronizarea se oprește fără să-ți dai seama.
• Citește termenii pe care îi accepți la creare, mai ales dacă vrei să folosești datele cu unelte de AI.
• Păstreaz-o ca pe o parolă. O pui doar în credențialele din n8n, niciodată într-un document, într-un mesaj sau în cod.

Ce date primești și ce lipsește

• Somnul: durata, fazele și scorul.
• HRV-ul: valoarea de noapte, media pe 7 zile și statusul (Balanced, Unbalanced, Low sau Poor).
• Rezumatul zilei: pulsul de repaus, Body Battery, stresul și pașii.
• Activitățile: tipul, durata, distanța, pulsul și fișierul FIT.

Ce nu primești: Training Readiness, Training Status, Acute Load, Endurance Score și Race Predictor. Am verificat în specificația API-ului, care are 26 de endpointuri. Despre ce lipsește și cum am ocolit asta scriu în articolul 4 din serie.

Am comparat cinci căi de a scoate datele din Garmin, iar cheia oficială e singura care a rămas. Comparația completă e în articolul următor.

Pasul 2: workflow-ul din n8n

n8n e unealta de automatizare pe care o folosesc și pentru clienți, de exemplu ca să leg comenzile din WooCommerce de Google Ads. La mine rulează pe un server propriu, dar merge și varianta cloud. Workflow-ul face același lucru la fiecare oră:

1. Pornește la cinci minute după fiecare oră fixă, de la 6:05 la 23:05, ora României.
2. Schimbă cheia pe un token de acces, valabil 24 de ore.
3. Cere ultimele 3 zile: azi, ieri și alaltăieri. Așa prinde și nopțile sincronizate târziu, de exemplu când telefonul a stat departe de ceas.
4. Caută ce există deja în Notion: zilele după dată, activitățile după ID. Actualizează rândurile în loc să le dubleze.
5. Calculează baza mea: media pe 28 de zile pentru HRV și pentru pulsul de repaus, din istoricul de 35 de zile din Notion.
6. Scrie sau actualizează rândurile din cele două tabele.

Trei lucruri care m-au scutit de bătăi de cap:

• Acces minim. Integrarea Notion pe care o folosește n8n vede doar tabelele de care are nevoie, nu tot workspace-ul.
• Erorile nu trec neobservate. Dacă un pas pică, eroarea ajunge într-un workflow separat, făcut doar pentru erori.
• Cheia stă în credențiale. Nodurile o folosesc prin numele credențialei, așa că pot exporta sau arăta workflow-ul fără să expun cheia.

Pasul 3: două tabele în Notion

Jurnal sănătate are un rând pe zi: scorul somnului, HRV-ul de noapte, media HRV pe 7 zile, statusul HRV, pulsul de repaus și Body Battery. Lângă ele stau valorile calculate: baza mea pe 28 de zile pentru HRV și pentru pulsul de repaus, cât de departe sunt de ea, semnalul și recomandarea zilei. Fiecare rând se leagă de pagina zilei din UNBLOCK OS, deci văd energia lângă taskurile acelei zile.

Antrenamente are un rând pe activitate: tipul, durata, distanța și pulsul mediu. Fiecare antrenament se leagă de un obiectiv și de echipamentul folosit. Așa știu câți kilometri au pantofii mei de trail și bicicleta de gravel, fără să număr.

Legăturile fac diferența. Un antrenament nu mai e o cifră izolată într-o aplicație, ci un pas spre un obiectiv pe care îl urmăresc oricum, în același loc cu restul.

Pasul 4: semnalul de dimineață din HRV, somn și Body Battery

Dimineața nu vreau să citesc cinci cifre. Vreau o decizie. Semnalul se uită la cifrele de dimineață și scoate o culoare:

• 🔴 Roșu, zi de recuperare, dacă apare oricare: statusul HRV e Low sau Poor, scorul somnului e sub 50, Body Battery e sub 30, pulsul de repaus e cu 5 bătăi sau mai mult peste baza mea ori media HRV pe 7 zile e cu cel puțin 10% sub baza mea.
• 🟢 Verde, poți trage, doar dacă le bifezi pe toate: HRV Balanced, scorul somnului de cel puțin 70, Body Battery de cel puțin 60 și pulsul de repaus cel mult cu 2 bătăi peste bază.
• 🟡 Galben, în rest: fac antrenamentul planificat, dar nu caut recorduri.

Regulile stau în formula din Notion, iar n8n folosește aceleași reguli ca să scrie recomandarea. Lângă culoare apar motivul și ce fac azi. Un exemplu din kitul SEMNAL, cu date inventate:

Date de exemplu · Garmin Venu 4

Vineri se vede de ce o singură valoare e de ajuns pentru roșu: scorul somnului și Body Battery arată bine, dar statusul HRV e Low, deci ziua e de recuperare.

În kit am păstrat doar primele patru reguli roșii, pentru că statusul HRV din aplicație compară deja media ta pe 7 zile cu normalul tău.

Cum îl folosesc eu

Din noiembrie am un program de forță acasă, pe 6 săptămâni: luni, miercuri și vineri, câte 30 până la 45 de minute. Semnalul nu decide dacă mă antrenez, ci cât:

• 🟢 Verde: sesiunea întreagă.
• 🟡 Galben: o serie mai puțin la fiecare exercițiu și efort mai mic.
• 🔴 Roșu: între 15 și 20 de minute de mobilitate sau yoga.

Și ziua roșie contează ca sesiune făcută, iar regula mea e să nu sar niciodată peste două sesiuni la rând. Asta e toată ideea: nu renunț la antrenament, doar îl dozez. Ținta pe cele 6 săptămâni: cel puțin 15 sesiuni din 18.

De ce media ta, nu a altora

Un HRV de 45 ms nu-ți spune nimic de unul singur. Pentru cineva e o noapte bună, pentru altcineva e mult sub normalul lui. La HRV și la pulsul de repaus contează cât de departe ești de media ta. Scorul somnului și Body Battery au praguri fixe, pentru că sunt deja scoruri calculate de ceas, pe o scară până la 100.

În sistemul automat, baza e media mea pe ultimele 28 de zile, pentru HRV și pentru pulsul de repaus. În kitul manual, baza pentru pulsul de repaus e media pe 7 zile pe care ți-o arată deja aplicația ceasului, iar la HRV te uiți doar la status.

Ce n-a mers și ce încă nu știu

• Prima versiune rula doar la 9 și la 11. În aceeași noapte mi-am dat seama că o alergare de seară ar fi intrat în Notion abia a doua zi, așa că am trecut-o din oră în oră, între 6:05 și 23:05.
• Semnalul meu încă nu e complet. Ceasul are nevoie de aproximativ trei săptămâni de purtat noaptea până își stabilește statusul HRV. Am ceasul de pe 2 noiembrie, deci până spre finalul lui noiembrie semnalul meu judecă fără statusul HRV, doar după celelalte cifre.
• Baza de 28 de zile se formează abia acum. În primele zile, „media mea” e media a câtorva nopți, iar baza completă o am abia la sfârșitul lui noiembrie. De aceea, deocamdată, mă uit la semnal ca la o orientare, nu ca la un verdict.

Nu-ți arăt un sistem care merge perfect de un an. Îți arăt unul construit de ziua mea, care merge deja și devine mai precis cu fiecare noapte.

Limitele, spuse direct

• Nu e sfat medical și nici dispozitiv medical. Semnalul te ajută să-ți dozezi antrenamentul. Cum te simți contează mai mult decât orice culoare.
• Nu înlocuiește Training Readiness. Ceasul are propriul scor, dar API-ul nu-l dă. Semnalul meu e mai simplu: îți arată regulile din spatele culorii, pe cifre pe care le vezi și le poți verifica.
• Pragurile sunt un punct de pornire. Nu sunt validate științific, iar tu le poți schimba direct în formulă.

Vrei regulile fără automatizare?

Nu toată lumea vrea un server cu n8n ca să afle dacă azi aleargă sau doarme mai mult. Pentru asta am pus regulile într-o pagină Notion, kitul SEMNAL: un tabel în care treci dimineața statusul HRV și patru cifre din aplicație (scorul somnului, Body Battery la trezire, pulsul de repaus și media lui pe 7 zile), iar formula îți dă semnalul, motivul și ce faci azi. Durează cam 30 de secunde și e gratuit.

Deschide kitul SEMNAL

Varianta automată, Modulul Health V1 pentru UNBLOCK OS, apare în decembrie. Dacă îmi scrii SEMNAL în mesaj pe Instagram, la @danblocks, primești kitul acolo și afli printre primii când se lansează.

Surse

• Garmin Connect Developer Program: nivelul Personal și întrebările frecvente despre cheia personală
• Garmin: documentația Personal API, cu datele expuse de fiecare endpoint
• Garmin: prezentarea programului pentru dezvoltatori, cu nivelurile Personal, Startup și Enterprise
• DC Rainmaker: analiza noului program Garmin pentru dezvoltatori, 21 octombrie 2026
• Garmin: cum funcționează statusul HRV
• Strava: API Policy, în vigoare din 1 iunie 2026, secțiunea 5.3

Proiect independent, neafiliat cu Garmin. Garmin, Venu, Body Battery și denumirile funcțiilor Garmin sunt mărci ale Garmin Ltd. sau ale filialelor sale. Strava este marcă a Strava, Inc.

Seria Modulul Health, articolul 1 din 6. Următorul: „Cum îți scoți datele din Garmin în 2026: 5 variante comparate”.