Interface TheTVDBApi.JSON
-
- Enclosing interface:
- TheTVDBApi
public static interface TheTVDBApi.JSON
Interface representing the API'sJSON
layout.
This layout may be used if you do not want any post-processing being applied to the actual remote service response data. All methods within this layout will return the raw, unmodified JSON data as it was received from the API. This might be useful if you prefer to map the JSON data yourself, want to use your own Java data models or if you don't want to parse the JSON data at all (but forward it to some other service for example). This layout does not provide any shortcut-methods though.- See Also:
TheTVDBApi.json()
-
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description com.fasterxml.jackson.databind.JsonNode
addToFavorites(long seriesId)
Adds the supplied series ID to the user’s favorite’s list and returns the updated list as raw JSON.com.fasterxml.jackson.databind.JsonNode
addToRatings(String itemType, long itemId, long itemRating)
Updates a given rating of a given type and returns the modified rating, mapped as raw JSON.com.fasterxml.jackson.databind.JsonNode
deleteFromFavorites(long seriesId)
Deletes the given series ID from the user’s favorite’s list and returns the updated list as raw JSON.com.fasterxml.jackson.databind.JsonNode
deleteFromRatings(String itemType, long itemId)
Deletes a given rating of a given type.com.fasterxml.jackson.databind.JsonNode
filterSeries(long seriesId, QueryParameters queryParameters)
Returns a filtered series record based on the given parameters, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getActors(long seriesId)
Returns the actors for a specific series as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableEpisodeQueryParameters(long seriesId)
Returns a list of keys which are valid parameters for querying episodes, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableImageQueryParameters(long seriesId)
Returns a list of valid parameters for querying a series images, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableLanguages()
Returns an overview of all supported languages as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableLastUpdatedQueryParameters()
Returns a list of valid parameters for querying series which have been updated lately, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableRatingsQueryParameters()
Returns a list of valid parameters for querying user ratings, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableSeriesFilterParameters(long seriesId)
Returns a list of keys which are valid parameters for filtering series, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getAvailableSeriesSearchParameters()
Returns possible query parameters, which can be used to search for series, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getEpisode(long episodeId)
Returns the full information for a given episode id as raw JSON.com.fasterxml.jackson.databind.JsonNode
getEpisodes(long seriesId, QueryParameters queryParameters)
Returns all episodes of a specific series as raw JSON.com.fasterxml.jackson.databind.JsonNode
getFavorites()
Returns an array of favorite series for a given user, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getLanguage(long languageId)
Returns further language information for a given language ID as raw JSON.com.fasterxml.jackson.databind.JsonNode
getMovie(long movieId)
Returns detailed information for a specific movie as raw JSON.com.fasterxml.jackson.databind.JsonNode
getMovieUpdates(long since)
Returns a list of ID's of all movies, that have been updated since the given epoch timestamp, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getRatings()
Returns a list of ratings for the given user, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getSeries(long seriesId)
Returns detailed information for a specific series as raw JSON.com.fasterxml.jackson.databind.JsonNode
getSeriesEpisodesSummary(long seriesId)
Returns a summary of the episodes and seasons available for a series, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getSeriesHeaderInformation(long seriesId)
Returns header information for a specific series as raw JSON.com.fasterxml.jackson.databind.JsonNode
getSeriesImagesSummary(long seriesId)
Returns a summary of the images types and counts available for a particular series, as raw JSON.com.fasterxml.jackson.databind.JsonNode
getUser()
Returns basic information about the currently authenticated user, as raw JSON.com.fasterxml.jackson.databind.JsonNode
queryEpisodes(long seriesId, QueryParameters queryParameters)
Returns all matching episodes of a specific series as raw JSON.com.fasterxml.jackson.databind.JsonNode
queryImages(long seriesId, QueryParameters queryParameters)
Returns the matching result of querying images for a specific series, as raw JSON.com.fasterxml.jackson.databind.JsonNode
queryLastUpdated(QueryParameters queryParameters)
Returns an array of series that have changed in a maximum of one week blocks since the providedfromTime
query parameter, as raw JSON.com.fasterxml.jackson.databind.JsonNode
queryRatings(QueryParameters queryParameters)
Returns a list of ratings for a given user that match the query, as raw JSON.com.fasterxml.jackson.databind.JsonNode
searchSeries(QueryParameters queryParameters)
Returns series search results based on the given query parameters as raw JSON.
-
-
-
Method Detail
-
getEpisode
com.fasterxml.jackson.databind.JsonNode getEpisode(long episodeId) throws APIException
Returns the full information for a given episode id as raw JSON.
Corresponds to remote API route: [GET] /episodes/{id}- Parameters:
episodeId
- The ID of the episode- Returns:
- JSON object containing the full episode information
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given episode ID does not exist, etc.- See Also:
TheTVDBApi.getEpisode(episodeId)
,TheTVDBApi.Extended.getEpisode(episodeId)
-
getAvailableLanguages
com.fasterxml.jackson.databind.JsonNode getAvailableLanguages() throws APIException
Returns an overview of all supported languages as raw JSON. These language abbreviations can be used to set the preferred language for the communication with the remote service (seeTheTVDBApi.setLanguage(String)
.
Corresponds to remote API route: [GET] /languages- Returns:
- JSON object containing all languages that are supported by the remote service
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc.- See Also:
TheTVDBApi.getAvailableLanguages()
,TheTVDBApi.Extended.getAvailableLanguages()
-
getLanguage
com.fasterxml.jackson.databind.JsonNode getLanguage(long languageId) throws APIException
Returns further language information for a given language ID as raw JSON. The language abbreviation can be used to set the preferred language for the communication with the remote service (seeTheTVDBApi.setLanguage(String)
.
Corresponds to remote API route: [GET] /languages/{id}- Parameters:
languageId
- The ID of the language- Returns:
- JSON object containing detailed language information
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if the given language ID does not exist.- See Also:
TheTVDBApi.getLanguage(languageId)
,TheTVDBApi.Extended.getLanguage(languageId)
-
getMovie
com.fasterxml.jackson.databind.JsonNode getMovie(long movieId) throws APIException
Returns detailed information for a specific movie as raw JSON.
Corresponds to remote API route: [GET] /movies/{id}- Parameters:
movieId
- The TheTVDB.com movie ID- Returns:
- JSON object containing detailed information for a specific movie
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given movie ID does not exist, etc.- See Also:
TheTVDBApi.getMovie(movieId)
,TheTVDBApi.Extended.getMovie(movieId)
-
getMovieUpdates
com.fasterxml.jackson.databind.JsonNode getMovieUpdates(long since) throws APIException
Returns a list of ID's of all movies, that have been updated since the given epoch timestamp, as raw JSON.
Corresponds to remote API route: [GET] /movieupdates- Parameters:
since
- Epoch time to start your date range- Returns:
- JSON object containing the ID's of all movies that have been updated beginning at the given
since
time - Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc.- See Also:
TheTVDBApi.getMovieUpdates(since)
,TheTVDBApi.Extended.getMovieUpdates(since)
-
searchSeries
com.fasterxml.jackson.databind.JsonNode searchSeries(QueryParameters queryParameters) throws APIException
Returns series search results based on the given query parameters as raw JSON. The result contains basic information of all series matching the query parameters.
Corresponds to remote API route: [GET] /search/series- Parameters:
queryParameters
- Object containing key/value pairs of query search parameters. For a complete list of possible search parameters see the API documentation or usegetAvailableSeriesSearchParameters()
.- Returns:
- JSON object containing the series search results
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no records are found that match your query.- See Also:
TheTVDBApi.searchSeries(queryParameters)
,TheTVDBApi.Extended.searchSeries(queryParameters)
-
getAvailableSeriesSearchParameters
com.fasterxml.jackson.databind.JsonNode getAvailableSeriesSearchParameters() throws APIException
Returns possible query parameters, which can be used to search for series, as raw JSON.
Corresponds to remote API route: [GET] /search/series/params- Returns:
- JSON object containing possible parameters to query by in the series search route
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc.- See Also:
TheTVDBApi.getAvailableSeriesSearchParameters()
,TheTVDBApi.Extended.getAvailableSeriesSearchParameters()
,searchSeries(queryParams)
,TheTVDBApi.searchSeries(queryParams)
,TheTVDBApi.Extended.searchSeries(queryParams)
-
getSeries
com.fasterxml.jackson.databind.JsonNode getSeries(long seriesId) throws APIException
Returns detailed information for a specific series as raw JSON.
Corresponds to remote API route: [GET] /series/{id}- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing detailed information for a specific series
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.getSeries(seriesId)
,TheTVDBApi.Extended.getSeries(seriesId)
-
getSeriesHeaderInformation
com.fasterxml.jackson.databind.JsonNode getSeriesHeaderInformation(long seriesId) throws APIException
Returns header information for a specific series as raw JSON. Good for getting the Last-Updated header to find out when the series was last modified.
Corresponds to remote API route: [HEAD] /series/{id}- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- Artificial JSON object based on the HTML header information returned by the remote service
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.getSeriesHeaderInformation(seriesId)
,TheTVDBApi.Extended.getSeriesHeaderInformation(seriesId)
-
getActors
com.fasterxml.jackson.databind.JsonNode getActors(long seriesId) throws APIException
Returns the actors for a specific series as raw JSON.
Corresponds to remote API route: [GET] /series/{id}/actors- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing the actors for a specific series
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.getActors(seriesId)
,TheTVDBApi.Extended.getActors(seriesId)
-
getEpisodes
com.fasterxml.jackson.databind.JsonNode getEpisodes(long seriesId, QueryParameters queryParameters) throws APIException
Returns all episodes of a specific series as raw JSON. Results will be paginated with 100 results per page. UsequeryParameters
to select a specific result page.
Corresponds to remote API route: [GET] /series/{id}/episodes- Parameters:
seriesId
- The TheTVDB.com series IDqueryParameters
- Object containing key/value pairs of query parameters. For a complete list of possible parameters see the API documentation.- Returns:
- JSON object containing a single result page of episodes
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.getEpisodes(seriesId, queryParameters)
,TheTVDBApi.Extended.getEpisodes(seriesId, queryParameters)
-
queryEpisodes
com.fasterxml.jackson.databind.JsonNode queryEpisodes(long seriesId, QueryParameters queryParameters) throws APIException
Returns all matching episodes of a specific series as raw JSON. Results will be paginated. UsequeryParameters
to filter for specific episodes or to select a specific result page.
Corresponds to remote API route: [GET] /series/{id}/episodes/query- Parameters:
seriesId
- The TheTVDB.com series IDqueryParameters
- Object containing key/value pairs of query parameters. For a complete list of possible query parameters see the API documentation or usegetAvailableEpisodeQueryParameters(seriesId)
.- Returns:
- JSON object containing a single result page of queried episode records
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc. or if no records are found that match your query.- See Also:
TheTVDBApi.queryEpisodes(seriesId, queryParameters)
,TheTVDBApi.Extended.queryEpisodes(seriesId, queryParameters)
-
getAvailableEpisodeQueryParameters
com.fasterxml.jackson.databind.JsonNode getAvailableEpisodeQueryParameters(long seriesId) throws APIException
Returns a list of keys which are valid parameters for querying episodes, as raw JSON. These keys are permitted to be used inQueryParameters
objects when querying for specific episodes of a series.
Corresponds to remote API route: [GET] /series/{id}/episodes/query/params- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing all allowed keys to be used for querying episodes
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
queryEpisodes(seriesId, queryParameters)
,TheTVDBApi.getAvailableEpisodeQueryParameters(seriesId)
,TheTVDBApi.Extended.getAvailableEpisodeQueryParameters(seriesId)
-
getSeriesEpisodesSummary
com.fasterxml.jackson.databind.JsonNode getSeriesEpisodesSummary(long seriesId) throws APIException
Returns a summary of the episodes and seasons available for a series, as raw JSON.
Note: Season "0" is for all episodes that are considered to be specials.
Corresponds to remote API route: [GET] /series/{id}/episodes/summary- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing a summary of the episodes and seasons available for the given series
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.getSeriesEpisodesSummary(seriesId)
,TheTVDBApi.Extended.getSeriesEpisodesSummary(seriesId)
-
filterSeries
com.fasterxml.jackson.databind.JsonNode filterSeries(long seriesId, QueryParameters queryParameters) throws APIException
Returns a filtered series record based on the given parameters, as raw JSON.
Corresponds to remote API route: [GET] /series/{id}/filter- Parameters:
seriesId
- The TheTVDB.com series IDqueryParameters
- Object containing key/value pairs of query parameters. For a complete list of possible query parameters see the API documentation or usegetAvailableSeriesFilterParameters(seriesId)
.- Returns:
- JSON object containing a filtered series record
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.filterSeries(seriesId, queryParameters)
,TheTVDBApi.Extended.filterSeries(seriesId, queryParameters)
-
getAvailableSeriesFilterParameters
com.fasterxml.jackson.databind.JsonNode getAvailableSeriesFilterParameters(long seriesId) throws APIException
Returns a list of keys which are valid parameters for filtering series, as raw JSON. These keys are permitted to be used inQueryParameters
objects when filtering for a specific series.
Corresponds to remote API route: [GET] /series/{id}/filter/params- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing a list of all keys allowed to filter by
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
filterSeries(seriesId, queryParameters)
,TheTVDBApi.getAvailableSeriesFilterParameters(seriesId)
,TheTVDBApi.Extended.getAvailableSeriesFilterParameters(seriesId)
-
getSeriesImagesSummary
com.fasterxml.jackson.databind.JsonNode getSeriesImagesSummary(long seriesId) throws APIException
Returns a summary of the images types and counts available for a particular series, as raw JSON.
Corresponds to remote API route: [GET] /series/{id}/images- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing a summary of the image types and counts available for the given series
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
TheTVDBApi.getSeriesImagesSummary(seriesId)
,TheTVDBApi.Extended.getSeriesImagesSummary(seriesId)
-
queryImages
com.fasterxml.jackson.databind.JsonNode queryImages(long seriesId, QueryParameters queryParameters) throws APIException
Returns the matching result of querying images for a specific series, as raw JSON.
Corresponds to remote API route: [GET] /series/{id}/images/query- Parameters:
seriesId
- The TheTVDB.com series IDqueryParameters
- Object containing key/value pairs of query parameters. For a complete list of possible query parameters see the API documentation or usegetAvailableImageQueryParameters(seriesId)
.- Returns:
- JSON object containing images that matched the query
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc. or if no records are found that match your query.- See Also:
TheTVDBApi.queryImages(seriesId, queryParameters)
,TheTVDBApi.Extended.queryImages(seriesId, queryParameters)
-
getAvailableImageQueryParameters
com.fasterxml.jackson.databind.JsonNode getAvailableImageQueryParameters(long seriesId) throws APIException
Returns a list of valid parameters for querying a series images, as raw JSON. Unlike other routes, querying for a series images may be restricted to certain combinations of query keys. The allowed combinations are clustered in the data array of the returned JSON object.
Corresponds to remote API route: [GET] /series/{id}/images/query/params- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing a list of possible parameters which may be used to query a series images
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, the given series ID does not exist, etc.- See Also:
queryImages(seriesId, queryParameters)
,TheTVDBApi.getAvailableImageQueryParameters(seriesId)
,TheTVDBApi.Extended.getAvailableImageQueryParameters(seriesId)
-
queryLastUpdated
com.fasterxml.jackson.databind.JsonNode queryLastUpdated(QueryParameters queryParameters) throws APIException
Returns an array of series that have changed in a maximum of one week blocks since the providedfromTime
query parameter, as raw JSON. Note that the given query parameters must always contain some validfromTime
Epoch timestamp key.
The user may specify an additionaltoTime
query key to grab results for less than a week. Any timespan larger than a week will be reduced down to one week automatically.
Corresponds to remote API route: [GET] /updated/query- Parameters:
queryParameters
- Object containing key/value pairs of query parameters. For a complete list of possible query parameters see the API documentation or usegetAvailableLastUpdatedQueryParameters()
.- Returns:
- JSON object containing a list of updated objects that match the given timeframe
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or no records exist for the given timespan.- See Also:
TheTVDBApi.queryLastUpdated(queryParameters)
,TheTVDBApi.Extended.queryLastUpdated(queryParameters)
-
getAvailableLastUpdatedQueryParameters
com.fasterxml.jackson.databind.JsonNode getAvailableLastUpdatedQueryParameters() throws APIException
Returns a list of valid parameters for querying series which have been updated lately, as raw JSON. These keys are permitted to be used inQueryParameters
objects when querying for recently updated series.
Corresponds to remote API route: [GET] /updated/query/params- Returns:
- JSON object containing a list of possible parameters which may be used to query for last updated series
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc.- See Also:
queryLastUpdated(queryParameters)
,TheTVDBApi.getAvailableLastUpdatedQueryParameters()
,TheTVDBApi.Extended.getAvailableLastUpdatedQueryParameters()
-
getUser
com.fasterxml.jackson.databind.JsonNode getUser() throws APIException
Returns basic information about the currently authenticated user, as raw JSON.
Corresponds to remote API route: [GET] /user- Returns:
- JSON object containing basic user information
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user- See Also:
TheTVDBApi.getUser()
,TheTVDBApi.Extended.getUser()
-
getFavorites
com.fasterxml.jackson.databind.JsonNode getFavorites() throws APIException
Returns an array of favorite series for a given user, as raw JSON. Will be a blank array if no favorites exist.
Corresponds to remote API route: [GET] /user/favorites- Returns:
- JSON object containing the user favorites
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user- See Also:
TheTVDBApi.getFavorites()
,TheTVDBApi.Extended.getFavorites()
-
deleteFromFavorites
com.fasterxml.jackson.databind.JsonNode deleteFromFavorites(long seriesId) throws APIException
Deletes the given series ID from the user’s favorite’s list and returns the updated list as raw JSON.
Corresponds to remote API route: [DELETE] /user/favorites/{id}- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing the updated list of user favorites
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user or the requested record could not be deleted- See Also:
addToFavorites(seriesId)
,TheTVDBApi.deleteFromFavorites(seriesId)
,TheTVDBApi.Extended.deleteFromFavorites(seriesId)
-
addToFavorites
com.fasterxml.jackson.databind.JsonNode addToFavorites(long seriesId) throws APIException
Adds the supplied series ID to the user’s favorite’s list and returns the updated list as raw JSON.
Corresponds to remote API route: [PUT] /user/favorites/{id}- Parameters:
seriesId
- The TheTVDB.com series ID- Returns:
- JSON object containing the updated list of user favorites
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user or the requested record could not be updated- See Also:
deleteFromFavorites(seriesId)
,TheTVDBApi.addToFavorites(seriesId)
,TheTVDBApi.Extended.addToFavorites(seriesId)
-
getRatings
com.fasterxml.jackson.databind.JsonNode getRatings() throws APIException
Returns a list of ratings for the given user, as raw JSON.
Corresponds to remote API route: [GET] /user/ratings- Returns:
- JSON object containing a list of user ratings
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user- See Also:
TheTVDBApi.getRatings()
,TheTVDBApi.Extended.getRatings()
-
queryRatings
com.fasterxml.jackson.databind.JsonNode queryRatings(QueryParameters queryParameters) throws APIException
Returns a list of ratings for a given user that match the query, as raw JSON.
Corresponds to remote API route: [GET] /user/ratings/query- Parameters:
queryParameters
- Object containing key/value pairs of query parameters. For a complete list of possible query parameters see the API documentation or usegetAvailableRatingsQueryParameters()
.- Returns:
- JSON object containing a list of user ratings that match the given query
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user- See Also:
TheTVDBApi.queryRatings(queryParameters)
,TheTVDBApi.Extended.queryRatings(queryParameters)
-
getAvailableRatingsQueryParameters
com.fasterxml.jackson.databind.JsonNode getAvailableRatingsQueryParameters() throws APIException
Returns a list of valid parameters for querying user ratings, as raw JSON. These keys are permitted to be used inQueryParameters
objects when querying for ratings.
Corresponds to remote API route: [GET] /user/ratings/query/params- Returns:
- JSON object containing a list of possible parameters which may be used to query for user ratings
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no information exists for the current user- See Also:
queryRatings(queryParameters)
,TheTVDBApi.getAvailableRatingsQueryParameters()
,TheTVDBApi.Extended.getAvailableRatingsQueryParameters()
-
deleteFromRatings
com.fasterxml.jackson.databind.JsonNode deleteFromRatings(@Nonnull String itemType, long itemId) throws APIException
Deletes a given rating of a given type.
Corresponds to remote API route: [DELETE] /user/ratings/{itemType}/{itemId}- Parameters:
itemType
- Item to update. Can be either 'series', 'episode', or 'image'.itemId
- ID of the ratings record that you wish to delete- Returns:
- JSON object as returned by the remote service (probably containing an empty data block)
- Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no rating is found that matches your given parameters- See Also:
addToRatings(itemType, itemId, itemRating)
,TheTVDBApi.deleteFromRatings(itemType, itemId)
,TheTVDBApi.Extended.deleteFromRatings(itemType, itemId)
-
addToRatings
com.fasterxml.jackson.databind.JsonNode addToRatings(@Nonnull String itemType, long itemId, long itemRating) throws APIException
Updates a given rating of a given type and returns the modified rating, mapped as raw JSON. If no rating exists yet, a new rating will be created.
Corresponds to remote API route: [PUT] /user/ratings/{itemType}/{itemId}/{itemRating}- Parameters:
itemType
- Item to update. Can be either 'series', 'episode', or 'image'.itemId
- ID of the ratings record that you wish to modifyitemRating
- The updated rating number- Returns:
- JSON object containing the modified rating (whether it was added or updated)
Note: It seems that the data returned by the remote service for this route is quite unreliable! It might not always return the modified rating but an empty data array instead. - Throws:
APIException
- If an exception with the remote API occurs, e.g. authentication failure, IO error, resource not found, etc. or if no rating is found that matches your given parameters- See Also:
deleteFromRatings(itemType, itemId)
,TheTVDBApi.addToRatings(itemType, itemId, itemRating)
,TheTVDBApi.Extended.addToRatings(itemType, itemId, itemRating)
-
-