按类型和编号查询作品的旧版接口(已弃用),新项目请使用获取单部作品接口
查看 流媒体观看平台与片库查询 的全部接口 →这是位于 /shows/{type}/{id} 的旧版接口,源规范仅将其标注为 Deprecated(已弃用)。它有两个必填路径参数 type 和 id,均为字符串,没有声明任何查询参数,因此该路径上没有 country、output_language 或 series_granularity 这类控制项。规范没有给出这两个路径参数的说明、可选值或示例。该接口既没有做过示例调用,也没有提供响应示例,所以这里无法说明其返回字段,不要假定它与其他接口一致,使用前请自行验证输出。新接入请使用位于 /shows/{id} 的获取单部作品接口:它支持内部编号、IMDb 编号(tt 加数字)或 TMDb 编号(movie/<数字> 或 tv/<数字>),并增加了可选的 country、output_language 和 series_granularity 参数。保留这个条目主要是为了让现有调用方能认出旧路径,并据此规划迁移。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 在旧路径被下线之前,审计客户端代码、代理和请求日志中是否仍有对 /shows/{type}/{id} 的调用
- 让旧集成在短期内继续运行,同时把其中的查询逐步迁移到单部作品接口
- 制作迁移清单,把每一组旧的 type 与 id 对应到 IMDb、TMDb 或内部编号
- 增加 lint 或 CI 规则,标出新写的代码里仍指向已弃用路径的地方
- 切换测试期间,对同一部作品比对旧接口与获取单部作品接口的响应,确认应用依赖的字段没有丢失
常见问题
新的集成可以使用这个已弃用的接口吗?
不可以。源规范已将它标注为 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,因此建议现在就规划迁移,而不是等到收到通知再行动。