https://github.com/mchirico/strava
https://github.com/mchirico/strava
angular api python3
Last synced: 2 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/mchirico/strava
- Owner: mchirico
- License: gpl-3.0
- Created: 2020-04-20T17:11:27.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2023-07-11T15:50:06.000Z (almost 3 years ago)
- Last Synced: 2025-06-19T01:39:35.353Z (about 1 year ago)
- Topics: angular, api, python3
- Language: Python
- Homepage: https://strava.montcopa.io
- Size: 1.54 MB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 8
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://codecov.io/gh/mchirico/strava)
# Strava
Setup
```
docker run --rm -v ${PWD}:/local swaggerapi/swagger-codegen-cli generate \
-i https://developers.strava.com/swagger/swagger.json \
-l python \
-o /local/strava
pip freeze|awk '{FS="=="}{print $1}' > requirements.txt
```
# swagger-client
The [Swagger Playground](https://developers.strava.com/playground) is the easiest way to familiarize yourself with the Strava API by submitting HTTP requests and observing the responses before you write any client code. It will show what a response will look like with different endpoints depending on the authorization scope you receive from your athletes. To use the Playground, go to https://www.strava.com/settings/api and change your “Authorization Callback Domain” to developers.strava.com. Please note, we only support Swagger 2.0. There is a known issue where you can only select one scope at a time. For more information, please check the section “client code” at https://developers.strava.com/docs.
This Python package is automatically generated by the [Swagger Codegen](https://github.com/swagger-api/swagger-codegen) project:
- API version: 3.0.0
- Package version: 1.0.0
- Build package: io.swagger.codegen.languages.PythonClientCodegen
## Requirements.
Python 2.7 and 3.4+
## Installation & Usage
### pip install
If the python package is hosted on Github, you can install directly from Github
```sh
pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git
```
(you may need to run `pip` with root permission: `sudo pip install git+https://github.com/GIT_USER_ID/GIT_REPO_ID.git`)
Then import the package:
```python
import swagger_client
```
### Setuptools
Install via [Setuptools](http://pypi.python.org/pypi/setuptools).
```sh
python setup.py install --user
```
(or `sudo python setup.py install` to install the package for all users)
Then import the package:
```python
import swagger_client
```
## Getting Started
Please follow the [installation procedure](#installation--usage) and then run the following:
```python
from __future__ import print_function
import time
import swagger_client
from swagger_client.rest import ApiException
from pprint import pprint
# Configure OAuth2 access token for authorization: strava_oauth
configuration = swagger_client.Configuration()
configuration.access_token = 'YOUR_ACCESS_TOKEN'
# create an instance of the API class
api_instance = swagger_client.ActivitiesApi(swagger_client.ApiClient(configuration))
name = 'name_example' # str | The name of the activity.
type = 'type_example' # str | Type of activity. For example - Run, Ride etc.
start_date_local = '2013-10-20T19:20:30+01:00' # datetime | ISO 8601 formatted date time.
elapsed_time = 56 # int | In seconds.
description = 'description_example' # str | Description of the activity. (optional)
distance = 3.4 # float | In meters. (optional)
trainer = 56 # int | Set to 1 to mark as a trainer activity. (optional)
commute = 56 # int | Set to 1 to mark as commute. (optional)
try:
# Create an Activity
api_response = api_instance.create_activity(name, type, start_date_local, elapsed_time, description=description, distance=distance, trainer=trainer, commute=commute)
pprint(api_response)
except ApiException as e:
print("Exception when calling ActivitiesApi->create_activity: %s\n" % e)
```
## Documentation for API Endpoints
All URIs are relative to *https://www.strava.com/api/v3*
Class | Method | HTTP request | Description
------------ | ------------- | ------------- | -------------
*ActivitiesApi* | [**create_activity**](docs/ActivitiesApi.md#create_activity) | **POST** /activities | Create an Activity
*ActivitiesApi* | [**get_activity_by_id**](docs/ActivitiesApi.md#get_activity_by_id) | **GET** /activities/{id} | Get Activity
*ActivitiesApi* | [**get_comments_by_activity_id**](docs/ActivitiesApi.md#get_comments_by_activity_id) | **GET** /activities/{id}/comments | List Activity Comments
*ActivitiesApi* | [**get_kudoers_by_activity_id**](docs/ActivitiesApi.md#get_kudoers_by_activity_id) | **GET** /activities/{id}/kudos | List Activity Kudoers
*ActivitiesApi* | [**get_laps_by_activity_id**](docs/ActivitiesApi.md#get_laps_by_activity_id) | **GET** /activities/{id}/laps | List Activity Laps
*ActivitiesApi* | [**get_logged_in_athlete_activities**](docs/ActivitiesApi.md#get_logged_in_athlete_activities) | **GET** /athlete/activities | List Athlete Activities
*ActivitiesApi* | [**get_zones_by_activity_id**](docs/ActivitiesApi.md#get_zones_by_activity_id) | **GET** /activities/{id}/zones | Get Activity Zones
*ActivitiesApi* | [**update_activity_by_id**](docs/ActivitiesApi.md#update_activity_by_id) | **PUT** /activities/{id} | Update Activity
*AthletesApi* | [**get_logged_in_athlete**](docs/AthletesApi.md#get_logged_in_athlete) | **GET** /athlete | Get Authenticated Athlete
*AthletesApi* | [**get_logged_in_athlete_zones**](docs/AthletesApi.md#get_logged_in_athlete_zones) | **GET** /athlete/zones | Get Zones
*AthletesApi* | [**get_stats**](docs/AthletesApi.md#get_stats) | **GET** /athletes/{id}/stats | Get Athlete Stats
*AthletesApi* | [**update_logged_in_athlete**](docs/AthletesApi.md#update_logged_in_athlete) | **PUT** /athlete | Update Athlete
*ClubsApi* | [**get_club_activities_by_id**](docs/ClubsApi.md#get_club_activities_by_id) | **GET** /clubs/{id}/activities | List Club Activities
*ClubsApi* | [**get_club_admins_by_id**](docs/ClubsApi.md#get_club_admins_by_id) | **GET** /clubs/{id}/admins | List Club Administrators
*ClubsApi* | [**get_club_by_id**](docs/ClubsApi.md#get_club_by_id) | **GET** /clubs/{id} | Get Club
*ClubsApi* | [**get_club_members_by_id**](docs/ClubsApi.md#get_club_members_by_id) | **GET** /clubs/{id}/members | List Club Members
*ClubsApi* | [**get_logged_in_athlete_clubs**](docs/ClubsApi.md#get_logged_in_athlete_clubs) | **GET** /athlete/clubs | List Athlete Clubs
*GearsApi* | [**get_gear_by_id**](docs/GearsApi.md#get_gear_by_id) | **GET** /gear/{id} | Get Equipment
*RoutesApi* | [**get_route_as_gpx**](docs/RoutesApi.md#get_route_as_gpx) | **GET** /routes/{id}/export_gpx | Export Route GPX
*RoutesApi* | [**get_route_as_tcx**](docs/RoutesApi.md#get_route_as_tcx) | **GET** /routes/{id}/export_tcx | Export Route TCX
*RoutesApi* | [**get_route_by_id**](docs/RoutesApi.md#get_route_by_id) | **GET** /routes/{id} | Get Route
*RoutesApi* | [**get_routes_by_athlete_id**](docs/RoutesApi.md#get_routes_by_athlete_id) | **GET** /athletes/{id}/routes | List Athlete Routes
*RunningRacesApi* | [**get_running_race_by_id**](docs/RunningRacesApi.md#get_running_race_by_id) | **GET** /running_races/{id} | Get Running Race
*RunningRacesApi* | [**get_running_races**](docs/RunningRacesApi.md#get_running_races) | **GET** /running_races | List Running Races
*SegmentEffortsApi* | [**get_efforts_by_segment_id**](docs/SegmentEffortsApi.md#get_efforts_by_segment_id) | **GET** /segments/{id}/all_efforts | List Segment Efforts
*SegmentEffortsApi* | [**get_segment_effort_by_id**](docs/SegmentEffortsApi.md#get_segment_effort_by_id) | **GET** /segment_efforts/{id} | Get Segment Effort
*SegmentsApi* | [**explore_segments**](docs/SegmentsApi.md#explore_segments) | **GET** /segments/explore | Explore segments
*SegmentsApi* | [**get_leaderboard_by_segment_id**](docs/SegmentsApi.md#get_leaderboard_by_segment_id) | **GET** /segments/{id}/leaderboard | Get Segment Leaderboard
*SegmentsApi* | [**get_logged_in_athlete_starred_segments**](docs/SegmentsApi.md#get_logged_in_athlete_starred_segments) | **GET** /segments/starred | List Starred Segments
*SegmentsApi* | [**get_segment_by_id**](docs/SegmentsApi.md#get_segment_by_id) | **GET** /segments/{id} | Get Segment
*SegmentsApi* | [**star_segment**](docs/SegmentsApi.md#star_segment) | **PUT** /segments/{id}/starred | Star Segment
*StreamsApi* | [**get_activity_streams**](docs/StreamsApi.md#get_activity_streams) | **GET** /activities/{id}/streams | Get Activity Streams
*StreamsApi* | [**get_route_streams**](docs/StreamsApi.md#get_route_streams) | **GET** /routes/{id}/streams | Get Route Streams
*StreamsApi* | [**get_segment_effort_streams**](docs/StreamsApi.md#get_segment_effort_streams) | **GET** /segment_efforts/{id}/streams | Get Segment Effort Streams
*StreamsApi* | [**get_segment_streams**](docs/StreamsApi.md#get_segment_streams) | **GET** /segments/{id}/streams | Get Segment Streams
*UploadsApi* | [**create_upload**](docs/UploadsApi.md#create_upload) | **POST** /uploads | Upload Activity
*UploadsApi* | [**get_upload_by_id**](docs/UploadsApi.md#get_upload_by_id) | **GET** /uploads/{uploadId} | Get Upload
## Documentation For Models
- [ActivityStats](docs/ActivityStats.md)
- [ActivityTotal](docs/ActivityTotal.md)
- [ActivityType](docs/ActivityType.md)
- [ActivityZone](docs/ActivityZone.md)
- [BaseStream](docs/BaseStream.md)
- [Comment](docs/Comment.md)
- [Error](docs/Error.md)
- [ExplorerResponse](docs/ExplorerResponse.md)
- [ExplorerSegment](docs/ExplorerSegment.md)
- [Fault](docs/Fault.md)
- [HeartRateZoneRanges](docs/HeartRateZoneRanges.md)
- [Lap](docs/Lap.md)
- [LatLng](docs/LatLng.md)
- [MetaActivity](docs/MetaActivity.md)
- [MetaAthlete](docs/MetaAthlete.md)
- [MetaClub](docs/MetaClub.md)
- [PhotosSummary](docs/PhotosSummary.md)
- [PhotosSummaryPrimary](docs/PhotosSummaryPrimary.md)
- [PolylineMap](docs/PolylineMap.md)
- [PowerZoneRanges](docs/PowerZoneRanges.md)
- [Route](docs/Route.md)
- [RunningRace](docs/RunningRace.md)
- [SegmentLeaderboard](docs/SegmentLeaderboard.md)
- [SegmentLeaderboardEntry](docs/SegmentLeaderboardEntry.md)
- [Split](docs/Split.md)
- [StreamSet](docs/StreamSet.md)
- [SummaryGear](docs/SummaryGear.md)
- [SummarySegment](docs/SummarySegment.md)
- [SummarySegmentEffort](docs/SummarySegmentEffort.md)
- [TimedZoneDistribution](docs/TimedZoneDistribution.md)
- [UpdatableActivity](docs/UpdatableActivity.md)
- [Upload](docs/Upload.md)
- [ZoneRange](docs/ZoneRange.md)
- [ZoneRanges](docs/ZoneRanges.md)
- [Zones](docs/Zones.md)
- [AltitudeStream](docs/AltitudeStream.md)
- [CadenceStream](docs/CadenceStream.md)
- [DetailedGear](docs/DetailedGear.md)
- [DetailedSegment](docs/DetailedSegment.md)
- [DetailedSegmentEffort](docs/DetailedSegmentEffort.md)
- [DistanceStream](docs/DistanceStream.md)
- [HeartrateStream](docs/HeartrateStream.md)
- [LatLngStream](docs/LatLngStream.md)
- [MovingStream](docs/MovingStream.md)
- [PowerStream](docs/PowerStream.md)
- [SmoothGradeStream](docs/SmoothGradeStream.md)
- [SmoothVelocityStream](docs/SmoothVelocityStream.md)
- [SummaryActivity](docs/SummaryActivity.md)
- [SummaryAthlete](docs/SummaryAthlete.md)
- [SummaryClub](docs/SummaryClub.md)
- [TemperatureStream](docs/TemperatureStream.md)
- [TimeStream](docs/TimeStream.md)
- [TimedZoneRange](docs/TimedZoneRange.md)
- [DetailedActivity](docs/DetailedActivity.md)
- [DetailedAthlete](docs/DetailedAthlete.md)
- [DetailedClub](docs/DetailedClub.md)
## Documentation For Authorization
## strava_oauth
- **Type**: OAuth
- **Flow**: accessCode
- **Authorization URL**: https://www.strava.com/api/v3/oauth/authorize
- **Scopes**:
- **read**: Read public segments, public routes, public profile data, public posts, public events, club feeds, and leaderboards
- **read_all**: Read private routes, private segments, and private events for the user
- **profile:read_all**: Read all profile information even if the user has set their profile visibility to Followers or Only You
- **profile:write**: Update the user's weight and Functional Threshold Power (FTP), and access to star or unstar segments on their behalf
- **activity:read**: Read the user's activity data for activities that are visible to Everyone and Followers, excluding privacy zone data
- **activity:read_all**: The same access as activity:read, plus privacy zone data and access to read the user's activities with visibility set to Only You
- **activity:write**: Access to create manual activities and uploads, and access to edit any activities that are visible to the app, based on activity read access level
## Author