Garmin Health API: частые вопросы и ответы

Garmin Health API собирает данные со всех носимых и фитнес-устройств Garmin и некоторых внешних датчиков. Через него можно получать данные о здоровье за весь день и о тренировках из Garmin Connect. API предназначен для корпоративного использования и позволяет быстро сделать устройства Garmin частью вашей платформы.

Для каких проектов подходит Health API?

Для сервисов, которые работают с данными о здоровье пользователей: корпоративные программы здоровья, проекты в области здоровья населения, удалённый мониторинг пациентов. После заявки с описанием вашего бизнеса команда Garmin свяжется с вами и вместе с вами решит, подходит ли проект и как лучше использовать API.

Можно ли включить устройства Garmin в свой проект или предложение?

Да. В заявке на Health API укажите примерное число устройств, которые вы планируете поддерживать. Команда Garmin Health обсудит с вами, как лучше продавать и выдавать устройства вашим пользователям.

Сколько это стоит?

За доступ к программе Garmin Connect Developer Program, в которую входит Health API, Garmin не берёт лицензионных платежей и платы за обслуживание. Программа только для бизнеса, и для коммерческого использования некоторых показателей может потребоваться лицензионный платёж или минимальный заказ устройств.

Как проходит интеграция и сколько она длится?

1. Вы отправляете заявку на Health API.
2. В течение двух рабочих дней Garmin сообщает о решении.
3. После одобрения вы получаете доступ к порталу разработчика и можете сразу начинать интеграцию.
4. Параллельно проводится созвон, на котором команда Garmin разбирает ваши задачи и технические детали API.

Garmin рассматривает заявку в течение двух рабочих дней, а сама интеграция обычно занимает от 1 до 4 недель. После одобрения доступна тестовая среда для проверки API.

Какие данные предоставляет API?

Предварительно обработанные данные в формате JSON:

• подробности тренировок: пульс, скорость, каденс, темп и другие;
• ежедневные сводки: шаги, расстояние, калории;
• подробные данные о стрессе, сне и пульсе;
• сводки по времени за весь день.

Файлы FIT (а также TCX и GPX) доступны по отдельному запросу — напишите в поддержку программы для разработчиков: connect-support@developer.garmin.com.

Что если нужных данных нет?

Напишите в поддержку Health API с запросом. Команда старается добавлять новые типы данных к выходу новых устройств, но не всегда может предоставить каждый показатель.

Можно ли получать данные прямо с устройства?

Нет. Пользователь сначала загружает данные в Garmin Connect, и только после этого они доступны через API. Для работы напрямую с устройством существует Garmin Health SDK.

Технические детали

• Авторизация: OAuth 2.0.
• Передача данных: на выбор Ping/Pull или Push.

Нужен ли Health API для разработки приложений Connect IQ?

Нет. Health API и Connect IQ — разные программы, одна не требует другой. Для создания циферблатов, виджетов и приложений Connect IQ есть бесплатный SDK.

Читайте также

• Garmin Health API: обзор
• Garmin Health SDK: обзор
• Connect IQ SDK