How are duplicate webhooks prevented?

It features an idempotency logic section that generates unique keys based on user IDs and timestamps to ensure each data session is only processed once.

How does the skill handle Terra's signature verification?

It implements a standard HMAC-SHA256 verification process using your Terra signing secret, performing constant-time comparison to prevent timing attacks.

Does it support asynchronous processing?

Yes, the skill provides examples for offloading webhook payloads to Celery tasks, allowing your endpoint to respond within the required 5-second window.

Which health data types are supported?

The skill includes handlers for activity (workouts), sleep, body metrics, daily summaries, nutrition, menstruation, and athlete profile updates.

Terra API Webhook Handler

Name: Terra API Webhook Handler
Author: adaptationio

byadaptationio

API開発

Integrates and manages Terra API webhooks for real-time health and wearable device data processing.

概要

This skill provides a comprehensive framework for implementing Terra API webhooks, enabling seamless ingestion of real-time health data from wearables like Garmin, Fitbit, and Oura. It includes production-ready patterns for HMAC-SHA256 signature verification, event parsing for activity, sleep, and body metrics, and asynchronous processing workflows. Whether you are building fitness applications or health monitoring platforms, this skill ensures secure, idempotent, and reliable data synchronization with the Terra ecosystem.

主な機能

Built-in idempotency logic to prevent duplicate event processing
0 GitHub stars
Comprehensive event lifecycle management including auth and deauth events
Pre-configured handlers for activity, sleep, body, and daily metrics
Asynchronous processing patterns using Celery for high reliability
Secure HMAC-SHA256 signature verification and IP whitelisting

ユースケース

Syncing real-time workout and activity data from wearable devices to custom apps
Managing user connection lifecycles and historical data backfills
Building health monitoring dashboards with automated daily summary updates

概要

主な機能

Built-in idempotency logic to prevent duplicate event processing
0 GitHub stars
Comprehensive event lifecycle management including auth and deauth events
Pre-configured handlers for activity, sleep, body, and daily metrics
Asynchronous processing patterns using Celery for high reliability
Secure HMAC-SHA256 signature verification and IP whitelisting

ユースケース

Syncing real-time workout and activity data from wearable devices to custom apps
Managing user connection lifecycles and historical data backfills
Building health monitoring dashboards with automated daily summary updates