web-services - REST API で特定のリソースのグループ化されたカウントを取得するための最適な URI テンプレートは何ですか?

Question

JSON で従業員のコレクションを返す URI を公開する REST API があります。URI の形式は次のとおりです。

http://webservice/employees

ここで、たとえば従業員が勤務しているオフィスごとにグループ化された従業員の数と、そのオフィスに関する詳細情報を返す URI を公開したいと考えています。例えば：

items: [{
           officeId: 1,
           officeName: "Big Office",
           switchboardTel: "123456789",
           numEmployees: 100
        },
        {
           officeId: 2,
           officeName: "Small Office",
           switchboardTel: "987654321",
           numEmployees: 30
        },
        ... // etc.
       ]

これに適した URI は何でしょうか? オフィスに関する情報を (従業員数と共に) 返す場合、おそらくこの情報は「オフィス」リソースを介して取得する必要があると考えています。

http://webservice/offices

または、次の URI の方が適していますか?

http://webservice/employees?groupBy=office

私の意見では、応答が従業員ではなくオフィスに関する情報を従業員数とともに返すため、これは少し間違っているように思えます。

次に、年齢別にグループ化された従業員の数を返す URI を公開したいとします...これは、次のような「従業員」リソースに属しますか?

http://webservice/employees?groupBy=age

...または、「ages」リソースを作成する方が適していますか?

http://webservice/ages

私の意見では、ここでは「groupBy=age」オプションが最適のように思えますが、そうすると URI 形式が少し一貫しなくなります。

基本的に、いくつかの基準でグループ化された従業員の数を取得し、グループ化に関する情報を応答に含めるために、一貫した URI 形式が必要です。

よろしくお願いします。

トム