We want to let you know about some healthy changes we have now implemented for the Balance Rewards API.
New General Exercise Activity Type:
We have added the ability for you to post activities like:
- Weight Lifting
- Push-Ups
- Sit-Ups
- Cross-Fit
- Jump-Rope
- Rowing
- Yoga
- etc...
All you need to do is send the activity type as:
Along with the duration of the activity in seconds:
"duration": 1200,
"type": "cross-fit"
}
This will reward your users once a day for 20 points*
New Points Total Endpoint:
We have opened up a new endpoint, and we think it will really reward your integrations. The new Balance Rewards points endpoint:
Gives your app the ability to use the oAuth tokens you already have for your users to get the total number of Balance Rewards points a user has!
POST: /api/steps/brpoints/v1?apiKey=YOUR_API_KEY {
"access_token": "ACCESS_TOKEN",
"affiliate_id": "AFFILIATE_ID",
"transaction_id": "1234567890123456",
"act":"getBRPoints"
}
Sample Response:
{
"healthy_choice_points": 10940,
"total_rewards_points": 10940,
"transaction_id": "1234567890123456"
}
Upcoming Rate Limiting Changes:
We going to be adding in some rate limiting on March 26th, 2015 at 12:00 AM CST.
So what does this mean?
| Endpoint | Requests Per Minute (RPM) |
|---|---|
| /api/steps/brpoints/v1 | 500 RPM |
| /api/steps/activity/v1 | 500 RPM |
| /api/oauthtoken/delete/v1 | 500 RPM |
| /api/oauthtoken/v1 | 500 RPM |
The Rate limiting amount was based upon the highest activity we had seen from a review done of the current integrations.
Let us know if you have any concerns via a quick message to our email address below.
*Disclaimer: Daily limit of 20 points for general exercise fitness activities (one award per day).