public interface ActivityService extends StravaService
| Modifier and Type | Method and Description |
|---|---|
StravaComment |
createComment(Integer activityId,
String text)
Create a comment on an activity.
|
CompletableFuture<StravaComment> |
createCommentAsync(Integer activityId,
String text)
Create a comment on an activity.
|
StravaActivity |
createManualActivity(StravaActivity activity)
This API endpoint is for creating manually entered
activities. |
CompletableFuture<StravaActivity> |
createManualActivityAsync(StravaActivity activity)
This API endpoint is for creating manually entered
activities. |
StravaActivity |
deleteActivity(Integer activityId)
Deletes the identified
StravaActivity |
CompletableFuture<StravaActivity> |
deleteActivityAsync(Integer activityId)
Deletes the identified
StravaActivity |
void |
deleteComment(Integer activityId,
Integer commentId)
Delete a comment belonging to the authenticated user
|
void |
deleteComment(StravaComment comment)
Delete a comment belonging to the authenticated user
|
CompletableFuture<Void> |
deleteCommentAsync(Integer activityId,
Integer commentId)
Delete a comment belonging to the authenticated user
|
CompletableFuture<Void> |
deleteCommentAsync(StravaComment comment)
Delete a comment belonging to the authenticated user
|
StravaActivity |
getActivity(Integer activityId)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
|
StravaActivity |
getActivity(Integer activityId,
Boolean includeAllEfforts)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
|
CompletableFuture<StravaActivity> |
getActivityAsync(Integer activityId)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
|
CompletableFuture<StravaActivity> |
getActivityAsync(Integer activityId,
Boolean includeAllEfforts)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
|
void |
giveKudos(Integer activityId)
Kudo an activity (kudo is given by the authenticated athlete).
|
CompletableFuture<Void> |
giveKudosAsync(Integer activityId)
Kudo an activity (kudo is given by the authenticated athlete).
|
List<StravaComment> |
listActivityComments(Integer activityId)
Comments on an activity can be viewed by any user.
|
List<StravaComment> |
listActivityComments(Integer activityId,
Boolean markdown)
Comments on an activity can be viewed by any user.
|
List<StravaComment> |
listActivityComments(Integer activityId,
Boolean markdown,
Paging pagingInstruction)
Comments on an activity can be viewed by any user.
|
List<StravaComment> |
listActivityComments(Integer activityId,
Paging pagingInstruction)
Comments on an activity can be viewed by any user.
|
CompletableFuture<List<StravaComment>> |
listActivityCommentsAsync(Integer activityId)
Comments on an activity can be viewed by any user.
|
CompletableFuture<List<StravaComment>> |
listActivityCommentsAsync(Integer activityId,
Boolean markdown)
Comments on an activity can be viewed by any user.
|
CompletableFuture<List<StravaComment>> |
listActivityCommentsAsync(Integer activityId,
Boolean markdown,
Paging pagingInstruction)
Comments on an activity can be viewed by any user.
|
CompletableFuture<List<StravaComment>> |
listActivityCommentsAsync(Integer activityId,
Paging pagingInstruction)
Comments on an activity can be viewed by any user.
|
List<StravaAthlete> |
listActivityKudoers(Integer activityId)
A kudos is Strava's version of a 'like' or '+1'.
|
List<StravaAthlete> |
listActivityKudoers(Integer activityId,
Paging pagingInstruction)
A kudos is Strava's version of a 'like' or '+1'.
|
CompletableFuture<List<StravaAthlete>> |
listActivityKudoersAsync(Integer activityId)
A kudos is Strava's version of a 'like' or '+1'.
|
CompletableFuture<List<StravaAthlete>> |
listActivityKudoersAsync(Integer activityId,
Paging pagingInstruction)
A kudos is Strava's version of a 'like' or '+1'.
|
List<StravaLap> |
listActivityLaps(Integer activityId)
This resource will return all laps for an activity.
|
CompletableFuture<List<StravaLap>> |
listActivityLapsAsync(Integer activityId)
This resource will return all laps for an activity.
|
List<StravaPhoto> |
listActivityPhotos(Integer activityId)
Photos are external objects associated with an activity.
|
CompletableFuture<List<StravaPhoto>> |
listActivityPhotosAsync(Integer activityId)
Photos are external objects associated with an activity.
|
List<StravaActivityZone> |
listActivityZones(Integer activityId)
Heartrate and power zones are set by the
athlete. |
CompletableFuture<List<StravaActivityZone>> |
listActivityZonesAsync(Integer activityId)
Heartrate and power zones are set by the
athlete. |
List<StravaComment> |
listAllActivityComments(Integer activityId)
List ALL comments on an activity, regardless of how many there are
|
CompletableFuture<List<StravaComment>> |
listAllActivityCommentsAsync(Integer activityId)
List ALL comments on an activity, regardless of how many there are
|
List<StravaAthlete> |
listAllActivityKudoers(Integer activityId)
List ALL kudoers on an activity, regardless of how many there are
|
CompletableFuture<List<StravaAthlete>> |
listAllActivityKudoersAsync(Integer activityId)
List ALL kudoers on an activity, regardless of how many there are
|
List<StravaActivity> |
listAllAuthenticatedAthleteActivities()
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
List<StravaActivity> |
listAllAuthenticatedAthleteActivities(LocalDateTime before,
LocalDateTime after)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
CompletableFuture<List<StravaActivity>> |
listAllAuthenticatedAthleteActivitiesAsync()
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
CompletableFuture<List<StravaActivity>> |
listAllAuthenticatedAthleteActivitiesAsync(LocalDateTime before,
LocalDateTime after)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
List<StravaActivity> |
listAllFriendsActivities()
List the recent activities performed by those the current authenticated
StravaAthlete is following. |
CompletableFuture<List<StravaActivity>> |
listAllFriendsActivitiesAsync()
List the recent activities performed by those the current authenticated
StravaAthlete is following. |
List<StravaActivity> |
listAllRelatedActivities(Integer activityId)
List ALL related activities, regardless of how many there are
|
CompletableFuture<List<StravaActivity>> |
listAllRelatedActivitiesAsync(Integer activityId)
List ALL related activities, regardless of how many there are
|
List<StravaActivity> |
listAuthenticatedAthleteActivities()
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
List<StravaActivity> |
listAuthenticatedAthleteActivities(LocalDateTime before,
LocalDateTime after)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
List<StravaActivity> |
listAuthenticatedAthleteActivities(LocalDateTime before,
LocalDateTime after,
Paging pagingInstruction)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
List<StravaActivity> |
listAuthenticatedAthleteActivities(Paging pagingInstruction)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
CompletableFuture<List<StravaActivity>> |
listAuthenticatedAthleteActivitiesAsync()
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
CompletableFuture<List<StravaActivity>> |
listAuthenticatedAthleteActivitiesAsync(LocalDateTime before,
LocalDateTime after)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
CompletableFuture<List<StravaActivity>> |
listAuthenticatedAthleteActivitiesAsync(LocalDateTime before,
LocalDateTime after,
Paging pagingInstruction)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
CompletableFuture<List<StravaActivity>> |
listAuthenticatedAthleteActivitiesAsync(Paging pagingInstruction)
This endpoint returns a list of
activities for the authenticated StravaAthlete. |
List<StravaActivity> |
listFriendsActivities()
List the recent activities performed by those the current authenticated
StravaAthlete is following. |
List<StravaActivity> |
listFriendsActivities(Paging pagingInstruction)
List the recent activities performed by those the current authenticated
StravaAthlete is following. |
CompletableFuture<List<StravaActivity>> |
listFriendsActivitiesAsync()
List the recent activities performed by those the current authenticated
StravaAthlete is following. |
CompletableFuture<List<StravaActivity>> |
listFriendsActivitiesAsync(Paging pagingInstruction)
List the recent activities performed by those the current authenticated
StravaAthlete is following. |
List<StravaActivity> |
listRelatedActivities(Integer id)
Returns the activities that were matched as "with this group".
|
List<StravaActivity> |
listRelatedActivities(Integer id,
Paging pagingInstruction)
Returns the activities that were matched as "with this group".
|
CompletableFuture<List<StravaActivity>> |
listRelatedActivitiesAsync(Integer id)
Returns the activities that were matched as "with this group".
|
CompletableFuture<List<StravaActivity>> |
listRelatedActivitiesAsync(Integer id,
Paging pagingInstruction)
Returns the activities that were matched as "with this group".
|
StravaActivity |
updateActivity(Integer activityId,
StravaActivityUpdate activity)
Requires write permissions, as requested during the authorization process.
|
CompletableFuture<StravaActivity> |
updateActivityAsync(Integer activityId,
StravaActivityUpdate activity)
Requires write permissions, as requested during the authorization process.
|
clearCacheStravaComment createComment(Integer activityId, String text) throws NotFoundException, BadRequestException
Create a comment on an activity.
Comment posting must be explicitly authorised by Strava for your application.
The comment will be made by the user associated with the access_token.
URL POST https://www.strava.com/api/v3/activities/:id/comments
activityId - Activity identifiertext - Comment textNotFoundException - if the activity does not existBadRequestException - if the comment is invalidCompletableFuture<StravaComment> createCommentAsync(Integer activityId, String text) throws NotFoundException, BadRequestException
Create a comment on an activity.
Comment posting must be explicitly authorised by Strava for your application.
The comment will be made by the user associated with the access_token.
URL POST https://www.strava.com/api/v3/activities/:id/comments
activityId - Activity identifiertext - Comment textCompletableFuture which returns) The comment as created on StravaNotFoundException - if the activity does not existBadRequestException - if the comment is invalidStravaActivity createManualActivity(StravaActivity activity)
This API endpoint is for creating manually entered activities. To upload a FIT, TCX or GPX file see the Upload Documentation.
Requires write permissions, as requested during the authorization process.
Only updates name, activity type, startDateLocal, elapsedTime, description and distance.
If any other activity attributes are passed to the API, they are ignored when creating the activity.
If successful, returns a 201 status code along with a detailed representation of the created activity.
URL POST https://www.strava.com/api/v3/activities
activity - The activity to be uploadedCompletableFuture<StravaActivity> createManualActivityAsync(StravaActivity activity)
This API endpoint is for creating manually entered activities. To upload a FIT, TCX or GPX file see the Upload Documentation.
Requires write permissions, as requested during the authorization process.
Only updates name, activity type, startDateLocal, elapsedTime, description and distance.
If any other activity attributes are passed to the API, they are ignored when creating the activity.
If successful, returns a 201 status code along with a detailed representation of the created activity.
URL POST https://www.strava.com/api/v3/activities
activity - The activity to be uploadedCompletableFuture which returns) The activity as it was uploaded on StravaStravaActivity deleteActivity(Integer activityId) throws NotFoundException
Deletes the identified StravaActivity
Requires write permissions, as requested during the authorization process.
Returns null if the activity does not exist on Strava
URL DELETE https://www.strava.com/api/v3/activities/:id
activityId - The id of the StravaActivity to be deleted.nullNotFoundException - If the activity does not existCompletableFuture<StravaActivity> deleteActivityAsync(Integer activityId) throws NotFoundException
Deletes the identified StravaActivity
Requires write permissions, as requested during the authorization process.
Returns null if the activity does not exist on Strava
URL DELETE https://www.strava.com/api/v3/activities/:id
activityId - The id of the StravaActivity to be deleted.CompletableFuture which returns) Should return nullNotFoundException - If the activity does not existvoid deleteComment(Integer activityId, Integer commentId) throws NotFoundException
Delete a comment belonging to the authenticated user
commentId - Identifier of the comment to be deletedactivityId - Identifier of the activity the comment was posted toNotFoundException - if the activity or the comment does existvoid deleteComment(StravaComment comment) throws NotFoundException
Delete a comment belonging to the authenticated user
comment - The comment to be deletedNotFoundException - If the comment does not exist on StravaCompletableFuture<Void> deleteCommentAsync(Integer activityId, Integer commentId) throws NotFoundException
Delete a comment belonging to the authenticated user
commentId - Identifier of the comment to be deletedactivityId - Identifier of the activity the comment was posted toCompletableFuture which indicates when the deletion is completeNotFoundException - if the activity or the comment does existCompletableFuture<Void> deleteCommentAsync(StravaComment comment) throws NotFoundException
Delete a comment belonging to the authenticated user
comment - The comment to be deletedCompletableFuture which indicates when the deletion is completeNotFoundException - If the comment does not exist on StravaStravaActivity getActivity(Integer activityId)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
By default, only "important" efforts are included. "Importance" is based on a number of undocumented factors and its value may change over time. Factors considered include: segment age, views and stars, if the user has hidden/shown the segment and if the effort was a PR. Note, if two activities cover the same segment, it is possible that for one activity the associated effort is "important" but not for the other.
Note that effort ids may exceed the max value for 32-bit integers. A long integer type should be used.
Each segment effort will have a hidden attribute indicating if it is "important" or not.
Returns null if the activity does not exist
URL GET https://www.strava.com/api/v3/activities/:id
activityId - The id of the activity to be returnedactivity is owned by the requesting athlete. Returns a summary representation for
all other requests.StravaActivity getActivity(Integer activityId, Boolean includeAllEfforts)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
By default, only "important" efforts are included. "Importance" is based on a number of factors and its value may change over time. Factors considered include: segment age, views and stars, if the user has hidden/shown the segment and if the effort was a PR. Note, if two activities cover the same segment, it is possible that for one activity the associated effort is "important" but not for the other.
Note that effort ids may exceed the max value for 32-bit integers. A long integer type should be used.
Each segment effort will have a hidden attribute indicating if it is "important" or not.
Returns null if the activity does not exist
URL GET https://www.strava.com/api/v3/activities/:id
activityId - The id of the activity to be returnedincludeAllEfforts - (Optional) Used to include all segment efforts in the result (if omitted or false then only "important" efforts are returned).activity is owned by the requesting athlete. Returns a summary representation for
all other requests.CompletableFuture<StravaActivity> getActivityAsync(Integer activityId)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
By default, only "important" efforts are included. "Importance" is based on a number of undocumented factors and its value may change over time. Factors considered include: segment age, views and stars, if the user has hidden/shown the segment and if the effort was a PR. Note, if two activities cover the same segment, it is possible that for one activity the associated effort is "important" but not for the other.
Note that effort ids may exceed the max value for 32-bit integers. A long integer type should be used.
Each segment effort will have a hidden attribute indicating if it is "important" or not.
Returns null if the activity does not exist
URL GET https://www.strava.com/api/v3/activities/:id
activityId - The id of the activity to be returnedCompletableFuture which returns) Returns a detailed representation if the activity is owned by the requesting athlete. Returns a summary representation for
all other requests.CompletableFuture<StravaActivity> getActivityAsync(Integer activityId, Boolean includeAllEfforts)
StravaActivity details, including segment efforts, splits and best efforts, are only available to the owner of the activity.
By default, only "important" efforts are included. "Importance" is based on a number of factors and its value may change over time. Factors considered include: segment age, views and stars, if the user has hidden/shown the segment and if the effort was a PR. Note, if two activities cover the same segment, it is possible that for one activity the associated effort is "important" but not for the other.
Note that effort ids may exceed the max value for 32-bit integers. A long integer type should be used.
Each segment effort will have a hidden attribute indicating if it is "important" or not.
Returns null if the activity does not exist
URL GET https://www.strava.com/api/v3/activities/:id
activityId - The id of the activity to be returnedincludeAllEfforts - (Optional) Used to include all segment efforts in the result (if omitted or false then only "important" efforts are returned).CompletableFuture which returns) Returns a detailed representation if the activity is owned by the requesting athlete. Returns a summary representation for
all other requests.void giveKudos(Integer activityId) throws NotFoundException
Kudo an activity (kudo is given by the authenticated athlete). You can do this multiple times, but the activity only receives one kudos.
activityId - Identifier of the activity to be kudoed.NotFoundException - If the activity does not exist on StravaCompletableFuture<Void> giveKudosAsync(Integer activityId) throws NotFoundException
Kudo an activity (kudo is given by the authenticated athlete). You can do this multiple times, but the activity only receives one kudos.
activityId - Identifier of the activity to be kudoed.CompletableFuture which indicates when the kudos has been givenNotFoundException - If the activity does not exist on StravaList<StravaComment> listActivityComments(Integer activityId)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
Comment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is not supported. Only the first page is returned by Strava.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedList<StravaComment> listActivityComments(Integer activityId, Boolean markdown)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
StravaComment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is not supported. Only the first page is returned by Strava.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
Pagination is not supported. Returns only the first page of activities.
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedmarkdown - (Optional) Include markdown in comments (default is false - i.e. filter outList<StravaComment> listActivityComments(Integer activityId, Boolean markdown, Paging pagingInstruction)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
StravaComment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is supported.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedmarkdown - (Optional) Include markdown in comments (default is false - i.e. filter outpagingInstruction - (Optional) The page to be returnedList<StravaComment> listActivityComments(Integer activityId, Paging pagingInstruction)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
Comment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is supported.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedpagingInstruction - (Optional) Paging instructions. If not provided then the first page is returned.CompletableFuture<List<StravaComment>> listActivityCommentsAsync(Integer activityId)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
Comment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is not supported. Only the first page is returned by Strava.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedCompletableFuture which returns) List of commentsCompletableFuture<List<StravaComment>> listActivityCommentsAsync(Integer activityId, Boolean markdown)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
StravaComment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is not supported. Only the first page is returned by Strava.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
Pagination is not supported. Returns only the first page of activities.
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedmarkdown - (Optional) Include markdown in comments (default is false - i.e. filter outCompletableFuture which returns) List of commentsCompletableFuture<List<StravaComment>> listActivityCommentsAsync(Integer activityId, Boolean markdown, Paging pagingInstruction)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
StravaComment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is supported.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedmarkdown - (Optional) Include markdown in comments (default is false - i.e. filter outpagingInstruction - (Optional) The page to be returnedCompletableFuture which returns) List of commentsCompletableFuture<List<StravaComment>> listActivityCommentsAsync(Integer activityId, Paging pagingInstruction)
Comments on an activity can be viewed by any user. However, only internal applications are allowed to create or delete them.
Comment posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of comments is included in the activity summary and detail responses. Use this endpoint to retrieve a list of comments left on a given activity.
Pagination is supported.
Returns null if the StravaActivity does not exist
Returns an empty array if the StravaActivity does not contain any comments
URL GET https://www.strava.com/api/v3/activities/:id/comments
activityId - The id of the StravaActivity for which comments should be returnedpagingInstruction - (Optional) Paging instructions. If not provided then the first page is returned.CompletableFuture which returns) List of commentsList<StravaAthlete> listActivityKudoers(Integer activityId)
A kudos is Strava's version of a 'like' or '+1'. The number of kudos on an activity is returned with the activity summary.
Kudos posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of kudos is included in the activity summary and detailed representations. This endpoint is for retrieving more detailed information on the athletes who have left kudos and can only be accessed by the owner of the activity.
Returns null if the StravaActivity does not exist
Pagination is not supported. Only the first page is returned by Strava.
activityId - The id of the StravaActivity for which kudoers are to be listedathlete summary objects.List<StravaAthlete> listActivityKudoers(Integer activityId, Paging pagingInstruction)
A kudos is Strava's version of a 'like' or '+1'. The number of kudos on an activity is returned with the activity summary.
Kudos posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of kudos is included in the activity summary and detailed representations. This endpoint is for retrieving more detailed information on the athletes who have left kudos and can only be accessed by the owner of the activity.
Returns null if the StravaActivity does not exist
Pagination is supported.
activityId - The id of the StravaActivity for which kudoers are to be listedpagingInstruction - (Optional) The page to be returnedathlete summary objects.CompletableFuture<List<StravaAthlete>> listActivityKudoersAsync(Integer activityId)
A kudos is Strava's version of a 'like' or '+1'. The number of kudos on an activity is returned with the activity summary.
Kudos posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of kudos is included in the activity summary and detailed representations. This endpoint is for retrieving more detailed information on the athletes who have left kudos and can only be accessed by the owner of the activity.
Returns null if the StravaActivity does not exist
Pagination is not supported. Only the first page is returned by Strava.
activityId - The id of the StravaActivity for which kudoers are to be listedCompletableFuture which returns) Returns an array of athlete summary objects.CompletableFuture<List<StravaAthlete>> listActivityKudoersAsync(Integer activityId, Paging pagingInstruction)
A kudos is Strava's version of a 'like' or '+1'. The number of kudos on an activity is returned with the activity summary.
Kudos posting can be enabled on a per application basis, email developers -at- strava.com for more information.
The number of kudos is included in the activity summary and detailed representations. This endpoint is for retrieving more detailed information on the athletes who have left kudos and can only be accessed by the owner of the activity.
Returns null if the StravaActivity does not exist
Pagination is supported.
activityId - The id of the StravaActivity for which kudoers are to be listedpagingInstruction - (Optional) The page to be returnedCompletableFuture which returns) Returns an array of athlete summary objects.List<StravaLap> listActivityLaps(Integer activityId)
This resource will return all laps for an activity. Laps are triggered by athletes using their respective devices, such as Garmin watches.
Returns null if the activity does not exist
Pagination is not supported. Returns all the laps for the activity.
URL GET https://www.strava.com/api/v3/activities/:id/laps
activityId - The id of the StravaActivity for which laps should be returnedlap effort summariesCompletableFuture<List<StravaLap>> listActivityLapsAsync(Integer activityId)
This resource will return all laps for an activity. Laps are triggered by athletes using their respective devices, such as Garmin watches.
Returns null if the activity does not exist
Pagination is not supported. Returns all the laps for the activity.
URL GET https://www.strava.com/api/v3/activities/:id/laps
activityId - The id of the StravaActivity for which laps should be returnedCompletableFuture which returns) Returns an array of lap effort summariesList<StravaPhoto> listActivityPhotos(Integer activityId)
Photos are external objects associated with an activity. Currently, the only external photo source is Instagram.
Note that Instagram does not provide taken_at information.
The number of photos is included in the activity summary and detail responses. Use this endpoint to retrieve a list of photos associated with this activity. This endpoint can only be accessed by the owner of the activity.
Returns null if the StravaActivity does not exist
Pagination is not supported. Returns all photos associated with the activity.
URL GET https://www.strava.com/api/v3/activities/:id/photos
activityId - The id of the StravaActivity for which photos are to be listedphoto objects.CompletableFuture<List<StravaPhoto>> listActivityPhotosAsync(Integer activityId)
Photos are external objects associated with an activity. Currently, the only external photo source is Instagram.
Note that Instagram does not provide taken_at information.
The number of photos is included in the activity summary and detail responses. Use this endpoint to retrieve a list of photos associated with this activity. This endpoint can only be accessed by the owner of the activity.
Returns null if the StravaActivity does not exist
Pagination is not supported. Returns all photos associated with the activity.
URL GET https://www.strava.com/api/v3/activities/:id/photos
activityId - The id of the StravaActivity for which photos are to be listedCompletableFuture which returns) Returns an array of photo objects.List<StravaActivityZone> listActivityZones(Integer activityId)
Heartrate and power zones are set by the athlete. This endpoint returns the time (seconds) in each zone for the
activity.
The distribution is not customizable.
Requires an access token associated with the owner of the activity and the owner must be a premium user.
Returns null if the activity does not exist
Pagination is not supported. Returns all activity zones for the activity.
URL GET https://www.strava.com/api/v3/activities/:id/zones
activityId - The id of the activity for which zones should be returnedactivity zones for the StravaActivity identifiedCompletableFuture<List<StravaActivityZone>> listActivityZonesAsync(Integer activityId)
Heartrate and power zones are set by the athlete. This endpoint returns the time (seconds) in each zone for the
activity.
The distribution is not customizable.
Requires an access token associated with the owner of the activity and the owner must be a premium user.
Returns null if the activity does not exist
Pagination is not supported. Returns all activity zones for the activity.
URL GET https://www.strava.com/api/v3/activities/:id/zones
activityId - The id of the activity for which zones should be returnedCompletableFuture which returns) Returns an array of activity zones for the StravaActivity identifiedList<StravaComment> listAllActivityComments(Integer activityId)
List ALL comments on an activity, regardless of how many there are
Returns null if the activity does not exist
Pagination is not supported - this method just returns ALL comments
USE WITH CAUTION - ACTIVITIES WITH MANY COMMENTS WILL REQUIRE MANY CALLS TO THE STRAVA API
activityId - The activity whose comments should be listedCompletableFuture<List<StravaComment>> listAllActivityCommentsAsync(Integer activityId)
List ALL comments on an activity, regardless of how many there are
Returns null if the activity does not exist
Pagination is not supported - this method just returns ALL comments
USE WITH CAUTION - ACTIVITIES WITH MANY COMMENTS WILL REQUIRE MANY CALLS TO THE STRAVA API
activityId - The activity whose comments should be listedCompletableFuture which returns) All comments on the activityList<StravaAthlete> listAllActivityKudoers(Integer activityId)
List ALL kudoers on an activity, regardless of how many there are
Returns null if the activity does not exist
Pagination is not supported - this method just returns ALL kudoers
USE WITH CAUTION - ACTIVITIES WITH MANY KUDOS WILL REQUIRE MANY CALLS TO THE STRAVA API
activityId - The activity whose kudoers should be listedCompletableFuture<List<StravaAthlete>> listAllActivityKudoersAsync(Integer activityId)
List ALL kudoers on an activity, regardless of how many there are
Returns null if the activity does not exist
Pagination is not supported - this method just returns ALL kudoers
USE WITH CAUTION - ACTIVITIES WITH MANY KUDOS WILL REQUIRE MANY CALLS TO THE STRAVA API
activityId - The activity whose kudoers should be listedCompletableFuture which returns) All athletes who have kudoed the activityList<StravaActivity> listAllAuthenticatedAthleteActivities()
This endpoint returns a list of activities for the authenticated StravaAthlete.
Pagination is NOT supported. USE WITH CAUTION. ALL activities for the athlete will be returned, regardless of how many calls to the Strava API are required to achieve this.
URL GET https://www.strava.com/api/v3/athlete/activities
StravaActivity summary representations sorted newest first by default.List<StravaActivity> listAllAuthenticatedAthleteActivities(LocalDateTime before, LocalDateTime after)
This endpoint returns a list of activities for the authenticated StravaAthlete.
Pagination is NOT supported. USE WITH CAUTION. ALL activities for the athlete will be returned, regardless of how many calls to the Strava API are required to achieve this.
URL GET https://www.strava.com/api/v3/athlete/activities
before - Return only rides started BEFORE this date/timeafter - Return only rides started AFTER this data/timeStravaActivity summary representations sorted newest first by default.CompletableFuture<List<StravaActivity>> listAllAuthenticatedAthleteActivitiesAsync()
This endpoint returns a list of activities for the authenticated StravaAthlete.
Pagination is NOT supported. USE WITH CAUTION. ALL activities for the athlete will be returned, regardless of how many calls to the Strava API are required to achieve this.
URL GET https://www.strava.com/api/v3/athlete/activities
CompletableFuture which returns) Returns an array of StravaActivity summary representations sorted newest first by default.CompletableFuture<List<StravaActivity>> listAllAuthenticatedAthleteActivitiesAsync(LocalDateTime before, LocalDateTime after)
This endpoint returns a list of activities for the authenticated StravaAthlete.
Pagination is NOT supported. USE WITH CAUTION. ALL activities for the athlete will be returned, regardless of how many calls to the Strava API are required to achieve this.
URL GET https://www.strava.com/api/v3/athlete/activities
before - Return only rides started BEFORE this date/timeafter - Return only rides started AFTER this data/timeCompletableFuture which returns) Returns an array of StravaActivity summary representations sorted newest first by default.List<StravaActivity> listAllFriendsActivities()
List the recent activities performed by those the current authenticated StravaAthlete is following.
Pagination is not supported - this method just returns ALL friends' activities (although it is restricted by Strava to the last 200)
USE WITH CAUTION - ACTIVITIES WITH MANY RELATED ACTIVITIES WILL REQUIRE MANY CALLS TO THE STRAVA API
URL GET https://www.strava.com/api/v3/activities/following
CompletableFuture<List<StravaActivity>> listAllFriendsActivitiesAsync()
List the recent activities performed by those the current authenticated StravaAthlete is following.
Pagination is not supported - this method just returns ALL friends' activities (although it is restricted by Strava to the last 200)
USE WITH CAUTION - ACTIVITIES WITH MANY RELATED ACTIVITIES WILL REQUIRE MANY CALLS TO THE STRAVA API
URL GET https://www.strava.com/api/v3/activities/following
CompletableFuture which returns) Returns an array of activity summary representations sorted newest first by start_date.List<StravaActivity> listAllRelatedActivities(Integer activityId)
List ALL related activities, regardless of how many there are
Returns null if the activity does not exist
Pagination is not supported - this method just returns ALL related activities
USE WITH CAUTION - ACTIVITIES WITH MANY RELATED ACTIVITIES WILL REQUIRE MANY CALLS TO THE STRAVA API
activityId - The activity identifierCompletableFuture<List<StravaActivity>> listAllRelatedActivitiesAsync(Integer activityId)
List ALL related activities, regardless of how many there are
Returns null if the activity does not exist
Pagination is not supported - this method just returns ALL related activities
USE WITH CAUTION - ACTIVITIES WITH MANY RELATED ACTIVITIES WILL REQUIRE MANY CALLS TO THE STRAVA API
activityId - The activity identifierCompletableFuture which returns) List of Strava activities that Strava has determined are related to this oneList<StravaActivity> listAuthenticatedAthleteActivities()
This endpoint returns a list of activities for the authenticated StravaAthlete.
URL GET https://www.strava.com/api/v3/athlete/activities
Pagination is not supported. Returns only the first page of activities.
StravaActivity summary representations sorted newest first by default.List<StravaActivity> listAuthenticatedAthleteActivities(LocalDateTime before, LocalDateTime after)
This endpoint returns a list of activities for the authenticated StravaAthlete.
Pagination is not supported. Returns only the first page of activities.
URL GET https://www.strava.com/api/v3/athlete/activities
before - (Optional) result will start with activities whose start_date is before this valueafter - (Optional) result will start with activities whose start_date is after this value, sorted oldest firstStravaActivity summary representations sorted newest first by default. Will be sorted oldest first if the after
parameter is used.List<StravaActivity> listAuthenticatedAthleteActivities(LocalDateTime before, LocalDateTime after, Paging pagingInstruction)
This endpoint returns a list of activities for the authenticated StravaAthlete.
Should be used with before, after or page/per_page. Using a combination will result in an error or unexpected results.
Pagination is supported.
URL GET https://www.strava.com/api/v3/athlete/activities
before - (Optional) result will start with activities whose start_date is before this valueafter - (Optional) result will start with activities whose start_date is after this value, sorted oldest firstpagingInstruction - (Optional) The page to be returnedStravaActivity summary representations sorted newest first by default. Will be sorted oldest first if the after
parameter is used.List<StravaActivity> listAuthenticatedAthleteActivities(Paging pagingInstruction)
This endpoint returns a list of activities for the authenticated StravaAthlete.
URL GET https://www.strava.com/api/v3/athlete/activities
Pagination is supported
pagingInstruction - (Optional) The page to be returnedStravaActivity summary representations sorted newest first by default. Will be sorted oldest first if the after
parameter is used.CompletableFuture<List<StravaActivity>> listAuthenticatedAthleteActivitiesAsync()
This endpoint returns a list of activities for the authenticated StravaAthlete.
URL GET https://www.strava.com/api/v3/athlete/activities
Pagination is not supported. Returns only the first page of activities.
CompletableFuture which returns) Returns an array of StravaActivity summary representations sorted newest first by default.CompletableFuture<List<StravaActivity>> listAuthenticatedAthleteActivitiesAsync(LocalDateTime before, LocalDateTime after)
This endpoint returns a list of activities for the authenticated StravaAthlete.
Pagination is not supported. Returns only the first page of activities.
URL GET https://www.strava.com/api/v3/athlete/activities
before - (Optional) result will start with activities whose start_date is before this valueafter - (Optional) result will start with activities whose start_date is after this value, sorted oldest firstCompletableFuture which returns) Returns an array of StravaActivity summary representations sorted newest first by default. Will be sorted oldest first if the after
parameter is used.CompletableFuture<List<StravaActivity>> listAuthenticatedAthleteActivitiesAsync(LocalDateTime before, LocalDateTime after, Paging pagingInstruction)
This endpoint returns a list of activities for the authenticated StravaAthlete.
Should be used with before, after or page/per_page. Using a combination will result in an error or unexpected results.
Pagination is supported.
URL GET https://www.strava.com/api/v3/athlete/activities
before - (Optional) result will start with activities whose start_date is before this valueafter - (Optional) result will start with activities whose start_date is after this value, sorted oldest firstpagingInstruction - (Optional) The page to be returnedCompletableFuture which returns) Returns an array of StravaActivity summary representations sorted newest first by default. Will be sorted oldest first if the after
parameter is used.CompletableFuture<List<StravaActivity>> listAuthenticatedAthleteActivitiesAsync(Paging pagingInstruction)
This endpoint returns a list of activities for the authenticated StravaAthlete.
URL GET https://www.strava.com/api/v3/athlete/activities
Pagination is supported
pagingInstruction - (Optional) The page to be returnedCompletableFuture which returns) Returns an array of StravaActivity summary representations sorted newest first by default. Will be sorted oldest first if the after
parameter is used.List<StravaActivity> listFriendsActivities()
List the recent activities performed by those the current authenticated StravaAthlete is following.
Pagination is not supported. Only the first page is returned by Strava.
URL GET https://www.strava.com/api/v3/activities/following
List<StravaActivity> listFriendsActivities(Paging pagingInstruction)
List the recent activities performed by those the current authenticated StravaAthlete is following.
Pagination is supported. However, results are limited to the last 200 total activities.
URL GET https://www.strava.com/api/v3/activities/following
pagingInstruction - (Optional) The page to be returnedCompletableFuture<List<StravaActivity>> listFriendsActivitiesAsync()
List the recent activities performed by those the current authenticated StravaAthlete is following.
Pagination is not supported. Only the first page is returned by Strava.
URL GET https://www.strava.com/api/v3/activities/following
CompletableFuture which returns) Returns an array of activity summary representations sorted newest first by start_date.CompletableFuture<List<StravaActivity>> listFriendsActivitiesAsync(Paging pagingInstruction)
List the recent activities performed by those the current authenticated StravaAthlete is following.
Pagination is supported. However, results are limited to the last 200 total activities.
URL GET https://www.strava.com/api/v3/activities/following
pagingInstruction - (Optional) The page to be returnedCompletableFuture which returns) Returns an array of activity summary representations sorted newest first by start_date.List<StravaActivity> listRelatedActivities(Integer id)
Returns the activities that were matched as "with this group". The number equals activity.athlete_count-1.
Returns null if the StravaActivity does not exist
Pagination is not supported. Only the first page is returned by Strava.
id - StravaActivity id for which related activities should be listedList<StravaActivity> listRelatedActivities(Integer id, Paging pagingInstruction)
Returns the activities that were matched as "with this group". The number equals activity.athlete_count-1.
Returns null if the StravaActivity does not exist
Pagination is supported.
id - StravaActivity id for which related activities should be listedpagingInstruction - Paging instructionsCompletableFuture<List<StravaActivity>> listRelatedActivitiesAsync(Integer id)
Returns the activities that were matched as "with this group". The number equals activity.athlete_count-1.
Returns null if the StravaActivity does not exist
Pagination is not supported. Only the first page is returned by Strava.
id - StravaActivity id for which related activities should be listedCompletableFuture which returns) List of related activities (not including the main activity)CompletableFuture<List<StravaActivity>> listRelatedActivitiesAsync(Integer id, Paging pagingInstruction)
Returns the activities that were matched as "with this group". The number equals activity.athlete_count-1.
Returns null if the StravaActivity does not exist
Pagination is supported.
id - StravaActivity id for which related activities should be listedpagingInstruction - Paging instructionsCompletableFuture which returns) List of related activities (not including the main activity)StravaActivity updateActivity(Integer activityId, StravaActivityUpdate activity) throws NotFoundException
Requires write permissions, as requested during the authorization process.
Only updates name, type, private, commute, trainer, gear_id and description
Returns null if the activity doesn't exist on Strava
URL PUT https://www.strava.com/api/v3/activities/:id
activityId - The identifier of the activity to be updatedactivity - The StravaActivityUpdate to be updatedStravaActivity.NotFoundException - If the activity with the given id does not existCompletableFuture<StravaActivity> updateActivityAsync(Integer activityId, StravaActivityUpdate activity) throws NotFoundException
Requires write permissions, as requested during the authorization process.
Only updates name, type, private, commute, trainer, gear_id and description
Returns null if the activity doesn't exist on Strava
URL PUT https://www.strava.com/api/v3/activities/:id
activityId - The identifier of the activity to be updatedactivity - The StravaActivityUpdate to be updatedCompletableFuture which returns) Returns a detailed representation of the updated StravaActivity.NotFoundException - If the activity with the given id does not existCopyright © 2016 Dan Shannon. All rights reserved.