ブログ

著者 javinfo team

API 再設計: /query と /movie が /search を置き換え

古い /search エンドポイントは非推奨になりました。リストには /query、単一結果には /movie を使用してください。よりクリーンなセマンティクス、低コスト、明示的なソースコントロール。

POST /search は2つのエンドポイントに置き換えられています: POST /queryPOST /movie です。古いエンドポイントはまだ動作しますが非推奨です。

/search の問題は、2つの異なることを行っていたことです。広い検索では一致リストを返し、正確なコードのときは単一レコードを返していました。この曖昧さにより、予測可能なクライアントを書くのが難しくなっていました。

今は曖昧さがありません:

リクエストボディの形式は変わりません。URL だけです。providers フィールドは JSON 配列に加えてカンマ区切りの文字列も受け付けるようになりました。移行は URL を変更するだけです。

この分割により料金の不整合も修正されました。広い検索は返すデータが少ないため安価です。完全なムービールックアップは複数のプロバイダーからメタデータを集約するため高くなります。どちらにしても、HTTP 200 の場合のみ支払いが発生します。失敗は無料です。

/search は現在内部で /query にルーティングされています。次のリリースで削除されます。完全な API 仕様については javinfo.dev/llms.txt を参照してください。

目的古いエンドポイント新しいエンドポイント
広いクエリ、リストが欲しい/search (非推奨)POST /query
正確なコード、詳細が欲しい/search (非推奨)POST /movie