javastrava.api.v3.auth.impl.retrofit

Class AuthorisationServiceImpl

java.lang.Object

javastrava.api.v3.auth.impl.retrofit.AuthorisationServiceImpl

All Implemented Interfaces:

AuthorisationService

public class AuthorisationServiceImpl
extends Object
implements AuthorisationService

Author:

Dan Shannon

Constructor Summary

Constructors

Constructor and Description
AuthorisationServiceImpl() Default constructor creates a RestAdapter which is the actual implementation of the REST interface

Method Summary

Modifier and Type	Method and Description
Token	tokenExchange(Integer clientId, String clientSecret, String code, AuthorisationScope... scopes) Strava will respond to the authorization request by redirecting the user/browser to the redirect_uri provided.

Methods inherited from class java.lang.Object

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

Constructor Detail

AuthorisationServiceImpl

public AuthorisationServiceImpl()

Default constructor creates a RestAdapter which is the actual implementation of the REST interface

Method Detail

tokenExchange

public Token tokenExchange(Integer clientId,
                           String clientSecret,
                           String code,
                           AuthorisationScope... scopes)
                    throws BadRequestException,
                           UnauthorizedException

Description copied from interface: AuthorisationService

Strava will respond to the authorization request by redirecting the user/browser to the redirect_uri provided.

On success, a code will be included in the query string.

If access is denied, error=access_denied will be included in the query string.

In both cases, if provided, the state argument will also be included.

If the user accepts the request to share access to their Strava data, Strava will redirect back to redirect_uri with the authorization code. The application must now exchange the temporary authorization code for an access token, using its client ID and client secret.

The application will now be able to make requests on the user's behalf using the access_token query string parameter (GET) or POST/PUT body, or the Authorization header.

Applications should check for a 401 Unauthorised response. Access for those tokens has been revoked by the user.

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

Specified by:

tokenExchange in interface AuthorisationService

Parameters:

clientId - application's ID, obtained during registration

clientSecret - application's secret, obtained during registration

code - authorisation code

scopes - the requested authorisation scopes

Returns:

Returns an access token containing a detailed representation of the current athlete.

Throws:

BadRequestException - Where the request does not contain all the required information

UnauthorizedException - If client secret is invalid

See Also:

AuthorisationService.tokenExchange(java.lang.Integer, java.lang.String, java.lang.String, AuthorisationScope...)