initial commit

com.synology.TMDBExample/README.md

@@ -0,0 +1,54 @@
+## The Movie Database API
+
+### API Docs
+https://developers.themoviedb.org/3
+
+
+### Search
+https://developers.themoviedb.org/3/search/search-movies
+
+- required
+  - api_key
+  - query
+- optional
+  - language, default: en-US
+  - year
+
+year information can help distinguishing movie with the same name in different year
+e.g. Total Recall, which has 1990 and 2012 version
+
+https://api.themoviedb.org/3/search/movie?api_key=${APIKEY}&query=total%20recall
+https://api.themoviedb.org/3/search/movie?api_key=${APIKEY}&query=total%20recall&language=zh-TW
+https://api.themoviedb.org/3/search/movie?api_key=${APIKEY}&query=total%20recall&year=1990
+
+
+### Movie
+https://developers.themoviedb.org/3/movies/get-movie-details
+
+- optional
+  - append_to_response, get credits (actor, director, writer) and releases (certificate) in one request
+
+https://api.themoviedb.org/3/movie/861?api_key=${APIKEY}&append_to_response=credits,releases&language=zh-TW
+
+
+### Translation
+https://developers.themoviedb.org/3/movies/get-movie-translations
+
+https://api.themoviedb.org/3/movie/861/translations?api_key=${APIKEY}
+
+
+### Image
+https://developers.themoviedb.org/3/movies/get-movie-images
+
+Movie detail has poster_path and backdrop_path.
+Image API can get more images and specify language using include_image_language parameter.
+
+Using `append_to_response` is also possible to append images result in movie detail request.
+
+
+### Language
+ISO-639-1 and ISO 3166-1
+
+https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes
+https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2
+