追加到响应

append_to_response 是一种简单高效的方法，用于向任何顶级命名空间附加额外请求。电影、电视剧、电视季、电视集和人物的详情方法都支持一个名为 append_to_response 的查询参数。这使得在单个 HTTP 请求中在同一命名空间内发起子请求成为可能。每个请求将作为新的 JSON 对象附加到响应中。

这里有一个快速示例，假设您需要获取电影详情和该电影的视频。通常您会认为需要发出两个请求：

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

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

但使用 append_to_response，您可以发出单个请求：

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

更强大的是，您可以发出多个请求，只需将值用逗号分隔即可：

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

注意

每个方法仍会响应各个独立请求所支持的查询参数。这一点特别值得指出的是图像，因为您的语言参数将过滤图像。这正是 include_image_language 参数可以发挥作用的地方，正如 图像语言 页面中所概述的那样。