javastrava.api.v3.auth.impl.retrofit

Class TokenServiceImpl

java.lang.Object

javastrava.api.v3.service.impl.StravaServiceImpl<TokenAPI>

javastrava.api.v3.auth.impl.retrofit.TokenServiceImpl

All Implemented Interfaces:

TokenService

public class TokenServiceImpl
extends StravaServiceImpl<TokenAPI>
implements TokenService

Author:

Dan Shannon

Field Summary

Fields inherited from class javastrava.api.v3.service.impl.StravaServiceImpl

requestRate, requestRateDaily, restService

Method Summary

Modifier and Type	Method and Description
TokenResponse	deauthorise(Token accessToken) Allows an application to revoke its access to an athlete's data.
static TokenService	instance(Token token) Returns an instance of token services

Methods inherited from class javastrava.api.v3.service.impl.StravaServiceImpl

accessTokenIsValid, getToken, requestRateDailyPercentage, requestRatePercentage

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

instance

public static TokenService instance(Token token)
                             throws UnauthorizedException

Returns an instance of token services

Instances are cached so that if 2 requests are made for the same token, the same instance is returned

Parameters:

token - The Strava access token to be used in requests to the Strava API

Returns:

An instance of the token services

Throws:

UnauthorizedException - If the token used to create the service is invalid

deauthorise

public TokenResponse deauthorise(Token accessToken)
                          throws UnauthorizedException

Description copied from interface: TokenService

Allows an application to revoke its access to an athlete's data.

This will invalidate all access tokens associated with the athlete, application pair used to create the token. The application will be removed from the StravaAthlete Settings page on Strava.

All requests made using invalidated tokens will receive a 401 Unauthorised response.

URL POST https://www.strava.com/oauth/deauthorize

Specified by:

deauthorise in interface TokenService

Parameters:

accessToken - The access token for which the application is revoking its access.

Returns:

Responds with the access token submitted with the request.

Throws:

UnauthorizedException - if the token is not allowed to be deauthorised

See Also:

TokenService.deauthorise(Token)