it.polimi.dima.mediatracker.external_services.rest_interfaces

Interface BookRestInterface

public interface BookRestInterface

REST interface to communicate with the books external service API

Method Summary

Modifier and Type	Method and Description
retrofit2.Call<BookJSON>	getBookInfo(java.lang.String bookId) Get data for a specific book
retrofit2.Call<BookSearchJSON>	searchBooks(java.lang.String query, int maxResults) Searches books

Method Detail

searchBooks

@GET(value="volumes?langRestrict=en&country=US&orderBy=relevance&projection=lite")
retrofit2.Call<BookSearchJSON> searchBooks(@Query(value="q")
                                                                                                                               java.lang.String query,
                                                                                                                               @Query(value="maxResults")
                                                                                                                               int maxResults)

Searches books

Parameters:

query - the title to search

maxResults - max number of results

Returns:

a search JSON representation

getBookInfo

@GET(value="volumes/{bookId}")
retrofit2.Call<BookJSON> getBookInfo(@Path(value="bookId")
                                                                     java.lang.String bookId)

Get data for a specific book

Parameters:

bookId - the ID of the book

Returns:

the book JSON representation