POST /search 正在被两个端点取代:POST /query 和 POST /movie。旧端点仍然可用但已弃用。
/search 的问题在于它做两件不同的事。有时它返回广泛搜索的匹配列表;有时它返回精确番号的单条记录。这种歧义使得编写可预测的客户端变得更加困难。
现在没有歧义了:
POST /query返回匹配列表($0.0002/次)。当你只有演员名字、部分标题或工作室名称时使用。每个结果包含id、dvdId、title、cover和releaseDate。POST /movie返回单个完整的标准化记录($0.001/结果)。使用相同的q+providers请求体,但返回一个包含所有字段的最佳匹配结果。
请求体格式没有改变。只是 URL 变了。providers 字段现在除了接受 JSON 数组外,也接受逗号分隔的字符串。迁移只需要更换 URL。
拆分还解决了价格不一致的问题。广泛搜索更便宜,因为返回的数据更少。完整影片查询费用更高,因为它聚合了多个数据源的元数据。无论哪种方式,你只需为 HTTP 200 付费。失败免费。
/search 目前内部重定向到 /query。它将在下个版本中移除。完整 API 规范请参阅 javinfo.dev/llms.txt。
| 目标 | 旧端点 | 新端点 |
|---|---|---|
| 广泛查询,需要列表 | /search(已弃用) | POST /query |
| 精确番号,需要完整详情 | /search(已弃用) | POST /movie |