http - RESTful 集合和控制成员详细信息

Question

我已经遇到过几次这个问题，每次我都徒劳无功地寻找一个令人满意的答案。

我们有一个集合资源，它返回成员 URI 的表示，以及一个具有相同 URI(和自定义关系类型)的 Link header 字段。我们经常发现我们需要集合中每个成员的特定数据。

• 在一种极端情况下，我们可以让集合只返回成员 URI；然后，客户端必须依次查询每个 URI，以确定每个成员所需的数据。

• 在另一个极端，我们返回我们可能想要的关于集合的所有详细信息。这些都不是完美的。第一个可能导致大量 API 调用，第二个可能返回大量可能不需要的信息。

在我们的案例中，在这两个极端中，我倾向于第二种，因为我们很少将其用于多个案例。但是，对于更通用的方法，我想知道是否有人有一个很好的方法来动态指定集合的​​每个成员应该包含哪些细节？我想查询字符串参数最合适，但我不想破坏资源的自描述性。

Answer 1

我更喜欢你的第一个选项..

At one extreme, we can have the collection return nothing but the member URIs; the client must then query each URI in turn to determine the required data from each member.

如果您想要减少通过线路进行的 HTTP 调用次数，例如从手机应用程序 (iOS/Android) 调用服务。您可以包含一个额外的标题以包含子资源:

X-Aggregate-Resources-Depth: 2

您的服务器端代码必须将资源聚合到所需的深度。