Cyclinganalytics Integration
With Terra's Cyclinganalytics web API integration, your app will receive all the information users would share with their coaches through Cyclinganalytics. All the planned & achieved metrics for a workout will be sent to your app through the Cyclinganalytics API integration with Terra, such as calories burned, users' heart rate throughout their workout, and even cadence & torque for cycling activities. Beyond this, the Terra API will send you detailed body measurements including users' BMR, BMI, weight and muscle information among others.
cyclinganalytics integration
STEP 1
What you need to integrate with Cyclinganalytics
cyclinganalytics integration steps, step 1
Terra API Key
Once you sign up, we will provide you with an API key used to access our API
cyclinganalytics integration steps, step 2
Developer ID
We will provide you with a Developer ID, which allows Terra to identify users that belong to you, and associate API traffic to you.
cyclinganalytics integration steps, step 3
Webhook URL
You will need to set up a server (or use a testing environment like https:// webhook.site) that accepts POST requests from Terra
STEP 2
Data Format

All data is sent to your webhook in JSON format in the form of 5 different types of payloads: Activity. Depending on your needs, you may select a subset of the aforementioned, and request less data from your users.

Examples of data payloads can be found here. If you would only like to receive specific fields out of the ones available, you may also select only the ones relevant to your needs and omit the rest. The following is an example of the data payload you may expect from an activity coming from Terra.

STEP 3
Receiving data for your Cyclinganalytics integration - WEBHOOKS

Whenever data become available from a Cyclinganalytics device, they will be streamed to you, via our webhooks. When setting up your Terra account, you will be prompted to provide a callback URL, to which Terra may send PUSH data using POST requests.

Your Cyclinganalytics integration with Terra supports instant delivery of data without needing to periodically request it yourself. Cyclinganalytics notifies Terra whenever new data is available, following which we POST the normalized data to your webhook.

Cyclinganalytics
receiving data from cyclinganalytics integration via webhooks to your app or website
STEP 4
Historical data from HTTP requests

You may also use HTTP requests with your Cyclinganalytics integration in case you wish to request historical data or data over extended periods of time.

Most HTTP endpoints can take additional parameters start_date and end_date which allow you to request data over a specific period for the given user.

The type of data that Cyclinganalytics has
You can access the following data through your Cyclinganalytics integration with the Terra API
cyclinganalytics integration ACTIVITY datacyclinganalytics integration BODY datacyclinganalytics integration DAILY datacyclinganalytics integration MENSTRUATION datacyclinganalytics integration NUTRITION datacyclinganalytics integration SLEEP data
cyclinganalytics integration data types
Activity .JSON