搜索与查询详情

在 TMDB 上，一个常见的工作流程是搜索一部电影（或电视节目、或人物），然后查询其详细信息。以下是该流程的简要概述。

搜索

首先，您需要向电影、电视节目或人物搜索方法之一发出查询。我们将以 Jack Reacher 和电影方法为例：

curl --request GET \
     --url 'https://api.themoviedb.org/3/search/movie?query=Jack+Reacher' \
     --header 'Authorization: Bearer ACCESS_TOKEN'

这将返回一些字段，您想要查看的是 results 字段。这是一个数组，将包含我们的标准电影列表对象。以下是第一个项目的示例：

{  
  "poster_path": "/IfB9hy4JH1eH6HEfIgIGORXi5h.jpg",  
  "adult": false,  
  "overview": "Jack Reacher must uncover the truth behind a major government conspiracy in order to clear his name. On the run as a fugitive from the law, Reacher uncovers a potential secret from his past that could change his life forever.",  
  "release_date": "2016-10-19",  
  "genre_ids": [  
    53,  
    28,  
    80,  
    18,  
    9648  
  ],  
  "id": 343611,  
  "original_title": "Jack Reacher: Never Go Back",  
  "original_language": "en",  
  "title": "Jack Reacher: Never Go Back",  
  "backdrop_path": "/4ynQYtSEuU5hyipcGkfD6ncwtwz.jpg",  
  "popularity": 26.818468,  
  "vote_count": 201,  
  "video": false,  
  "vote_average": 4.19  
}

查询详细信息

有了上述项目，您可以看到电影的 id 为 343611。您可以使用该 id 来查询电影详细信息方法：

curl --request GET \
     --url 'https://api.themoviedb.org/3/movie/343611' \
     --header 'Authorization: Bearer ACCESS_TOKEN'

这将返回电影详细信息文档中概述的所有主要电影详细信息。我还建议您阅读 append to response 文档，因为它概述了如何在一次请求中进行多个子请求。例如，对于 videos：

curl --request GET \
     --url 'https://api.themoviedb.org/3/movie/11?append_to_response=videos' \
     --header 'Authorization: Bearer ACCESS_TOKEN'