Escribir un entrenamiento en un reloj Garmin por API
Al contrario de lo que se lee a menudo, Garmin sí ofrece una API oficial capaz de escribir entrenamientos estructurados en la cuenta de un usuario. Existe, está documentada y está cerrada por defecto. Esto es exactamente lo que permite, y cuáles son las alternativas cuando no se tiene acceso.
Última actualización: 2026-08-24
Tres vías, y solo una es oficial
Hacer llegar un entrenamiento a un reloj Garmin sin introducirlo a mano se reduce siempre a uno de estos tres enfoques. No son equivalentes, ni en fiabilidad ni en condiciones de acceso.
| Vía | Qué requiere | Fiabilidad |
|---|---|---|
| API oficial Training | Una acreditación en el Garmin Developer Program. El usuario autoriza el acceso en una pantalla de Garmin, sin dar nunca su contraseña. | Estable: es un contrato público que Garmin mantiene. |
| Archivo FIT | Generar un binario en formato FIT y copiarlo por cable USB en la carpeta del reloj, o hacerlo pasar por una plataforma de terceros. | Fiable pero manual: ninguna sincronización automática. |
| Endpoints privados de Garmin Connect | El usuario y la contraseña de Garmin de la persona, almacenados por la herramienta que los utiliza. | Precaria: estas direcciones no son públicas y pueden cambiar sin previo aviso. |
La tercera vía es, con diferencia, la más extendida en los proyectos de la comunidad, porque no requiere ninguna autorización. También es la que más expone al usuario, y la que se rompe el día en que Garmin modifica su sitio web.
Lo que permite de verdad la Training API
La API Training de Garmin, en su versión 2, cubre dos acciones distintas que no hay que confundir: crear un entrenamiento en la biblioteca de la cuenta y colocarlo en una fecha del calendario. Un entrenamiento creado sin programar sigue disponible, pero no aparece el día previsto.
Crear y programar
La creación acepta un entrenamiento estructurado completo: una secuencia de pasos de tipo calentamiento, esfuerzo, recuperación o vuelta a la calma, con bloques de repetición anidados. Cada paso lleva una condición de fin y, opcionalmente, un objetivo.
- Condición de fin: una duración en segundos, una distancia en metros o un paso abierto que el atleta termina pulsando el botón.
- Objetivo: un ritmo, un porcentaje de la frecuencia cardíaca máxima, una potencia en vatios, una cadencia o nada en absoluto.
- Repeticiones: un bloque se puede repetir, lo que evita describir diez veces la misma serie.
Tres deportes, tres vocabularios
La carrera, el ciclismo y la natación en piscina no aceptan los mismos objetivos. El ciclismo trabaja en vatios absolutos, la natación en zonas de ritmo y longitud de la piscina, la carrera en ritmo o en porcentaje de la VAM. Un entrenamiento que mezcla los vocabularios es rechazado o, peor aún, aceptado y después vaciado de su objetivo.
Trampa frecuente: un objetivo de frecuencia cardíaca mal declarado es aceptado por la API y acaba en el reloj como un paso libre, sin indicación. El entrenamiento existe, pero no guía nada.
Lo que no permite
La API oficial no es una llave maestra. Varios límites son estructurales y más vale conocerlos antes de construir sobre ella.
- El acceso no es libre: hay que presentar una solicitud al Garmin Developer Program y ser aprobado. Un particular no puede usarla para su uso personal.
- Escribe entrenamientos, no planes de entrenamiento Garmin Coach: son dos objetos diferentes.
- No redistribuye las actividades registradas por aplicaciones de terceros. Una salida hecha en una plataforma de entrenamiento virtual no llega por este canal.
- Las notas de audio, añadidas recientemente al creador de entrenamientos de Garmin Connect, no están expuestas.
Estos límites explican por qué algunas herramientas eligen deliberadamente otra vía. No la convierten en una mala API: la convierten en una API de socio, con las contrapartidas habituales.
Por qué tantas herramientas van por otro lado
Los proyectos de la comunidad que se encuentran públicamente se apoyan casi todos en una biblioteca que simula el inicio de sesión de la aplicación Garmin Connect. Funciona, es fácil de instalar y pide tu usuario y tu contraseña de Garmin.
Esta elección tiene un coste que rara vez se valora al instalar: tus credenciales salen de Garmin, los tokens obtenidos caducan rápido y la herramienta deja de funcionar el día en que Garmin cambia una dirección interna. De hecho, varios de estos proyectos precisan ellos mismos que no están destinados a un uso comercial.
Una referencia sencilla antes de instalar cualquier cosa: si la herramienta pide tu contraseña de Garmin, no usa la API oficial. Con ella, la autorización se concede en una pantalla de Garmin y se retira desde tu cuenta Garmin.
Cómo lo hace Running Workout
Running Workout está aprobado en el Garmin Developer Program y escribe mediante la API Training oficial. En la práctica, eso cambia tres cosas para el atleta.
- Nunca se pide ninguna contraseña de Garmin: la cuenta se vincula una vez en la pantalla de autorización de Garmin y se desvincula desde Garmin.
- Los entrenamientos se escriben y se programan en la fecha deseada, y después se sincronizan con el reloj como cualquier entrenamiento creado a mano.
- Carrera, ciclismo en interior o exterior y natación en piscina son compatibles, con los objetivos propios de cada disciplina.
El servicio también expone estas capacidades a un asistente de IA mediante un servidor remoto, lo que permite describir un entrenamiento en lenguaje natural y encontrarlo en la muñeca. De eso trata la guía de conexión.
Preguntas frecuentes
¿De verdad tiene Garmin una API pública para escribir entrenamientos?
Sí. La API Training forma parte del Garmin Developer Program y permite crear y después programar entrenamientos estructurados en la cuenta de un usuario que lo haya autorizado. Está documentada y mantenida. Lo que no es público es el acceso: hay que estar aprobado como socio.
¿Puedo usarla para mi uso personal?
No directamente. El programa se dirige a servicios, no a particulares. Para un uso personal quedan el archivo FIT copiado por cable, una pasarela de terceros o un servicio ya aprobado que ofrezca la funcionalidad.
¿Es peligrosa una herramienta que me pide mi contraseña de Garmin?
No es necesariamente malintencionada, pero te saca del marco previsto: tus credenciales se guardan fuera de Garmin, no puedes revocar el acceso desde tu cuenta Garmin y dependes de direcciones internas que pueden cambiar. La autorización en una pantalla de Garmin evita estos tres problemas.
¿Un entrenamiento escrito por API llega automáticamente al reloj?
Sí, siempre que esté programado en una fecha: baja al reloj en la siguiente sincronización, exactamente igual que un entrenamiento creado en Garmin Connect. Un entrenamiento creado sin fecha se queda en la biblioteca de la cuenta.
¿Se pueden escribir entrenamientos de natación y ciclismo, o solo de carrera?
Los tres. Cada deporte tiene sus propios objetivos: vatios y cadencia para el ciclismo, zonas de ritmo y longitud de la piscina para la natación, ritmo o porcentaje de la VAM (velocidad aeróbica máxima) para la carrera. Hay que respetar el vocabulario de cada uno, o el objetivo desaparece sin aviso.
Deja que tu asistente escriba tus entrenamientos
Running Workout conecta Claude, ChatGPT o Gemini a tu cuenta Garmin mediante la API oficial. Nada que instalar, ninguna contraseña de Garmin que dar.
Ver la guía de conexión