javastrava.api.v3.rest.GearAPI 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: 2.0.0-alpha

package javastrava.api.v3.rest;

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

/**
 * 
 * API definitions for the gear services endpoints
 * 
 *
 * @author Dan Shannon
 *
 */
public interface GearAPI {
	/**
	 * @see javastrava.api.v3.service.GearService#getGear(java.lang.String)
	 *
	 * @param gearId Gear identifier
	 * @return Details of the identified gear
	 * @throws NotFoundException If the gear with the given id doesn't exist
	 */
	@GET("/gear/{id}")
	public StravaGear getGear(@Path("id") final String gearId) throws NotFoundException;

	/**
	 * @see javastrava.api.v3.service.GearService#getGear(java.lang.String)
	 *
	 * @param gearId Gear identifier
	 * @param callback The callback to execute on completion
	 * @throws NotFoundException If the gear with the given id doesn't exist
	 */
	@GET("/gear/{id}")
	public void getGear(@Path("id") final String gearId, StravaAPICallback callback) throws NotFoundException;

}