De Garmin Connect SDK was bedoeld als praktisch hulpmiddel voor mijn eigen data. De laatste tijd komt er een prettig soort signaal bij: vragen van mensen die hem proberen, interesse van mensen die erop willen bouwen en bedankjes van mensen die hem al gebruiken. Geen volksbeweging. Wel genoeg echte mensen om het project minder als een privéla te laten voelen.
De reden is niet ingewikkeld. Garmin heeft een grote developercommunity, maar nog steeds geen publieke consumenten-API voor het gewone “ik bezit deze data en wil hem uitlezen”-gebruik. Garmin heeft wel een officieel Connect Developer Program, maar dat richt zich op goedgekeurde zakelijke en platformintegraties. Persoonlijke developers kijken daardoor naar dezelfde data door een veel smallere deur.
De SDK gebruikt de onofficiële route. Het is een TypeScript-wrapper rond de Garmin Connect-onderdelen die ik nodig heb: activiteiten, slaap, health metrics, devices en een paar experimentele planningsideeën. Read-first, omdat data schrijven een andere risicoklasse is. Voorzichtig, omdat private endpoints veranderen, rate limits geen productbelofte zijn en een loginflow nog geen vergunning is om te doen alsof de service van jou is.
De communityreactie is nuttig bewijs, maar geen toestemming om het project groter te verkopen dan het is. Een paar mensen die zeggen “dit hielp” betekent niet dat de SDK voor altijd stabiel is, officieel ondersteund wordt of geschikt is voor elk productiesysteem. Het betekent dat het ontbrekende publieke oppervlak echt genoeg is om mensen een omweg te laten bouwen.
Dat geeft de maintainer ook verantwoordelijkheid. Hou de scope duidelijk. Print geen credentials in voorbeelden. Verzamel niet andermans gezondheidsdata omdat een demo het toevallig makkelijk maakt. Maak van een private endpoint geen zelfverzekerde belofte over morgen. Beschrijf wat de SDK leest, wat hij niet schrijft en waar Garmin de vloer eronder kan weghalen.
Ik heb nog steeds liever een officiële consumenten-API. Dat zou veiliger zijn voor gebruikers, rustiger voor maintainers en beter voor het ecosysteem. Tot die tijd kan bruikbare onofficiële tooling bestaan, zolang die eerlijk blijft over de vloer waarop ze staat.
Voor nu is het beste signaal simpel: mensen gebruiken hem en stellen zinnige vragen. Dat is genoeg reden om de boundary, de docs en de foutmeldingen beter te maken. Het is geen reden om een private API stabiel te noemen. Garmin mag dat mysterie zelf houden.