应该在相同的API或单独的API中获取资源的数量?

时间:2017-12-20 19:12:55

标签: rest api http api-design

我们有汽车数据,即

MakeId | ModelId | VersionId | Price

单个品牌可以有多个型号,单个品牌可以有多个型号。就像宝马一样,X3是宝马的车型之一,而'320d M Sport'是X3的版本之一。我们已经创建了API来获取所有类似的汽车:

/api/cars/ => returns all the versions (hence all the cars).

/api/cars/?price=5-10 => returns versions with price range between 5 to 10 million.

/api/cars/?modelid=1 => returns all car/version which have 1 as their modelId.

上面的每个API调用都返回基于过滤器的版本,我们还需要两件事:

  1. 在结果中获取的汽车数量,即将在上述API查询中获取的版本数量。
  2. 在上述查询结果中获取的不同modelid的计数。
  3. 我们应该如何为此设计API,即如果使用返回版本列表的相同API调用返回上述2个计数,或者这些应该是单独的API调用?

0 个答案:

没有答案