POST /search は2つのエンドポイントに置き換えられています: POST /query と POST /movie です。古いエンドポイントはまだ動作しますが非推奨です。
/search の問題は、2つの異なることを行っていたことです。広い検索では一致リストを返し、正確なコードのときは単一レコードを返していました。この曖昧さにより、予測可能なクライアントを書くのが難しくなっていました。
今は曖昧さがありません:
POST /queryは一致リストを返します($0.0002/コール)。女優名、部分的なタイトル、スタジオ名がある場合に使用します。各結果にはid、dvdId、title、cover、releaseDateが含まれます。POST /movieは単一の完全な正規化レコードを返します($0.001/結果)。同じq+providersボディを使用しますが、すべてのフィールドを含む最良の一致を1つ返します。
リクエストボディの形式は変わりません。URL だけです。providers フィールドは JSON 配列に加えてカンマ区切りの文字列も受け付けるようになりました。移行は URL を変更するだけです。
この分割により料金の不整合も修正されました。広い検索は返すデータが少ないため安価です。完全なムービールックアップは複数のプロバイダーからメタデータを集約するため高くなります。どちらにしても、HTTP 200 の場合のみ支払いが発生します。失敗は無料です。
/search は現在内部で /query にルーティングされています。次のリリースで削除されます。完全な API 仕様については javinfo.dev/llms.txt を参照してください。
| 目的 | 古いエンドポイント | 新しいエンドポイント |
|---|---|---|
| 広いクエリ、リストが欲しい | /search (非推奨) | POST /query |
| 正確なコード、詳細が欲しい | /search (非推奨) | POST /movie |