영화 정보 앱 만들기 - TMDB API 사용법, Collections

TMDB API 활용 예제 앱입니다.

https://play.google.com/store/apps/details?id=com.enigmah2k.movieinfo

영화정보 - Google Play 앱

TMDB API - Collections

시리즈 정보를 가져옵니다.

{collection_id} 값이 필요합니다. 

{collection_id} 는 Search의 /search/collection 으로 가져올 수 있습니다.

 

아래 링크가 Collections 관련 API 상세입니다.

https://developers.themoviedb.org/3/collections/get-collection-details

 

각 API에 대해 알아보겠습니다.

 

=============================================

< API 설명 >

1. Get Details

{collection_id} 에 해당하는 시리즈 상세정보를 가져옵니다.

 

아래와 같이 호출하면 변경된 시리즈 상세정보를 얻을 수 있습니다.

https://api.themoviedb.org/3/collection/{collection_id}/translations?api_key=<<api_key>>

{"id":10,"name":"Star Wars Collection","overview":"An epic space-opera theatrical film series, which depicts the adventures of various characters \"a long time ago in a galaxy far, far away….\"","poster_path":"/r8Ph5MYXL04Qzu4QBbq2KjqwtkQ.jpg","backdrop_path":"/d8duYyyC9J5T825Hg7grmaabfxQ.jpg","parts":[{"id":11,"video":false,"vote_count":14563,"vote_average":8.2,"title":"Star Wars","release_date":"1977-05-25","original_language":"en","original_title":"Star Wars",
...

 

아래는 응답 결과 입니다.

{
  "id": 10,
  "name": "Star Wars Collection",
  "overview": "An epic space opera theatrical film series created by George Lucas.\r The first film in the franchise was originally released on May 25, 1977, by 20th Century Fox, and became a worldwide pop culture  phenomenon, followed by two sequels, released at three-year intervals. Sixteen years after the release of the trilogy's final film, the first in a new prequel trilogy of films was released, again released at three-year intervals, with the final film released on May 19, 2005.",
  "poster_path": null,
  "backdrop_path": "/shDFE0i7josMt9IKXdYpnMFFgNV.jpg",
  "parts": [
    {
      "adult": false,
      "backdrop_path": null,
      "genre_ids": [
        12
      ],
      "id": 11,
      "original_language": "en",
      "original_title": "Star Wars: Episode IV - A New Hope",
      "overview": "Princess Leia is captured and held hostage by the evil Imperial forces in their effort to take over the galactic Empire. Venturesome Luke Skywalker and dashing captain Han Solo team together with the loveable robot duo R2-D2 and C-3PO to rescue the beautiful princess and restore peace and justice in the Empire.",
      "release_date": "1977-05-23",
      "poster_path": "/AbJBXaVPrdXROwb8KmgWUPU2XJX.jpg",
      "popularity": 1.411624,
      "title": "Star Wars: Episode IV - A New Hope",
      "video": false,
      "vote_average": 7.7,
      "vote_count": 2472
    }
  ]
}

 

2. Get Images

{collection_id} 에 해당하는 이미지를 가져옵니다.

 

아래와 같이 호출하면 변경된 시리즈 상세정보를 얻을 수 있습니다.

https://api.themoviedb.org/3/collection/{collection_id}/images?api_key=<<api_key>>

{"id":10,"backdrops":[{"aspect_ratio":1.777777777777778,"file_path":"/d8duYyyC9J5T825Hg7grmaabfxQ.jpg","height":1080,"iso_639_1":null,"vote_average":5.512,"vote_count":29,"width":1920},{"aspect_ratio":1.777777777777778,"file_path":"/eO3PyZbDe7UlkyypMgfHWdeo9VZ.jpg","height":2160,"iso_639_1":null,"vote_average":5.384,"vote_count":2,"width":3840},{"aspect_ratio":1.777777777777778,"file_path":"/trf3Hi3tPOJARsCBoVMDBlpjPC4.jpg","height":1080,"iso_639_1":"en","vote_average":5.374,"vote_count":4,"width":1920},{"aspect_ratio":1.777777777777778,"file_path":"/sGxcMvC6mfCzEir0c1tldsPhZEF.jpg","height":1080,"iso_639_1":"xx","vote_average":5.352,"vote_count":20,"width":1920},
...

 

아래는 응답 결과 입니다.

{
  "id": 10,
  "backdrops": [
    {
      "aspect_ratio": 1.77777777777778,
      "file_path": "/shDFE0i7josMt9IKXdYpnMFFgNV.jpg",
      "height": 1080,
      "iso_639_1": null,
      "vote_average": 5.3125,
      "vote_count": 1,
      "width": 1920
    }
  ],
  "posters": [
    {
      "aspect_ratio": 0.666666666666667,
      "file_path": "/hznxm4di88tWJHiCGWYDXeKk1Ih.jpg",
      "height": 1500,
      "iso_639_1": "en",
      "vote_average": 5.3125,
      "vote_count": 1,
      "width": 1000
    }
  ]
}

 

3. Get Translations

{collection_id} 에 해당하는 목록의 번역 결과를 가져옵니다

 

아래와 같이 호출하면 목록의 번역결과를 얻을 수 있습니다.

https://api.themoviedb.org/3/collection/{collection_id}/translations?api_key=<<api_key>>

{"id":10,"translations":[{"iso_3166_1":"AE","iso_639_1":"ar","name":"العربية","english_name":"Arabic","data":{"title":"","overview":"","homepage":""}},{"iso_3166_1":"BG","iso_639_1":"bg","name":"български език","english_name":"Bulgarian","data":{"title":"Междузвездни войни (поредица)","overview":"Междузвездни войни е поредица от шест филма проследяващи
...

 

아래는 응답 결과 입니다.

{
  "id": 10,
  "translations": [
    {
      "iso_3166_1": "CN",
      "iso_639_1": "zh",
      "name": "普通话",
      "english_name": "Mandarin",
      "data": {
        "title": "星球大战（系列）",
        "overview": "",
        "homepage": ""
      }
    },
    {
      "iso_3166_1": "RO",
      "iso_639_1": "ro",
      "name": "Română",
      "english_name": "Romanian",
      "data": {
        "title": "Colecția Războaiele stelare",
        "overview": "",
        "homepage": ""
      }
    },
...