com.strava.v3.api 5.0.1

com.strava.v3.api

Important Notes (Read me first!)

This project was forked from the RobertEves92 repo, which in turn was forked from the original by sascha-simon, neither of which have been updated in a long time. It is therefore very possible that various aspects of the project don't work as originally intended, or don't work full stop, due to changes made by Strava in their API.

Latest version updated for Strava was updated in January 07, 2023

Feedback

If you have any feedback, bug reports or suggestions, feel free to add an issue to the repo and I'll look in to it

Getting an access token from Strava

You can get an access token from Strava by using one of the following methods:

• StaticAuthentication You can use this method if you already have an access token. You can either use the WebAuthentication class to get a access token from Strava or you can use your token, that you got when you registered your application.

StaticAuthentication auth = new StaticAuthentication("<insert token here>");

• WebAuthentication This procedure should be used, if you want to authorize your application for the first time. When an object is created and the GetTokenAsync() method is invoked, a browser window will open and you have to authorize the apllication. Once the button is clicked, Strava invokes a callback function. When you create a WebAuthentication object, a web server is started locally on your computer. Once the button is clicked, Strava invokes a callback function which is received by the callback server. You now have a working access token created specifically for your application. You can store this access token in a file on your hard disk, so you don't have to open a browser window every time. You should use some sort of cryptographic algorithm, to obfuscate the access token.

Upon the next start of the program, you can then load the token from your hard disk and use the StaticAuthentication method described above.

The date and time that the token expires will also be saved, so it is possible to check this and only obtain a new token when this is actually required.

Hints

When using the WebAuthentication method in your application, you have to start the application as an admin (at least when you acquire the access token). Strava sends back the access token via a callback. To receive this callback, a WebServer must be started locally. To start such a server, you need admin rights.

After you have received your token, you can save it to a file so you won't have to get a new token every time.

Using Strava.NET

General

Getting data from Strava is pretty straightforward. All you have to do, is to create a StravaClient object and pass a valid IAuthenticator object.

StaticAuthentication auth = new StaticAuthentication("<insert token here>");
StravaClient client = new StravaClient(auth);

Now you can use the client object to make some calls to Strava.

As of now, i only have implemented the async methods, regular methods will follow. Most of the methods are overwritten. When you don't need to pass a parameter to the method, the data will be of the currently authenticated athlete.

//Receive the currently authorized athlete
Athlete athlete = await client.Athletes.GetAthleteAsync();

When you pass a parameter to the method, you can get data from another athlete.

//Receive an other athlete
Athlete athlete = await client.Athletes.GetAthleteAsync("<id here>");

Limits

The usage of the Strava API is limited. There are two different limits, a short- and a long-term limit. The long term limit is 30.000 request per day, the short term limit is 600 request per 15 minutes. Whenever a request is made and an response is received, the limits are processed and saved in the static properties of the Limit class.

This class provides the following members:

The Limit class also provides events you can subscribe to.

Athletes

The StravaClient offers the following methods:

Examples

StaticAuthentication auth = new StaticAuthentication("<token here>");
StravaClient client = new StravaClient(auth);

//Receive the currently authenticated athlete
Athlete athlete = await client.Athletes.GetAthleteAsync();

StaticAuthentication auth = new StaticAuthentication("<token here>");
StravaClient client = new StravaClient(auth);

//Receive an other athlete
Athlete athlete = await client.Athletes.GetAthleteAsync("<id here>");

StaticAuthentication auth = new StaticAuthentication("<token here>");
StravaClient client = new StravaClient(auth);

//Get my followers
List<Athlete> athlete = await client.Athletes.GetFollowersAsync();

Activities

There are three types of activity objects:

• Activity
• ActivitySummary
• ActivityMeta

The Activity object contains all the information about an activity. An Activity object is only returned if you are the owner of the activity otherwise an ActivitySummary is returned.

An ActivityMeta object only contains the activity id and is returned if you load other data like a segment effort. The SegmentEffort object only contains an ActivityMeta member with the activity id. But you can use this id to get a more detailed version of the activity.

The AcitivtySummary and ActivityMeta classes were added to avoid some nasty NullPointerExceptions.

Clubs

Gear

Segments

Segment Efforts

Leaderboards

You can filter the leaderboard by various parameters like gender or weight. Please keep in mind that you need a Strava premium account to use filtering.

Uploading an activity

You can use the UploadClient to upload an activity from a *.fit, *.tcx or a *.gpx file. I recommend that you create a StravaClient and use the predefined subclients.

After you've defined the file you want to upload, you can use the UploadStatusCheck class to check the status of your upload. There are events that are raised when a certain status of the upload is reached.

StaticAuthentication auth = new StaticAuthentication("<your token>");
Client.StravaClient client = new Client.StravaClient(auth);

UploadStatus status = await client.Uploads.UploadActivityAsync(@"F:\2014-03-22-14-43-55.fit", DataFormat.Fit);

UploadStatus s = await client.Uploads.CheckUploadStatusAsync(status.Id.ToString());
Console.WriteLine(s.Status);

UploadStatusCheck check = new UploadStatusCheck(_token, status.Id.ToString());
            
check.UploadChecked += delegate(object o, UploadStatusCheckedEventArgs args)
{
    Console.WriteLine(args.Status);
};

check.Start();