请求资源子集的 RESTful 方式

Question

假设我有一个名为 user_stats 的资源，其中包含用户拥有的帖子、评论、喜欢和关注者的数量。是否有一种 RESTful 方式只询问该统计数据的一部分(即，对于 user_stats/3，请告诉我该用户有多少帖子和评论，但不要告诉我该用户有多少粉丝。)

我问的原因是一些统计属性可能是计算密集型的(是的，我在查询时生成它们)。所以简单地不要求它可以减少工作量。

Answer 1

有一个很useful 38 page free ebook有了关于设计 Web API 的最佳实践，您可能会发现它很有帮助，至少我做到了。

对于你的情况，它是这样说的:

Add optional fields in a comma-delimited list

The Google approach works extremely well.

Here's how to get just the information we need from our dogs API using this approach:

/dogs?fields=name,color,location

It's simple to read; a developer can select just the information an app needs at a given time; it cuts down on bandwidth issues, which is important for mobile apps. The partial selection syntax can also be used to include associated resources cutting down on the number of requests needed to get the required information.

也许这就是你要找的？