成熟したRESTAPIは多くの作業になる可能性があり、リソースを柔軟な方法で公開することは通常、バランスをとる行為です。

一方では、クライアントが多くの柔軟な方法で情報を検索できるようにしたい。 一方、あまり多くの操作を実装する必要はありません。

APIの検索/クエリ言語が最も理にかなっています。これにより、強力な検索のためにAPIを開いたまま、単一のクリーンな操作が可能になります。