razzant/ouroboroshub/whoop-health

WHOOP Health v0.3.1

Extension skill для Ouroboros — собирает данные со смарт-браслета WHOOP через официальный API v2 (https://api.prod.whoop.com/developer/v2; API v1 больше не поддерживается WHOOP).

Аутентификация — OAuth2 Authorization Code Flow

Первичная настройка

1. Зарегистрируйте приложение на developer.whoop.com

и укажите в нём redirect URI (по умолчанию http://localhost:8080/callback)

1. Получите client_id и client_secret
2. Положите их в секреты Ouroboros: WHOOP_CLIENT_ID, WHOOP_CLIENT_SECRET
3. Вызовите whoop_auth_url — получите URL для авторизации в браузере
4. Откройте URL, авторизуйтесь, скопируйте code из redirect
5. Вызовите whoop_exchange_code с полученным кодом
6. Готово — токены сохранены, все data-инструменты работают автоматически

Обновление токенов

Access token обновляется автоматически через refresh token при получении 401/403 от API (scope offline запрашивается по умолчанию, без него WHOOP не выдаёт refresh token). Токены сохраняются в файл whoop_tokens.json в state-директории навыка (права 0600) и переживают рестарты.

Инструменты

Зоны восстановления

whoop_fetch(RECOVERY) добавляет score.recovery_zone к записи с оценкой; whoop_summary возвращает ту же зону в recovery.recovery_zone. Исходный recovery_score и остальные измерения сохраняются. Для числового процента 0–100: red ≤33, yellow >33 и ≤66, green >66, без округления. WHOOP описывает зоны как 0–33%, 34–66% и 67–100%; API задаёт число типа float, но не уточняет округление между целыми границами. Поэтому для дробных значений здесь явно указано правило этого навыка. Отсутствующее, нечисловое, бесконечное, NaN или выходящее за 0–100 значение даёт null, а не предполагаемый цвет. Записи без оценки сохраняют отсутствующий или null score; в сводке такие измерения равны null, пустая коллекция по-прежнему не добавляет раздел. Флаг recovery.user_calibrating в сводке сохраняет предупреждение WHOOP о недостаточных данных при калибровке; null означает, что флаг не получен. Зона — категория данных, не медицинский совет.

Данные и права

• Запросы идут только к api.prod.whoop.com; данные никуда, кроме ответа

инструмента, не отправляются.

• Права: tool, read_settings (только два ключа выше), net.
• Зависимостей нет — только стандартная библиотека Python.