REST APIにおいてパフォーマンス上の理由から、リソースの単一のフィールドのみを返したい

Question

現在マイクロサービスアーキテクチャにて、REST APIとフロントエンドの開発を行っています。

ウェブサイトの描画の都合上、1ページで100を超えるリソースの一部情報を取得したいのですが、全てのリソースを素直に取ろうとすると、ページ描画に必要な情報が揃うまでに長いロード時間を要します。(実際にはBFF層がリクエストの集約を行っています)

リソースの情報をresources/:idから取得する際、大量のデータベースレコードを集約した結果を返すため、どうしてもレスポンスタイムが遅くなってしまいます。

ただし対象となるウェブサイトで必要な情報はその中の一部のみで、集約処理が必要でないので、それだけを返すならばかなり高速なレスポンスが可能です。

マイクロサービスとして開発している以上、REST APIが画面の都合を知った上で設計するのは望ましくないと考えており、またURL設計としてresources/:idの形が基本だと認識しています。

その上で、欲しいフィールドのみを返すのはREST APIとしてあるべき形なのか、またそうであるならばどのようなURL設計にするべきなのでしょうか。

例としてarticleリソースがあり、articles/:idを叩くと重い集約作業が発生しますが、今回ほしいのはcomment_countのような軽い情報だけというケースになります。

もし今回のケースにおいて知見がある方がいらっしゃればご回答頂けると幸いです。

Answer 1

こちらなどいかがでしょうか？
レスポンスのフィールドを絞れるようにしよう