La libreria Javascript di TMDB è un wrapper per le API di The Movie Database (TMDB).
Per usare questa libreria è necessario registrare una API Key, visita TMDB Developer page per maggiori info.
Il codice sorgente è disponibile nella repository GitHub.
app.api.tmdb
La libreria è accessibile dall'oggetto app.api.tmdb
api_key string
Imposta l'API Key per le API (obbligatorio).
language string
Imposta la lingua per le API in formato ISO 639-1. Il valore predefinito è "en-US".
searchMovies(query app.query object) array of search results
La funzione ricerca film e restituisce un array di risultati di ricerca.
getMovie(id integer) movie
La funzione ottiene un film dall'ID. Restituisce un film oppure undefined se questo non esiste.
searchTV(query app.query object) array of search results
La funzione ricerca serie TV e restituisce un array di risultati di ricerca.
getTV(id integer) tv
La funzione ottiene una serie TV dall'ID. Restituisce una serie TV oppure undefined se questo non esiste.
imageURL(path string, size string) string
Restituisce l'URL da un percorso relativo di un'immagine. Il parametro size è opzionale (valore di default è "original").
movieClass class
Imposta una classe personalizzata per movie, la classe deve estendere app.classes.api.tmdb.movie
tvClass class
Imposta una classe personalizzata per TV series, la classe deve estendere app.classes.api.tmdb.tv
seasonClass class
Imposta una classe personalizzata per TV season, la classe deve estendere app.classes.api.tmdb.season
episodeClass class
Imposta una classe personalizzata per TV episode, la classe deve estendere app.classes.api.tmdb.episode
// TMDB movies search (1.1) // https://github.com/risolvipro/collections app.api.tmdb.api_key = "YOUR API KEY"; app.api.tmdb.language = "en-US"; let results = app.api.tmdb.searchMovies(app.query); app.result(results);
// TMDB tv search (1.1) // https://github.com/risolvipro/collections app.api.tmdb.api_key = "YOUR API KEY"; app.api.tmdb.language = "en-US"; let results = app.api.tmdb.searchTV(app.query); app.result(results);
Movie
app.classes.api.tmdb.movie
Questa classe gestisce un film.
constructor(data json, creditsData json) movie
data json
Dati json restituiti dalle API di TMDB.
creditsData json
Dati json dei credits restituiti dalle API di TMDB.
id integer
ID del film.
title string
Titolo del film.
overview string
Riassunto del film.
releaseDate date
Data di pubbliazione del film come oggetto Date.
posterURL(size string) string
Ottieni l'URL della locandina nella dimensione specificata. Il parametro size è opzionale, il valore predefinito è "original".
requestPoster(size string) image
Richiedi la locandina nella dimensione specificata. Restituisce un'immagine oppure undefined se la richiesta fallisce. Il parametro size è opzionale, il valore predefinito è "original".
runtime number
Durata in secondi.
genres array of list item suggestions
Ottieni i generi come array di suggerimenti per una lista.
actors(limit integer) array of document suggestions
Ottieni gli attori come array di suggerimenti per documenti.
directors array of document suggestions
Ottieni i registi come array di suggerimenti per documenti.
configureActor(actor document, data json)
Implementa questo metodo nella tua classe personalizzata per configurare un attore prima che venga aggiunto all'array actors.
configureDirector(director document, data json)
Implementa questo metodo nella tua classe personalizzata per configurare un regista prima che venga aggiunto all'array directors.
// TMDB movies document (1.1)
// https://github.com/risolvipro/collections
app.api.tmdb.api_key = "YOUR API KEY";
app.api.tmdb.language = "en-US";
let movie = app.api.tmdb.getMovie(app.params.id);
if(movie == undefined) {
app.fail();
}
let builder = app.document.builder();
builder.setString(movie.title, "title");
builder.setString(movie.id, "tmdb-id");
builder.setImage(movie.requestPoster(), "poster");
builder.setString(movie.overview, "overview");
builder.setListItems(movie.genres, "genre");
builder.setDate(movie.releaseDate, "release-date");
builder.setDecimal(movie.runtime, "runtime");
builder.setDocuments(movie.actors(10), "actors");
builder.setDocuments(movie.directors, "directors");
app.result(builder);
TV Series
app.classes.api.tmdb.tv
constructor(data json) tv
data json
Dati json restituiti dalle API di TMDB.
id integer
ID della serie TV.
name string
Nome della serie TV.
overview string
Riassunto della serie TV.
firstAirDate date
Data messa in onda.
posterURL(size string) string
Ottieni l'URL della locandina nella dimensione specificata. Il parametro size è opzionale, il valore predefinito è "original".
requestPoster(size string) image
Richiedi la locandina nella dimensione specificata. Restituisce un'immagine oppure undefined se la richiesta fallisce. Il parametro size è opzionale, il valore predefinito è "original".
genres array of list item suggestions
Ottieni i generi come array di suggerimenti per una lista.
actors(limit integer) array of document suggestions
Ottieni gli attori come array di suggerimenti per documenti.
seasons array of document suggestions
Ottieni le stagioni come array di suggerimenti per documenti.
configureActor(actor document, data json)
Implementa questo metodo nella tua classe personalizzata per configurare un attore prima che venga aggiunto all'array actors.
configureSeason(season document, object season object)
Implementa questo metodo nella tua classe personalizzata per configurare una stagione prima che venga aggiunta all'array seasons. Consulta TV Season per altre info.
configureEpisode(episode document, object episode object)
Implementa questo metodo nella tua classe personalizzata per configurare un episodio prima che venga aggiunto all'array episodes. Consulta TV Episode per altre info.
// TMDB tv document (1.1)
// https://github.com/risolvipro/collections
app.api.tmdb.api_key = "YOUR API KEY";
app.api.tmdb.language = "en-US";
let tvShow = app.api.tmdb.getTV(app.params.id);
if(tvShow == undefined) {
app.fail();
}
let builder = app.document.builder();
builder.setString(tvShow.name, "name");
builder.setImage(tvShow.requestPoster(), "poster");
builder.setString(tvShow.overview, "overview");
builder.setListItems(tvShow.genres, "genre");
builder.setDate(tvShow.firstAirDate, "air-date");
builder.setDocuments(tvShow.actors(10), "actors");
builder.setManagedDocuments(tvShow.seasons, "seasons");
builder.setString(tvShow.id, "tmdb-id");
app.result(builder);
TV Season
app.classes.api.tmdb.season
Questa classe gestisce una stagione TV.
constructor(data json) season
data json
Dati json restituiti dalle API di TMDB.
id integer
name string
seasonNumber integer
airDate date
TV Episode
app.classes.api.tmdb.episode
Questa classe gestisce un episodio TV.
constructor(data json) episode
data json
Dati json restituiti dalle API di TMDB.
id integer
name string
seasonNumber integer
episodeNumber integer
runtime number
airDate date