javastrava.api.v3.rest.SegmentEffortAPI Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of javastrava-api Show documentation

Java implementation of the Strava API

There is a newer version: 1.0.3.6

package javastrava.api.v3.rest;

import javastrava.api.v3.model.StravaSegmentEffort;
import javastrava.api.v3.rest.async.StravaAPICallback;
import javastrava.api.v3.service.exception.NotFoundException;
import retrofit.http.GET;
import retrofit.http.Path;

/**
 * 
 * API definition of segment effort services endpoints on the Strava API
 * 
 *
 * @author Dan Shannon
 *
 */
public interface SegmentEffortAPI {
	/**
	 * @see javastrava.api.v3.service.SegmentEffortService#getSegmentEffort(java.lang.Long)
	 *
	 * @param segmentEffortId Effort identifier
	 * @return Effort details
	 * @throws NotFoundException If the effort with the given id doesn't exist
	 */
	@GET("/segment_efforts/{id}")
	public StravaSegmentEffort getSegmentEffort(@Path("id") final Long segmentEffortId) throws NotFoundException;

	/**
	 * @see javastrava.api.v3.service.SegmentEffortService#getSegmentEffort(java.lang.Long)
	 *
	 * @param segmentEffortId Effort identifier
	 * @param callback The callback to execute on completion
	 * @throws NotFoundException If the effort with the given id doesn't exist
	 */
	@GET("/segment_efforts/{id}")
	public void getSegmentEffort(@Path("id") final Long segmentEffortId, final StravaAPICallback callback) throws NotFoundException;

}