renanferrari / spotify-web-api-android

Spotify Web API for Android

This project is a wrapper for Spotify Web API. It uses Retrofit to create Java interfaces from API endpoints.

Quick start with the binary

1. Download the library
2. Drop it to your Android project libraries folder (usually in app/libs)

Building the project

1. Clone the repository: git clone https://github.com/kaaes/spotify-web-api-android.git
2. Build: ./gradlew build
3. Grab the jar and put it in your project. It can be found in build/libs/spotify-web-api-android-0.1.0.jar

Using the wrapper

Out of the box it uses OkHttp HTTP client and a single thread executor.

SpotifyApi api = new SpotifyApi();

// Most (but not all) of the Spotify Web API endpoints require authorisation.
// If you know you'll only use the ones that don't require authorisation you can skip this step
api.setAccessToken("myAccessToken");

SpotifyService spotify = api.getService();

spotify.getAlbum("2dIGnmEIy1WZIcZCFSj6i8", new Callback<Album>() {
    @Override
    public void success(Album album, Response response) {
        Log.d("Album success", album.name);
    }

    @Override
    public void failure(RetrofitError error) {
        Log.d("Album failure", error.toString());
    }
});

It is also possible to construct the adapter with custom parameters.

final String accessToken = "myAccessToken";

RestAdapter restAdapter = new RestAdapter.Builder()
        .setEndpoint(SpotifyApi.SPOTIFY_WEB_API_ENDPOINT)
        .setRequestInterceptor(new RequestInterceptor() {
            @Override
            public void intercept(RequestFacade request) {
                request.addHeader("Authorization", "Bearer " + accessToken);
            }
        })
        .build();

SpotifyService spotify = restAdapter.create(SpotifyService.class);