按类型和编号查询作品的旧版接口(已弃用),新项目请使用获取单部作品接口

查看 流媒体观看平台与片库查询 的全部接口 →

这是位于 /shows/{type}/{id} 的旧版接口,源规范仅将其标注为 Deprecated(已弃用)。它有两个必填路径参数 type 和 id,均为字符串,没有声明任何查询参数,因此该路径上没有 country、output_language 或 series_granularity 这类控制项。规范没有给出这两个路径参数的说明、可选值或示例。该接口既没有做过示例调用,也没有提供响应示例,所以这里无法说明其返回字段,不要假定它与其他接口一致,使用前请自行验证输出。新接入请使用位于 /shows/{id} 的获取单部作品接口:它支持内部编号、IMDb 编号(tt 加数字)或 TMDb 编号(movie/<数字> 或 tv/<数字>),并增加了可选的 country、output_language 和 series_granularity 参数。保留这个条目主要是为了让现有调用方能认出旧路径,并据此规划迁移。

API 功能

旧版的两段式作品路径 通过 /shows/{type}/{id} 定位作品,先是 type 段,再是 id 段,与新版调用使用的单段式查询路径不同。
源规范中已标记为 Deprecated 它的摘要和说明都只写了 Deprecated,表明新代码不应该再基于这条路径来开发。
只有路径参数,没有查询选项 只声明了两个必填的路径字符串,这个操作上没有 country、语言或剧集粒度等查询参数。
迁移目标明确:获取单部作品接口 替代接口能自行识别内部编号、IMDb 编号或 TMDb 编号,因此每一组旧的 type 与 id 都可以对应到一个现代的标识符。
如实说明输出未被文档化 这条路径既没有响应示例,也没有示例调用,因此不对其返回内容做任何承诺;依赖它之前请先核对真实输出。

在线 API 演示

GET /api/project/streaming-availability/deprecated

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/streaming-availability/deprecated?key=<API_KEY>&id=<id>&type=<type>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

新的集成可以使用这个已弃用的接口吗?

不可以。源规范已将它标注为 Deprecated。请改用位于 /shows/{id} 的获取单部作品接口,它支持内部编号、IMDb 编号或 TMDb 编号,并支持 country、output_language 和 series_granularity 参数。

这个已弃用接口需要哪些输入?

需要两个必填的路径字符串 type 和 id,路径形式为 /shows/{type}/{id}。没有声明任何查询参数,规范也没有给出这两个路径参数的说明、可选值或示例。

这个已弃用接口会返回什么?

响应没有文档说明。源规范里没有这条路径的响应示例,也没有做过示例调用,所以它的字段都未经验证。不要假定它与获取单部作品接口一致;如果必须让旧调用方继续运行,请用你自己的编号测试一下。

如何从这条路径迁移到获取单部作品接口?

用内部编号、tt0120338 这样的 IMDb 编号,或写作 movie/<数字>、tv/<数字> 的 TMDb 编号调用 /shows/{id},编号类型会被自动识别。然后按需加上 country 把上架信息限定到单个市场,用 output_language 指定 en、es、tr 或 fr 文本,用 series_granularity 控制季和集的详细程度。

在这个已弃用接口上可以按国家或语言筛选吗?

没有任何声明的参数可以做到。这个操作上只有 type 和 id 两个路径值。国家、输出语言和剧集粒度这些功能在获取单部作品接口上可用。

这个已弃用接口有明确的下线日期吗?

已提供的规范没有给出下线日期,只是将该路径标记为 Deprecated,因此建议现在就规划迁移,而不是等到收到通知再行动。

相关接口

相关指南

查看订阅方案 →