博客

作者 javinfo team

API 重新设计:/query 和 /movie 取代 /search

旧的 /search 端点已弃用。使用 /query 获取列表,/movie 获取单个结果。语义更清晰,成本更低,来源控制更明确。

POST /search 正在被两个端点取代:POST /queryPOST /movie。旧端点仍然可用但已弃用。

/search 的问题在于它做两件不同的事。有时它返回广泛搜索的匹配列表;有时它返回精确番号的单条记录。这种歧义使得编写可预测的客户端变得更加困难。

现在没有歧义了:

请求体格式没有改变。只是 URL 变了。providers 字段现在除了接受 JSON 数组外,也接受逗号分隔的字符串。迁移只需要更换 URL。

拆分还解决了价格不一致的问题。广泛搜索更便宜,因为返回的数据更少。完整影片查询费用更高,因为它聚合了多个数据源的元数据。无论哪种方式,你只需为 HTTP 200 付费。失败免费。

/search 目前内部重定向到 /query。它将在下个版本中移除。完整 API 规范请参阅 javinfo.dev/llms.txt

目标旧端点新端点
广泛查询,需要列表/search(已弃用)POST /query
精确番号,需要完整详情/search(已弃用)POST /movie