基本ユーザー情報とユーザーのスペース情報を取得するための REST API を提供しました。
/v1/users/{user_id}/profile、次のような JSON を返します。
json {
"id":123, "name":"foo", "sex":0, "email":"foo@gmail.com", } ```
/v1/users/{user_id}/spaceも JSON を返します。
```json { "sum_space":100, "used_space":20, }
クライアント (例: Web ページ、3 番目のアプリケーション) に、ユーザー情報の一部 (例: 「名前」、「性別」) とユーザー空間情報の一部 (例: 「sum_space」) を同時に表示する必要があるビューがある場合、次のような新しい集計 API を提供する必要があります/v1/users/{user_id}
か?
また、このような集計 API を提供する場合、ユーザーとスペースのすべての属性を返す必要がありますか? そうした場合、戻り値には未使用の値が含まれるため、ネットワークの帯域幅が増加します。しかし、この API がクライアントが必要とするものを返すだけの場合、新しいクライアントの要件が発生した場合 (たとえば、ユーザーの名前とユーザーの used_space を取得するだけ) はどうすればよいでしょうか?
アグリゲーション API を提供しない場合、すべてのクライアントは、N 種類のリソースを取得するために N 回呼び出す必要があります。フィルター検索の要件がある場合 (合計スペースが 100 を超えるユーザー リストを取得するなど)、クライアントはこれを連続的にしか実行できませんでした。
私はそれらについて非常に混乱しています。それに従うべきガイドラインはありますか?