20 Sep Runkeeper api integration using gethealth api
Runkeeper provides Cloud API which is a set of developer tools that provide an open platform for accessing data from Runkeeper application. It is know as healthgraph api. In this blog post, I will touch down what issues you can face while integrating Runkeeper healthgraph API. And how can we avoid those by using Unified gethealth.io REST API. In following steps i will touch down the steps you need while integrating healthgraph API directly and then I will show how easily you can integrated the same using gethealth API.
Step 1: Register application to API consumer key and secret which allow apps to connect to the HealthGraph API by Runkeeper.
After registering you need to hit HealthGraph API console to configure app settings: redirecting url domain restriction, setting the subscription endpoint, resources you want to subscribe.
Step 2: Read Documentation of API
HealthGraph API uses OAuth with App Authorization for user authorization. In order to access the resource you need to use APP ID and APP secret to get auth code. By using this auth code we need to prompt user for authorization for his data. The whole OAuth flow, used in Runkeeper is show below.
Step 3: Find an OAuth 2.0 library for your programming language and framework to create an authorization flow.
Depending upon the programming language you use , you can find the appropriate library which supports Oauth 2.0 authentication mechanism and flow. We can use Healthgraph-python library for python language.
Step 4 Generating request to get data from HealthGraph Cloud API
The HealthGraph Cloud API is the primary way to get data . It’s a low-level HTTP-based REST API that you can use to query data, a variety of other tasks that an app may need to do. Most API calls must be signed with an access_token.
These steps described above can take considerable developer time and also will let developer to focus on the business logic of application. Gethealth.io can help you in this regard. Get health provides all this with few REST API calls. Using gethealth.io you need to follow below steps
Step 1: Signup for gethealth.io
Step 2: Integrate our Rest API.
For user authentication we have provided the REST API call which you just need to integrate in your Application and it handles all authentication mechanism itself (e.g Oauth 2.o for Movesapp).
Step 3: Make API requests with user authorization token to fetch data across multiple user or single user.
We also provide Rest API calls which enable you to fetch data across multiple user using account call and for particular user using user call.Checkout out API documentation which let’s you get starting using the API in no time. E.g. the below api call fetches activities of a particular user:
In this blog post I described the steps which you need to deal with while accessing data using HealthGraph Cloud API and also described how simply we can use gethealth.io to get the same data while reducing all the technical effort by the developer. Using gethealth the developer can focus on how he can focus on the data fetched from source. Also using gethealth developer can add data from hundreds of other sources like misfit, MovesAPP, Strava and many more wearables and healthcare application using same implementation flow and need not to follow each sources development requirement. In coming blogs I will post interesting integration challenges about Googlefit and other application. Follow gethealth.io on twitter.