Package de.jsone_studios.wrapper.spotify.services

Interface BrowseSpotifyService

  • public interface BrowseSpotifyService

    • Method Detail

      • getCategory

        @GET("browse/categories/{category_id}")
retrofit2.Call<Category> getCategory​(@Path("category_id")
                                     String categoryId,
                                     @QueryMap
                                     Map<String,​Object> options)
        Retrieve a Spotify category.
        Parameters:
        categoryId - The category's ID.
        options - Optional parameters.
        Returns:
        A Spotify category.
        See Also:
        Get a Spotify Category

      • getPlaylistsForCategory

        @GET("browse/categories/{category_id}/playlists")
retrofit2.Call<PlaylistsPager> getPlaylistsForCategory​(@Path("category_id")
                                                       String categoryId,
                                                       @QueryMap
                                                       Map<String,​Object> options)
        Retrieve playlists for a Spotify Category.
        Parameters:
        categoryId - The category's ID.
        options - Optional parameters.
        Returns:
        Playlists for a Spotify Category.
        See Also:
        Get playlists for a Spotify Category

      • getCategories

        @GET("browse/categories")
retrofit2.Call<CategoriesPager> getCategories​(@QueryMap
                                              Map<String,​Object> options)
        Retrieve Spotify categories. Categories used to tag items in Spotify (on, for example, the Spotify player’s “Browse” tab).
        Parameters:
        options - Optional parameters.
        Returns:
        A paging object containing categories.
        See Also:
        Get a List of Categories

      • getFeaturedPlaylists

        @GET("browse/featured-playlists")
retrofit2.Call<FeaturedPlaylists> getFeaturedPlaylists()
        Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).
        Returns:
        A FeaturedPlaylists object with the featured playlists
        See Also:
        Get a List of Featured Playlists

      • getFeaturedPlaylists

        @GET("browse/featured-playlists")
retrofit2.Call<FeaturedPlaylists> getFeaturedPlaylists​(@QueryMap
                                                       Map<String,​Object> options)
        Get a list of Spotify featured playlists (shown, for example, on a Spotify player’s “Browse” tab).
        Parameters:
        options - Optional parameters. For list of supported parameters see endpoint documentation
        Returns:
        n FeaturedPlaylists object with the featured playlists
        See Also:
        Get a List of Featured Playlists

      • getNewReleases

        @GET("browse/new-releases")
retrofit2.Call<NewReleases> getNewReleases()
        Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
        Returns:
        A NewReleases object with the new album releases
        See Also:
        Get a List of New Releases

      • getNewReleases

        @GET("browse/new-releases")
retrofit2.Call<NewReleases> getNewReleases​(@QueryMap
                                           Map<String,​Object> options)
        Get a list of new album releases featured in Spotify (shown, for example, on a Spotify player’s “Browse” tab).
        Parameters:
        options - Optional parameters. For list of supported parameters see endpoint documentation
        Returns:
        A NewReleases object with the new album releases
        See Also:
        Get a List of New Releases

      • getRecommendations

        @GET("recommendations")
retrofit2.Call<Recommendations> getRecommendations​(@QueryMap
                                                   Map<String,​Object> options)
        Create a playlist-style listening experience based on seed artists, tracks and genres.
        Parameters:
        options - Optional parameters. For list of available parameters see endpoint documentation
        Returns:
        Recommendations response object

      • getSeedsGenres

        @GET("recommendations/available-genre-seeds")
retrofit2.Call<SeedsGenres> getSeedsGenres()
        Retrieve a list of available genres seed parameter values for recommendations.
        Returns:
        An object whose key is "genres" and whose value is an array of available genres.