{"id":1610,"date":"2022-12-27T11:55:10","date_gmt":"2022-12-27T11:55:10","guid":{"rendered":"https:\/\/marcel-jan.eu\/datablog\/?p=1610"},"modified":"2022-12-27T12:14:35","modified_gmt":"2022-12-27T12:14:35","slug":"a-strava-dashboard-on-a-raspberry-pi-part-3-the-strava-api","status":"publish","type":"post","link":"https:\/\/marcel-jan.eu\/datablog\/2022\/12\/27\/a-strava-dashboard-on-a-raspberry-pi-part-3-the-strava-api\/","title":{"rendered":"A Strava dashboard on a Raspberry Pi (Part 3): The Strava API"},"content":{"rendered":"\n

<\/p>\n\n\n\n

This is part 3 of a series of blogpost<\/a>s on how I created a Strava dashboard on a Inky Impression e-ink display with a Raspberry Pi.<\/p>\n\n\n\n

<\/p>\n\n\n\n

OAuth2<\/h2>\n\n\n\n

This was the part that I expected to be the hard part: getting my data from Strava. Or, to be more precise: getting the connection right so the Strava API would allow me to get that data. Because it requires authentication via the OAuth2 protocol and I’ve tried a similar thing a few years back with a Google API and I just didn’t get it. But now I do. <\/p>\n\n\n\n

<\/p>\n\n\n\n

Strava API documentation<\/h2>\n\n\n\n

It requires a whole “dance” between your computer code and the Strava API where you exchange all kinds of tokens back and forth. Strava’s Getting Started with the Strava API<\/a> document explains it quite well. And this blogpost by Graziano Fuccio helped me a lot with the Python code: http:\/\/www.grace-dev.com\/python-apis\/strava-api\/<\/a>.<\/p>\n\n\n\n

Frustratingly I still didn’t get it to work though. The reason I found out, is because the URL of the authentication has changed. From https:\/\/www.strava.com\/oauth\/token<\/a> it became  https:\/\/www.strava.com\/api\/v3\/oauth\/token<\/a>. I found this elsewhere in the Stava API documentation, where the correct URL was shown. I’ve told Strava that their Getting Started documentation is outdated<\/a>. They asked me to create a ticket and I’ve done so, but I don’t think they changed their document yet. But Graziano Fuccio did though.<\/p>\n\n\n\n\n\n\n\n

My code and process<\/h2>\n\n\n\n

I’ve used Graziano Fuccio’s Python code for my Strava Inky Dashboard and changed it a little. My code can be downloaded from Github: https:\/\/github.com\/Marcel-Jan\/StravaInky<\/a><\/p>\n\n\n\n

This is how my current process is:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

<\/p>\n\n\n\n

1. Install Pillow<\/h3>\n\n\n\n

Actually this is not for authentication, but to show stuff on the Inky Impression display. But if you are going to run stravainky_dashboard.py<\/a>, you’re going to need this Python library.<\/p>\n\n\n\n

<\/p>\n\n\n\n

2. Create your Strava API application<\/h3>\n\n\n\n

Now we’re going to create a Strava API application. For this go to the Strava API Application page: https:\/\/www.strava.com\/settings\/api<\/a>. Create an application. <\/p>\n\n\n\n

Now you’ll get a form that looks something like this. Sorry that this screenshot is in Dutch. I don’t know how to make Strava show it in English. <\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

You’ll be asked to give it a name, a category (I chose visualisation, but I’m not sure it matters). I don’t think the website URL matters that much for this. Authentication of the callback domain will later appear in an URL that is generated. “localhost” will be fine here.<\/p>\n\n\n\n

After that was successful, you will get something like this (except maybe not in Dutch):<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

<\/p>\n\n\n\n

3. Download my code from Github<\/h3>\n\n\n\n

The code can be downloaded from here: https:\/\/github.com\/Marcel-Jan\/StravaInky<\/a>. <\/p>\n\n\n\n

<\/p>\n\n\n\n

4. Edit config.py<\/h3>\n\n\n\n

Because the secrets and tokens used to authenticate your Strava API application are rather sensitive, I decided to create a separate config.py file where I store client id, client secret (and later the refresh token).<\/p>\n\n\n\n

Copy the Client ID and Client Secret from the API application details (screenshot above) and paste them in config.py in client_id and client_secret.<\/p>\n\n\n\n

<\/p>\n\n\n\n

5. Run stravainky_getaccesstoken.py<\/h3>\n\n\n\n

Okay, this is the part where you need to pay close attention. If all goes well, you only need to run stravainky_getaccesstoken.py only once. <\/p>\n\n\n\n

When you run it, it will produce an URL and it will ask you for a code.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

You get the code by copying the URL (after the “Click here” part) and go to that URL in a browser, you’ll get a page where you need to authorise your app. Of course we want to do that.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

And here’s the strange thing: when you click Allow (or Toestaan in Dutch), you’ll be sent to a URL that goes nowhere. It will look like things went wrong, but in the URL is your refresh token that you need to copy.<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

Now go back to the terminal where you started stravainky_getaccesstoken.py and paste that refresh token (“Insert the refresh token from the url”).<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

This will put the access token and other details in a file called strava_tokens.json. If strava_tokens.json contains errors, check that you entered the correct client id and client secret in config.py and run this step again.<\/p>\n\n\n\n

<\/p>\n\n\n\n

6. Enter refresh token in config.py<\/h3>\n\n\n\n

Now that you have the refresh token. Also enter it in config.py:<\/p>\n\n\n\n

\"\"<\/figure>\n\n\n\n

<\/p>\n\n\n\n

7. Run stravainky_dashboard.py<\/h3>\n\n\n\n

You should now be able to get data from the Strava API with Python. stravainky_dashboard.py gets this data and displays it on Inky Impression display.<\/p>\n\n\n\n

It might have a Christmas theme, like this one. The images can be found in the images directory. <\/p>\n\n\n\n

\"\"
The Strava dashboard on the Inky Impression display with a Christmas theme.<\/figcaption><\/figure>\n\n\n\n

<\/p>\n\n\n\n

Troubleshooting<\/h2>\n\n\n\n

Nothing ever goes right the first time. What to check when things go wrong?<\/p>\n\n\n\n

Check strava_tokens.json<\/h3>\n\n\n\n

If it contains errors, check that you put in the correct client id and client secret in config.py. <\/p>\n\n\n\n

<\/p>\n\n\n\n

Check the log<\/h3>\n\n\n\n

stravainky_dashboard.py writes a log file called stravainky_dashboard.log that might contain some error messages.<\/p>\n\n\n\n

<\/p>\n\n\n\n

In the next blogpost we will look at how to draw your own dashboard on the Inky Impression with the Pillow library.<\/p>\n","protected":false},"excerpt":{"rendered":"

This is part 3 of a series of blogposts on how I created a Strava dashboard on a Inky Impression e-ink display with a Raspberry Pi. OAuth2 This was the part that I expected to be the hard part: getting my data from Strava. Or, to be more precise: getting […]<\/p>\n","protected":false},"author":1,"featured_media":1653,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[55,75],"tags":[355,356,354,76,334,357],"class_list":["post-1610","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-howto","category-python","tag-api","tag-graziano-fuccio","tag-oauth2","tag-python","tag-strava","tag-stravainky_dashboard-py"],"_links":{"self":[{"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/posts\/1610","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/comments?post=1610"}],"version-history":[{"count":11,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/posts\/1610\/revisions"}],"predecessor-version":[{"id":1660,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/posts\/1610\/revisions\/1660"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/media\/1653"}],"wp:attachment":[{"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/media?parent=1610"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/categories?post=1610"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/marcel-jan.eu\/datablog\/wp-json\/wp\/v2\/tags?post=1610"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}